You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@burr.apache.org by gi...@apache.org on 2026/08/29 09:46:05 UTC

(burr) branch asf-site updated: Deploy site from cdac52e2785024151f183537c74d37f8bd3a5fc3

This is an automated email from the ASF dual-hosted git repository.

github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/burr.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 4dda87ae Deploy site from cdac52e2785024151f183537c74d37f8bd3a5fc3
4dda87ae is described below

commit 4dda87aeb6f1eeae33001c4bee60c825ad4600b2
Author: GitHub Actions <ac...@github.com>
AuthorDate: Sat Aug 29 09:46:00 2026 +0000

    Deploy site from cdac52e2785024151f183537c74d37f8bd3a5fc3
---
 content/404.html                                   |   2 +-
 .../_buildManifest.js                              |   0
 .../_ssgManifest.js                                |   0
 content/concepts/human-in-the-loop/index.html      |   6 +
 content/docs/_sources/concepts/actions.rst.txt     |   2 +
 .../_sources/concepts/human-in-the-loop.rst.txt    | 280 ++++++++++++++++
 content/docs/_sources/concepts/index.rst.txt       |   1 +
 .../docs/_sources/concepts/state-machine.rst.txt   |   3 +-
 content/docs/asf/index.html                        |   1 +
 content/docs/concepts/actions/index.html           |  66 ++--
 .../docs/concepts/additional-visibility/index.html |  69 ++--
 content/docs/concepts/hooks/index.html             |  11 +-
 .../index.html                                     | 360 +++++++++++++--------
 content/docs/concepts/index.html                   |  12 +
 content/docs/concepts/overview/index.html          |   1 +
 content/docs/concepts/parallelism/index.html       | 155 ++++-----
 .../docs/concepts/planned-capabilities/index.html  |  19 +-
 content/docs/concepts/recursion/index.html         |  13 +-
 content/docs/concepts/s3-tracking-aws/index.html   |  11 +-
 content/docs/concepts/sdlc/index.html              |   1 +
 content/docs/concepts/serde/index.html             |  23 +-
 content/docs/concepts/state-machine/index.html     |  30 +-
 content/docs/concepts/state-persistence/index.html |  33 +-
 content/docs/concepts/state-typing/index.html      |  11 +-
 content/docs/concepts/state/index.html             |  13 +-
 content/docs/concepts/streaming-actions/index.html |  69 ++--
 content/docs/concepts/sync-vs-async/index.html     |   1 +
 content/docs/concepts/tracking/index.html          |  11 +-
 content/docs/concepts/transitions/index.html       |  37 +--
 content/docs/contributing/architecture/index.html  |   1 +
 content/docs/contributing/contributing/index.html  |   1 +
 content/docs/contributing/index.html               |   1 +
 content/docs/contributing/iterating/index.html     |   1 +
 content/docs/contributing/setup/index.html         |   3 +-
 content/docs/ecosystem/index.html                  |   1 +
 .../docs/examples/agents/agent-patterns/index.html |   1 +
 .../examples/agents/divide-and-conquer/index.html  |   1 +
 content/docs/examples/agents/index.html            |   1 +
 .../examples/chatbots/basic-chatbot/index.html     | 153 ++++-----
 .../examples/chatbots/gpt-like-chatbot/index.html  | 263 +++++++--------
 content/docs/examples/chatbots/index.html          |   1 +
 .../chatbots/rag-chatbot-hamilton/index.html       | 231 ++++++-------
 content/docs/examples/data-science/index.html      |   1 +
 .../examples/data-science/ml_training/index.html   |  79 ++---
 .../examples/data-science/simulation/index.html    |  73 ++---
 content/docs/examples/deployment/aws/index.html    |   1 +
 content/docs/examples/deployment/index.html        |   1 +
 .../examples/deployment/infrastructure/index.html  |   1 +
 .../docs/examples/deployment/monitoring/index.html |   1 +
 .../docs/examples/deployment/web-server/index.html |   1 +
 .../examples/guardrails/creating_tests/index.html  |   7 +-
 content/docs/examples/guardrails/index.html        |   1 +
 content/docs/examples/index.html                   |   1 +
 .../simple/choose-your-own-adventure/index.html    | 133 ++++----
 content/docs/examples/simple/counter/index.html    |  29 +-
 content/docs/examples/simple/cowsay/index.html     |  39 +--
 content/docs/examples/simple/index.html            |   1 +
 content/docs/genindex/index.html                   |   1 +
 content/docs/getting_started/index.html            |   1 +
 content/docs/getting_started/install/index.html    |  47 +--
 .../docs/getting_started/simple-example/index.html |  61 ++--
 content/docs/getting_started/up-next/index.html    |   1 +
 content/docs/getting_started/why-burr/index.html   |   1 +
 content/docs/index.html                            |   1 +
 content/docs/main/index.html                       |   1 +
 content/docs/objects.inv                           | Bin 4803 -> 4844 bytes
 content/docs/py-modindex/index.html                |   1 +
 content/docs/reference/actions/index.html          |  19 +-
 content/docs/reference/application/index.html      |  83 ++---
 content/docs/reference/conditions/index.html       |  35 +-
 content/docs/reference/index.html                  |   1 +
 .../docs/reference/integrations/bedrock/index.html |  23 +-
 .../reference/integrations/hamilton/index.html     |   1 +
 .../reference/integrations/haystack/index.html     |   1 +
 content/docs/reference/integrations/index.html     |   1 +
 .../reference/integrations/langchain/index.html    |   1 +
 .../reference/integrations/langfuse/index.html     |  13 +-
 .../integrations/opentelemetry/index.html          |   3 +-
 .../reference/integrations/pydantic/index.html     |   1 +
 content/docs/reference/integrations/ray/index.html |   1 +
 .../reference/integrations/streamlit/index.html    |   1 +
 .../reference/integrations/traceloop/index.html    |   1 +
 content/docs/reference/lifecycle/index.html        |   1 +
 content/docs/reference/parallelism/index.html      |  87 ++---
 content/docs/reference/persister/index.html        |  31 +-
 content/docs/reference/serde/index.html            |   5 +-
 content/docs/reference/state/index.html            |  19 +-
 content/docs/reference/tracking/index.html         |   1 +
 content/docs/reference/typing/index.html           |   1 +
 content/docs/reference/visibility/index.html       |  11 +-
 content/docs/search/index.html                     |   1 +
 content/docs/searchindex.js                        |   2 +-
 content/docs/sitemap.xml                           |   2 +-
 content/docs/ui/deployment/index.html              |   3 +-
 content/docs/ui/getting-started/index.html         |  11 +-
 content/docs/ui/index.html                         |   1 +
 content/docs/ui/notebook/index.html                |   3 +-
 content/downloads.html                             |   4 +-
 content/downloads.txt                              |   2 +-
 content/index.html                                 |   4 +-
 content/index.txt                                  |   2 +-
 101 files changed, 1615 insertions(+), 1145 deletions(-)

diff --git a/content/404.html b/content/404.html
index f276c132..ee88c71d 100644
--- a/content/404.html
+++ b/content/404.html
@@ -1 +1 @@
-<!DOCTYPE html><!--_3dbZnoqfuFnQ7Y83vzdP--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="stylesheet" href="/_next/static/css/675dbd99ea0a9d95.css" data-precedence="next"/><link rel="preload" as="script" fetchPriority="low" href="/_next/static/chunks/webpack-7 [...]
\ No newline at end of file
+<!DOCTYPE html><!--GifovmhjX2KCAlIUlQVfd--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="stylesheet" href="/_next/static/css/675dbd99ea0a9d95.css" data-precedence="next"/><link rel="preload" as="script" fetchPriority="low" href="/_next/static/chunks/webpack-7 [...]
\ No newline at end of file
diff --git a/content/_next/static/-3dbZnoqfuFnQ7Y83vzdP/_buildManifest.js b/content/_next/static/GifovmhjX2KCAlIUlQVfd/_buildManifest.js
similarity index 100%
rename from content/_next/static/-3dbZnoqfuFnQ7Y83vzdP/_buildManifest.js
rename to content/_next/static/GifovmhjX2KCAlIUlQVfd/_buildManifest.js
diff --git a/content/_next/static/-3dbZnoqfuFnQ7Y83vzdP/_ssgManifest.js b/content/_next/static/GifovmhjX2KCAlIUlQVfd/_ssgManifest.js
similarity index 100%
rename from content/_next/static/-3dbZnoqfuFnQ7Y83vzdP/_ssgManifest.js
rename to content/_next/static/GifovmhjX2KCAlIUlQVfd/_ssgManifest.js
diff --git a/content/concepts/human-in-the-loop/index.html b/content/concepts/human-in-the-loop/index.html
new file mode 100644
index 00000000..616d357e
--- /dev/null
+++ b/content/concepts/human-in-the-loop/index.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><html><head>
+<meta charset="utf-8">
+<meta http-equiv="refresh" content="0; url=https://burr.apache.org/docs/concepts/human-in-the-loop/">
+<link rel="canonical" href="https://burr.apache.org/docs/concepts/human-in-the-loop/">
+<script>window.location.replace("https://burr.apache.org/docs/concepts/human-in-the-loop/")</script>
+</head><body>Redirecting to <a href="https://burr.apache.org/docs/concepts/human-in-the-loop/">https://burr.apache.org/docs/concepts/human-in-the-loop/</a>...</body></html>
diff --git a/content/docs/_sources/concepts/actions.rst.txt b/content/docs/_sources/concepts/actions.rst.txt
index c8809411..1ef719dc 100644
--- a/content/docs/_sources/concepts/actions.rst.txt
+++ b/content/docs/_sources/concepts/actions.rst.txt
@@ -322,6 +322,8 @@ We need to pass in `client` and `prompt` somehow. Here are the ways to do that:
 For instance, say you have a chatbot. The first step will likely declare the ``input`` parameter ``prompt`` --
 it will take that, process it, and put the result in state. The subsequent steps will read the result of that from state.
 
+To stop before an action that needs a person, then resume with ``inputs``, see :ref:`human in the loop <human-in-the-loop>`.
+
 ---------------
 Tagging Actions
 ---------------
diff --git a/content/docs/_sources/concepts/human-in-the-loop.rst.txt b/content/docs/_sources/concepts/human-in-the-loop.rst.txt
new file mode 100644
index 00000000..2d44e328
--- /dev/null
+++ b/content/docs/_sources/concepts/human-in-the-loop.rst.txt
@@ -0,0 +1,280 @@
+..
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+
+
+=================
+Human in the Loop
+=================
+
+.. _human-in-the-loop:
+
+.. note::
+
+    The person stays outside the graph. An action that needs them declares extra function
+    parameters (runtime :ref:`inputs <inputref>`). You stop the application with
+    ``run(halt_before=["human_step"])``, collect those values yourself, then call ``run``
+    again and pass them as ``inputs``.
+
+An agent can run on its own until it needs a person -- a prompt, a clarification, an
+approval. Burr does not prompt the user. It stops, hands control back to your code, and
+waits for the next ``run``.
+
+The action that needs a person looks like any other action. The extra parameters are not
+read from state; they come from the caller:
+
+.. code-block:: python
+
+    @action(reads=["draft"], writes=["approved"])
+    def human_step(state: State, approved: bool) -> State:
+        return state.update(approved=approved)
+
+``approved`` is a runtime input. Bind long-lived objects (an API client, a DB handle) with
+``.bind(...)``. Pass per-turn values with ``inputs={...}`` on ``run`` / ``step`` /
+``iterate``. See :ref:`inputs <inputref>`.
+
+----------------------------
+``halt_before`` and ``run``
+----------------------------
+
+``Application.run`` walks the graph until a halt condition hits, then returns
+``(action, result, state)``.
+
+- ``halt_before=["human_step"]`` stops when ``human_step`` is the *next* action. That
+  action has **not** run. ``result`` is ``None``. The returned ``action`` is
+  ``human_step``.
+- ``halt_after=["final_result"]`` stops after that action has run. ``result`` is that
+  action's result dict. The returned ``action`` is ``final_result``.
+
+If both could apply, ``halt_before`` wins. ``run`` always executes at least one action
+before it checks halt conditions, then ``inputs`` apply only to that first action. Later
+actions in the same ``run`` that also need ``inputs`` are undefined -- halt before those
+instead, and pass their values on the next ``run``.
+
+You can pass action names or tags (``"@tag:needs_human"``). The same halt arguments work
+on ``iterate`` / ``arun`` / ``aiterate``. Details are in :ref:`Applications <applications>`.
+
+--------------------------------
+A graph with one handoff
+--------------------------------
+
+This is the shape ``run(halt_before=["human_step"])`` is for. No LLM required:
+
+.. code-block:: python
+
+    from burr.core import ApplicationBuilder, State, action
+
+    @action(reads=[], writes=["task"])
+    def start(state: State, task: str) -> State:
+        return state.update(task=task)
+
+    @action(reads=["task"], writes=["draft"])
+    def agent_work(state: State) -> State:
+        return state.update(draft=f"draft for: {state['task']}")
+
+    @action(reads=["draft"], writes=["approved"])
+    def human_step(state: State, approved: bool) -> State:
+        return state.update(approved=approved)
+
+    @action(reads=["draft", "approved"], writes=["result"])
+    def finish(state: State) -> State:
+        return state.update(result=state["draft"] if state["approved"] else None)
+
+    app = (
+        ApplicationBuilder()
+        .with_actions(start, agent_work, human_step, finish)
+        .with_transitions(
+            ("start", "agent_work"),
+            ("agent_work", "human_step"),
+            ("human_step", "finish"),
+        )
+        .with_entrypoint("start")
+        .build()
+    )
+
+    action, result, state = app.run(
+        halt_before=["human_step"],
+        inputs={"task": "write a thank-you note"},
+    )
+    # action.name == "human_step", result is None
+    # start and agent_work have run; human_step has not
+    # state["draft"] is ready for the person to look at
+
+    action, result, state = app.run(
+        halt_after=["finish"],
+        inputs={"approved": True},
+    )
+    # first action of this run is human_step, so it receives approved=True
+    # then finish runs; action.name == "finish"
+
+The first ``run`` stops *before* ``human_step``. The second ``run`` starts *at*
+``human_step``, so ``inputs={"approved": True}`` is what that action receives.
+
+``app.get_next_action()`` tells you which action is queued if you want to inspect
+without running.
+
+---------------------------
+A chat loop
+---------------------------
+
+When the human action is both the entrypoint and the place you return to, collect the
+prompt in the outer loop and halt before that same action. The first step of each
+``run`` is the human action (it gets ``inputs``); the application then continues until
+that action is next again:
+
+.. code-block:: python
+
+    from burr.core import ApplicationBuilder, State, action
+
+    @action(reads=[], writes=["prompt", "chat_history"])
+    def human_input(state: State, prompt: str) -> State:
+        return state.update(prompt=prompt).append(
+            chat_history={"role": "user", "content": prompt}
+        )
+
+    @action(reads=["chat_history"], writes=["response", "chat_history"])
+    def ai_response(state: State) -> State:
+        reply = f"you said: {state['chat_history'][-1]['content']}"
+        return state.update(response=reply).append(
+            chat_history={"role": "assistant", "content": reply}
+        )
+
+    app = (
+        ApplicationBuilder()
+        .with_actions(human_input, ai_response)
+        .with_transitions(
+            ("human_input", "ai_response"),
+            ("ai_response", "human_input"),
+        )
+        .with_state(chat_history=[])
+        .with_entrypoint("human_input")
+        .build()
+    )
+
+    while True:
+        prompt = input("you: ")
+        if prompt == "exit":
+            break
+        action, result, state = app.run(
+            halt_before=["human_input"],
+            inputs={"prompt": prompt},
+        )
+        print("ai:", state["response"])
+
+In this two-node cycle, ``halt_after=["ai_response"]`` stops at the same place -- after
+the model has spoken, before the next human turn. ``halt_before=["human_input"]`` is the
+same stop, with ``result is None`` and ``action.name == "human_input"``. The getting
+started chatbot uses ``halt_after=["ai_response"]`` for a single turn; a running CLI
+example of the ``halt_before`` loop is
+`examples/conversational-rag/graph_db_example/application.py <https://github.com/apache/burr/blob/main/examples/conversational-rag/graph_db_example/application.py>`_
+(``human_converse`` / ``user_question``).
+
+--------------------------------------
+Several handoff points
+--------------------------------------
+
+Some applications need a person more than once, at different actions. Halt before every
+action that needs ``inputs``, halt after the terminal action, and use ``action.name`` to
+decide what to collect next.
+
+This is the email assistant
+(`examples/email-assistant <https://github.com/apache/burr/tree/main/examples/email-assistant>`_).
+``process_input`` takes ``email_to_respond`` and ``response_instructions``.
+``clarify_instructions`` takes ``clarification_inputs`` (a ``list[str]``).
+``process_feedback`` takes ``feedback``. The graph goes
+``process_input → determine_clarifications → (clarify_instructions?) → formulate_draft → process_feedback → … → final_result``.
+
+.. code-block:: python
+
+    inputs = {
+        "email_to_respond": incoming,
+        "response_instructions": instructions,
+    }
+    while True:
+        action, result, state = app.run(
+            halt_before=["clarify_instructions", "process_feedback"],
+            halt_after=["final_result"],
+            inputs=inputs,
+        )
+        if action.name == "clarify_instructions":
+            # clarify_instructions has not run; questions are already in state
+            answers = [input(q + " ") for q in state["clarification_questions"]]
+            inputs = {"clarification_inputs": answers}
+        elif action.name == "process_feedback":
+            comment = input("feedback (empty accepts the draft): ")
+            inputs = {"feedback": comment}
+        elif action.name == "final_result":
+            break
+
+Include ``halt_after=["final_result"]``. Without it, an empty ``feedback`` sends the
+graph through ``final_result`` and then leaves it with no next action, which ``run``
+treats as undefined (it logs a warning).
+
+The FastAPI wiring for the same halt list is
+`examples/email-assistant/server.py <https://github.com/apache/burr/blob/main/examples/email-assistant/server.py>`_
+(``_run_through``) and the walkthrough in
+`examples/web-server <https://github.com/apache/burr/tree/main/examples/web-server>`_.
+
+-----------------------------
+Web servers and persistence
+-----------------------------
+
+The loop does not have to live in one process. On a web server each request loads the
+application, calls ``run`` once, and returns. The next request supplies the next
+``inputs``.
+
+``examples/email-assistant`` does that with ``initialize_from(..., resume_at_next_action=True)``
+and a persister / tracker keyed by ``app_id``. The person can come back seconds or days
+later. See :ref:`State Persistence <state-persistence>`.
+
+``app.get_next_action()`` is useful here: the handler can tell the client which form to
+show without advancing the graph.
+
+-----------------
+Command-line only
+-----------------
+
+If the application only ever runs in a terminal, you can call ``input(...)`` inside an
+action and skip the outer loop. That does not work for a web server, a persisted app, or
+any caller that is not sitting on stdin. Prefer ``halt_before`` + ``inputs`` unless you
+are writing a one-off CLI.
+
+---------------------------
+Nested applications
+---------------------------
+
+Halting *inside* a sub-application and surfacing that to the parent is more involved.
+The wrapping action runs the child with ``halt_before``, then either:
+
+- sets a flag such as ``need_input=True`` and returns, with a parent transition back to
+  itself, or
+- copies the child's finished state up and continues.
+
+The parent still collects the person's values and passes them as ``inputs`` into the
+wrapping action on the next ``run``. The child is not visible to the parent's
+``halt_before`` list.
+
+------------
+See also
+------------
+
+- :ref:`Applications <applications>` -- ``run``, ``iterate``, ``halt_before`` / ``halt_after``
+- :ref:`inputs <inputref>` -- runtime inputs vs ``.bind(...)``
+- :ref:`State Persistence <state-persistence>` -- pause and resume across requests
+- `Email assistant <https://github.com/apache/burr/tree/main/examples/email-assistant>`_
+- `Graph-DB RAG CLI loop <https://github.com/apache/burr/blob/main/examples/conversational-rag/graph_db_example/application.py>`_
+- `Burr in a web server <https://github.com/apache/burr/tree/main/examples/web-server>`_
diff --git a/content/docs/_sources/concepts/index.rst.txt b/content/docs/_sources/concepts/index.rst.txt
index 99dd9dbf..8762d851 100644
--- a/content/docs/_sources/concepts/index.rst.txt
+++ b/content/docs/_sources/concepts/index.rst.txt
@@ -33,6 +33,7 @@ Overview of the concepts -- read these to get a mental model for how Burr works.
     actions
     state
     state-machine
+    human-in-the-loop
     transitions
     tracking
     s3-tracking-aws
diff --git a/content/docs/_sources/concepts/state-machine.rst.txt b/content/docs/_sources/concepts/state-machine.rst.txt
index 2fea48ae..862a16fa 100644
--- a/content/docs/_sources/concepts/state-machine.rst.txt
+++ b/content/docs/_sources/concepts/state-machine.rst.txt
@@ -75,7 +75,8 @@ If you're in an async context, you can run `astep` instead:
 
 Step can also take in ``inputs`` as a dictionary, which will be passed to the action's run function as keyword arguments.
 This is specifically meant for a "human in the loop" scenario, where the action needs to ask for input from a user. In this case,
-the control flow is meant to be interrupted to allow for the user to provide input. See :ref:`inputs <inputref>` for more information.
+the control flow is meant to be interrupted to allow for the user to provide input. See :ref:`inputs <inputref>` and
+:ref:`human in the loop <human-in-the-loop>` for more information.
 
 .. code-block:: python
 
diff --git a/content/docs/asf/index.html b/content/docs/asf/index.html
index f6b58819..55f66f55 100644
--- a/content/docs/asf/index.html
+++ b/content/docs/asf/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/concepts/actions/index.html b/content/docs/concepts/actions/index.html
index 53c3796b..edf33ebb 100644
--- a/content/docs/concepts/actions/index.html
+++ b/content/docs/concepts/actions/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -457,9 +458,9 @@ framework to optimize the execution of the workflow. We call (1) a <code class="
 can return either just the updated state or a tuple of the result and the state. For example:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span><span class="p">,</span> <span class="n">State</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">custom_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">custom_action</span><span class="o">=</span><span class="n">custom_action</span>
@@ -471,7 +472,7 @@ You also have the option of returning the intermediate results, which is useful
 above is equivalent to returning an empty dictionary instead of the results.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span><span class="p">,</span> <span class="n">State</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">custom_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="k">return</span> <span class="n">results</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">var_from_state</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span>
 
@@ -481,9 +482,9 @@ above is equivalent to returning an empty dictionary instead of the results.</p>
 </pre></div>
 </div>
 <p>Function-based actions can take in parameters which are akin to passing in constructor parameters. This is done through the <a class="reference internal" href="../../reference/actions/#burr.core.action.bind" title="burr.core.action.bind"><code class="xref py py-meth docutils literal notranslate"><span class="pre">bind</span></code></a> method:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">custom_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">increment_by</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">custom_action</span><span class="o">=</span><span class="n">custom_action</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">increment_by</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
@@ -492,9 +493,9 @@ above is equivalent to returning an empty dictionary instead of the results.</p>
 </div>
 <p>This is the same as <code class="docutils literal notranslate"><span class="pre">functools.partial</span></code>, but it is more explicit and easier to read. If an action has parameters that are not
 bound, they will be referred to as inputs. For example:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">custom_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">increment_by</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">custom_action</span><span class="o">=</span><span class="n">custom_action</span>
@@ -502,10 +503,10 @@ bound, they will be referred to as inputs. For example:</p>
 </pre></div>
 </div>
 <p>Will require the inputs to be passed in at runtime. See below for how to do that. You can use default values to set optional inputs as well:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">custom_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">increment_by</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"var_to_update"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">var_to_update</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">)</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">custom_action</span><span class="o">=</span><span class="n">custom_action</span>
@@ -535,14 +536,14 @@ injected into your Burr Actions. This is done by adding <code class="docutils li
 <span class="k">class</span><span class="w"> </span><span class="nc">CustomAction</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"var_to_update"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
@@ -562,21 +563,21 @@ injected into your Burr Actions. This is done by adding <code class="docutils li
 <span class="k">class</span><span class="w"> </span><span class="nc">CustomAction</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">increment_by</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;var_from_state&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"var_to_update"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"var_from_state"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;var_to_update&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"var_to_update"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">inputs</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;increment_by&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"increment_by"</span><span class="p">]</span>
 </pre></div>
 </div>
 <p>See below for how to pass in inputs at runtime. If you want to use optional inputs with the class-based API, <code class="docutils literal notranslate"><span class="pre">inputs</span></code> will return a tuple
@@ -586,7 +587,7 @@ of (required, optional) inputs. For example:</p>
 <span class="k">class</span><span class="w"> </span><span class="nc">CustomAction</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="o">...</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">inputs</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;increment_by&quot;</span><span class="p">],</span> <span class="p">[</span><span class="s2">&quot;optional_input&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"increment_by"</span><span class="p">],</span> <span class="p">[</span><span class="s2">"optional_input"</span><span class="p">]</span>
 </pre></div>
 </div>
 <p>Note your code will have to handle the case where <code class="docutils literal notranslate"><span class="pre">optional_input</span></code> is not passed in (e.g. by setting the appropriate kwargs to the <cite>run(…)</cite> method.</p>
@@ -597,7 +598,7 @@ be injected into the action. This is done by adding <cite>__context</cite> to th
 <span class="k">class</span><span class="w"> </span><span class="nc">Counter</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"counter"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
             <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span>
@@ -606,11 +607,11 @@ be injected into the action. This is done by adding <cite>__context</cite> to th
             <span class="n">__context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
         <span class="c1"># can access the app_id from the __context</span>
         <span class="nb">print</span><span class="p">(</span><span class="n">__context</span><span class="o">.</span><span class="n">app_id</span><span class="p">,</span> <span class="n">__context</span><span class="o">.</span><span class="n">partition_key</span><span class="p">,</span> <span class="n">__context</span><span class="o">.</span><span class="n">sequence_id</span><span class="p">)</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;counter&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"counter"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">]</span> <span class="o">+</span> <span class="n">increment_by</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"counter"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
@@ -618,7 +619,7 @@ be injected into the action. This is done by adding <cite>__context</cite> to th
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">inputs</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
         <span class="c1"># add __context here</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;increment_by&quot;</span><span class="p">,</span> <span class="s2">&quot;__context&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"increment_by"</span><span class="p">,</span> <span class="s2">"__context"</span><span class="p">]</span>
 </pre></div>
 </div>
 <p>Refer to <a class="reference internal" href="../../reference/actions/#burr.core.action.Action" title="burr.core.action.Action"><code class="xref py py-class docutils literal notranslate"><span class="pre">Action</span></code></a> for more documentation.</p>
@@ -631,10 +632,10 @@ be injected into the action. This is done by adding <cite>__context</cite> to th
 <li><p>Provide inputs that are required as part of the application to function, e.g. human input, configuration, etc.</p></li>
 </ol>
 <p>For example using the function based API, consider the following action:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"..."</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"..."</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">client</span><span class="p">:</span> <span class="n">Client</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span cl [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;client &amp; `prompt` here are something we need to pass in.&quot;&quot;&quot;</span>
-    <span class="n">context</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">get_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">])</span>
+<span class="w">    </span><span class="sd">"""client &amp; `prompt` here are something we need to pass in."""</span>
+    <span class="n">context</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">get_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"..."</span><span class="p">])</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">llm_call</span><span class="p">(</span><span class="n">prompt</span><span class="p">,</span> <span class="n">context</span><span class="p">)</span> <span class="c1"># some LLM call...</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 </pre></div>
@@ -643,31 +644,32 @@ be injected into the action. This is done by adding <cite>__context</cite> to th
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># (1) bind values</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
-      <span class="c1"># we can &quot;bind&quot; values to an action</span>
+      <span class="c1"># we can "bind" values to an action</span>
       <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">my_action</span><span class="o">=</span><span class="n">my_action</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">))</span>
     <span class="o">...</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 
 <span class="c1"># (2) pass them in at runtime</span>
-<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span> <span class="c1"># or app.step, app.iterate, app.astep, etc.\n&quot;</span>
-    <span class="n">halt_</span><span class="o">...</span><span class="p">,</span> <span class="c1"># your halt logic\n&quot;</span>
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="s2">&quot;this will be passed into `prompt`&quot;</span><span class="p">}</span> <span class="c1"># &lt;-- we pass in values here</span>
+<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span> <span class="c1"># or app.step, app.iterate, app.astep, etc.\n"</span>
+    <span class="n">halt_</span><span class="o">...</span><span class="p">,</span> <span class="c1"># your halt logic\n"</span>
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="s2">"this will be passed into `prompt`"</span><span class="p">}</span> <span class="c1"># &lt;-- we pass in values here</span>
 <span class="p">)</span>
 </pre></div>
 </div>
 <p>For instance, say you have a chatbot. The first step will likely declare the <code class="docutils literal notranslate"><span class="pre">input</span></code> parameter <code class="docutils literal notranslate"><span class="pre">prompt</span></code> –
 it will take that, process it, and put the result in state. The subsequent steps will read the result of that from state.</p>
+<p>To stop before an action that needs a person, then resume with <code class="docutils literal notranslate"><span class="pre">inputs</span></code>, see <a class="reference internal" href="../human-in-the-loop/#id1"><span class="std std-ref">human in the loop</span></a>.</p>
 </section>
 <section id="tagging-actions">
 <h2>Tagging Actions<a class="headerlink" href="#tagging-actions" title="Link to this heading">¶</a></h2>
 <p>You can tag actions with a list of strings – this effectively functions as a “alias” for the action,
 so that a single alias can refer to multiple actions. This allows you to refer to a set of actions
 that have similar capabilities as one, using a variety of <a class="reference internal" href="../state-machine/#id1"><span class="std std-ref">application</span></a> APIs.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">],</span> <span class="n">tags</span><span class="o">=</span><span class="p">[</s [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"..."</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"..."</span><span class="p">],</span> <span class="n">tags</span><span class="o">=</span><span class="p">[</span><span class="s2" [...]
 <span class="k">def</span><span class="w"> </span><span class="nf">text_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">client</span><span class="p">:</span> <span class="n">Client</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><spa [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;client &amp; `prompt` here are something we need to pass in.&quot;&quot;&quot;</span>
-    <span class="n">context</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">get_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;...&quot;</span><span class="p">])</span>
+<span class="w">    </span><span class="sd">"""client &amp; `prompt` here are something we need to pass in."""</span>
+    <span class="n">context</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">get_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"..."</span><span class="p">])</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">llm_call</span><span class="p">(</span><span class="n">prompt</span><span class="p">,</span> <span class="n">context</span><span class="p">)</span> <span class="c1"># some LLM call...</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 </pre></div>
diff --git a/content/docs/concepts/additional-visibility/index.html b/content/docs/concepts/additional-visibility/index.html
index bdfbf954..b146959f 100644
--- a/content/docs/concepts/additional-visibility/index.html
+++ b/content/docs/concepts/additional-visibility/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -445,7 +446,7 @@ pip<span class="w"> </span>install<span class="w"> </span>opentelemetry-instrume
 <span class="n">OpenAIInstrumentor</span><span class="p">()</span><span class="o">.</span><span class="n">instrument</span><span class="p">()</span>  <span class="c1"># this instruments openai clients</span>
 
 <span class="c1"># create the local tracker</span>
-<span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">&quot;your-project&quot;</span><span class="p">)</span>
+<span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">"your-project"</span><span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">base_graph</span><span class="p">)</span>
@@ -468,16 +469,16 @@ an object that instantiates spans and tracks state.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.visibility</span><span class="w"> </span><span class="kn">import</span> <span class="n">TracerFactory</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">):</span>
-        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
-        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;check_prompt_safety&#39;</span><span class="p">):</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'create_prompt'</span><span class="p">):</span>
+        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
+        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'check_prompt_safety'</span><span class="p">):</span>
             <span class="k">if</span> <span class="n">_is_unsafe</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">):</span>
                 <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_fix</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">)</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;call_llm&#39;</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">]):</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'call_llm'</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">'create_prompt'</span><span class="p">]):</span>
         <span class="n">response</span> <span class="o">=</span> <span class="n">_query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
 </pre></div>
 </div>
 <p>This would create the following traces:</p>
@@ -510,22 +511,22 @@ or the root tracer factory. Note: the <cite>trace()</cite> decorator explained b
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.visibility</span><span class="w"> </span><span class="kn">import</span> <span class="n">TracerFactory</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">__tracer</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">prompt_length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]),</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot; [...]
+    <span class="n">__tracer</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">prompt_length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]),</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class=" [...]
 
     <span class="c1"># note: see `@trace()` below as an alternative to this approach.</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">t</span><span class="p">:</span>
-        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'create_prompt'</span><span class="p">)</span> <span class="k">as</span> <span class="n">t</span><span class="p">:</span>
+        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
         <span class="n">t</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">modified_prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
-        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;check_prompt_safety&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">t</span><span class="p">:</span>
+        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'check_prompt_safety'</span><span class="p">)</span> <span class="k">as</span> <span class="n">t</span><span class="p">:</span>
             <span class="k">if</span> <span class="n">is_unsafe</span><span class="o">:=</span><span class="n">_is_unsafe</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">):</span>
                 <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_fix</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">)</span>
             <span class="n">t</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">fixed_prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">,</span> <span class="n">is_unsafe</span><span class="o">=</span><span class="n">is_unsafe</span><span class="p">)</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;call_llm&#39;</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">]):</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'call_llm'</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">'create_prompt'</span><span class="p">]):</span>
         <span class="n">response</span> <span class="o">=</span> <span class="n">_query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
         <span class="n">t</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">,</span> <span class="n">tokens</span><span class="o">=</span><span class="n">response</span><span class="o">.</span><span class="n">tokens</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">})</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">})</span>
 </pre></div>
 </div>
 <p>The above will log quite a few attributes, prompt length, response tokens, etc… The observation can be any serializable object.</p>
@@ -553,29 +554,29 @@ for the function (within the approprite context), and log as attributes the para
 <span class="k">def</span><span class="w"> </span><span class="nf">_query</span><span class="p">(</span><span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Response</span><span class="p">:</span>
     <span class="k">return</span> <span class="o">...</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+    <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
     <span class="k">if</span> <span class="n">_is_unsafe</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">):</span>
           <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_fix</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">)</span>
     <span class="n">response</span> <span class="o">=</span> <span class="n">_query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
 </pre></div>
 </div>
 <p>This will create spans for the <code class="docutils literal notranslate"><span class="pre">_modify_prompt</span></code>, <code class="docutils literal notranslate"><span class="pre">_fix</span></code>, and <code class="docutils literal notranslate"><span class="pre">_query</span></code> functions, and log the parameters and return values. You can opt out of logging paramers or return values and adding a filter to the decorator to exclude certain parameters.
 To contrast what you can instrument manually, the <code class="docutils literal notranslate"><span class="pre">&#64;trace</span></code> decorator allows you to get more visibility and replace manual code such as the following (though you can happily combine the two approaches):</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.visibility</span><span class="w"> </span><span class="kn">import</span> <span class="n">TracerFactory</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span>
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">):</span>
-        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
-        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;check_prompt_safety&#39;</span><span class="p">):</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'create_prompt'</span><span class="p">):</span>
+        <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
+        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'check_prompt_safety'</span><span class="p">):</span>
             <span class="k">if</span> <span class="n">_is_unsafe</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">):</span>
                 <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_fix</span><span class="p">(</span><span class="n">modified_prompt</span><span class="p">)</span>
-    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;call_llm&#39;</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">]):</span>
+    <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'call_llm'</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">'create_prompt'</span><span class="p">]):</span>
         <span class="n">response</span> <span class="o">=</span> <span class="n">_query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">response</span><span class="p">})</span>
 </pre></div>
 </div>
 <p>This will create spans for the <code class="docutils literal notranslate"><span class="pre">_modify_prompt</span></code>, <code class="docutils literal notranslate"><span class="pre">_fix</span></code>, and <code class="docutils literal notranslate"><span class="pre">_query</span></code> functions, and log the parameters and return values.
@@ -599,28 +600,28 @@ example:</p>
 <span class="kn">from</span><span class="w"> </span><span class="nn">opentelemetry</span><span class="w"> </span><span class="kn">import</span> <span class="n">trace</span>
 <span class="n">otel_tracer</span> <span class="o">=</span> <span class="n">trace</span><span class="o">.</span><span class="n">get_tracer</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="k">with</span> <span class="n">__tracer</span><span class="p">:</span>
         <span class="c1"># Burr logging</span>
-        <span class="n">__tracer</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">prompt_length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]),</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&q [...]
+        <span class="n">__tracer</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">prompt_length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]),</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span cla [...]
         <span class="c1"># OpenTelemetry Tracer</span>
-        <span class="k">with</span> <span class="n">otel_tracer</span><span class="o">.</span><span class="n">start_as_current_span</span><span class="p">(</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">span</span><span class="p">:</span>
-            <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+        <span class="k">with</span> <span class="n">otel_tracer</span><span class="o">.</span><span class="n">start_as_current_span</span><span class="p">(</span><span class="s1">'create_prompt'</span><span class="p">)</span> <span class="k">as</span> <span class="n">span</span><span class="p">:</span>
+            <span class="n">modified_prompt</span> <span class="o">=</span> <span class="n">_modify_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
             <span class="n">span</span><span class="o">.</span><span class="n">set_attributes</span><span class="p">(</span><span class="nb">dict</span><span class="p">(</span><span class="n">modified_prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">))</span>
         <span class="c1"># Back to Burr tracer</span>
-        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">&#39;call_llm&#39;</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;create_prompt&#39;</span><span class="p">]):</span>
+        <span class="k">with</span> <span class="n">__tracer</span><span class="p">(</span><span class="s1">'call_llm'</span><span class="p">,</span> <span class="n">dependencies</span><span class="o">=</span><span class="p">[</span><span class="s1">'create_prompt'</span><span class="p">]):</span>
             <span class="n">response</span> <span class="o">=</span> <span class="n">_query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">modified_prompt</span><span class="p">)</span>
             <span class="n">t</span><span class="o">.</span><span class="n">log_attributes</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">,</span> <span class="n">tokens</span><span class="o">=</span><span class="n">response</span><span class="o">.</span><span class="n">tokens</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">})</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">response</span><span class="o">.</span><span class="n">message</span><span class="p">})</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">my_action</span><span class="p">,</span> <span class="o">...</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="s2">&quot;local&quot;</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">&quot;my_project&quot;</span><span class="p">,</span> <span class="n">use_otel_tracing</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;my_action&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="s2">"local"</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">"my_project"</span><span class="p">,</span> <span class="n">use_otel_tracing</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"my_action"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -648,7 +649,7 @@ it as you see fit).</p>
     <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">OpenTelemetryBridge</span><span class="p">(</span><span class="n">tracer</span><span class="o">=</span><span class="n">otel_tracer</span><span class="p">))</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;my_action&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"my_action"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -679,7 +680,7 @@ it as you see fit).</p>
 <p>The Burr integration for OpenTelemetry includes the convenience function <code class="docutils literal notranslate"><span class="pre">init_instruments()</span></code>. You can provide it the names of modules to instrument as strings and it will try to instrument them. This feature has good IDE autocompletion support. Another benefit is the ability to instrument multiple libraries at once.</p>
 <p>The following instruments the module <code class="docutils literal notranslate"><span class="pre">openai</span></code> (equivalent to the previous snippet) along with <code class="docutils literal notranslate"><span class="pre">lancedb</span></code> and <code class="docutils literal notranslate"><span class="pre">fastapi</span></code>.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.integrations.opentelemetry</span><span class="w"> </span><span class="kn">import</span> <span class="n">init_instruments</span>
-<span class="n">init_instruments</span><span class="p">(</span><span class="s2">&quot;openai&quot;</span><span class="p">,</span> <span class="s2">&quot;lancedb&quot;</span><span class="p">,</span> <span class="s2">&quot;fastapi&quot;</span><span class="p">)</span>
+<span class="n">init_instruments</span><span class="p">(</span><span class="s2">"openai"</span><span class="p">,</span> <span class="s2">"lancedb"</span><span class="p">,</span> <span class="s2">"fastapi"</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>Specifying the keyword argument <code class="docutils literal notranslate"><span class="pre">init_all=True</span></code> will try to instrument currently imported libraries with the instrumentation packages installed.</p>
@@ -687,7 +688,7 @@ it as you see fit).</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span><span class="w"> </span><span class="nn">logging</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.integrations.opentelemetry</span><span class="w"> </span><span class="kn">import</span> <span class="n">init_instruments</span>
 
-<span class="n">logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="s2">&quot;burr.integrations.opentelemetry&quot;</span><span class="p">)</span>
+<span class="n">logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="s2">"burr.integrations.opentelemetry"</span><span class="p">)</span>
 <span class="n">logger</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">StreamHandler</span><span class="p">())</span>
 <span class="n">logger</span><span class="o">.</span><span class="n">setLevel</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
 
diff --git a/content/docs/concepts/hooks/index.html b/content/docs/concepts/hooks/index.html
index 37e475e1..e53a9b91 100644
--- a/content/docs/concepts/hooks/index.html
+++ b/content/docs/concepts/hooks/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -435,20 +436,20 @@ These have synchronous and asynchronous versions, and your hook can subclass as
 a hook that prints out the nodes name during execution looks like this.
 We implement the pre/post run step hooks.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">class</span><span class="w"> </span><span class="nc">PrintLnHook</span><span class="p">(</span><span class="n">PostRunStepHook</span><span class="p">,</span> <span class="n">PreRunStepHook</span><span class="p">):</span>
-    <span class="k">def</span><span class="w"> </span><span class="nf">pre_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">&quot;State&quot;</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">&quot;Action&quot;</span><span class="p">,</span> <span class="o">**</span><span class [...]
-        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Starting action: </span><span class="si">{</span><span class="n">action</span><span class="o">.</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">pre_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">"State"</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">"Action"</span><span class="p">,</span> <span class="o">**</span><span class="n">future_kwargs</ [...]
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Starting action: </span><span class="si">{</span><span class="n">action</span><span class="o">.</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="o">*</span><span class="p">,</span>
-        <span class="n">state</span><span class="p">:</span> <span class="s2">&quot;State&quot;</span><span class="p">,</span>
-        <span class="n">action</span><span class="p">:</span> <span class="s2">&quot;Action&quot;</span><span class="p">,</span>
+        <span class="n">state</span><span class="p">:</span> <span class="s2">"State"</span><span class="p">,</span>
+        <span class="n">action</span><span class="p">:</span> <span class="s2">"Action"</span><span class="p">,</span>
         <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">],</span>
         <span class="n">sequence_id</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
         <span class="n">exception</span><span class="p">:</span> <span class="ne">Exception</span><span class="p">,</span>
         <span class="o">**</span><span class="n">future_kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
     <span class="p">):</span>
-        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Finishing action: </span><span class="si">{</span><span class="n">action</span><span class="o">.</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Finishing action: </span><span class="si">{</span><span class="n">action</span><span class="o">.</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>To include this in the application, you pass it into the <a class="reference internal" href="../../reference/application/#burr.core.application.ApplicationBuilder.with_hooks" title="burr.core.application.ApplicationBuilder.with_hooks"><code class="xref py py-meth docutils literal notranslate"><span class="pre">with_hooks</span></code></a> method.</p>
diff --git a/content/docs/concepts/state-machine/index.html b/content/docs/concepts/human-in-the-loop/index.html
similarity index 51%
copy from content/docs/concepts/state-machine/index.html
copy to content/docs/concepts/human-in-the-loop/index.html
index cabdf0ca..ce724e5d 100644
--- a/content/docs/concepts/state-machine/index.html
+++ b/content/docs/concepts/human-in-the-loop/index.html
@@ -22,12 +22,12 @@
   <head><meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Transitions" href="../transitions/"><link rel="prev" title="State" href="../state/">
-        <link rel="canonical" href="https://burr.apache.org/docs/concepts/state-machine/">
+<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Transitions" href="../transitions/"><link rel="prev" title="Applications" href="../state-machine/">
+        <link rel="canonical" href="https://burr.apache.org/docs/concepts/human-in-the-loop/">
         <link rel="prefetch" href="../../_static/burr_logo.svg" as="image">
 
     <link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated with Sphinx 8.2.3 and Furo 2025.12.19 -->
-        <title>Applications - Apache Burr</title>
+        <title>Human in the Loop - Apache Burr</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=7bdb33bb" />
     <link rel="stylesheet" type="text/css" href="../../_static/mystnb.11b39860a7a0cbfd473a3ad8a317855267ff0bd372690045ca344a6b62be495e.css" />
@@ -306,7 +306,8 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../sdlc/">SDLC with LLMs</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
-<li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -411,151 +412,233 @@ s=d.getElementsByTagName('script')[0];
           </label>
         </div>
         <article role="main" id="furo-main-content">
-          <section id="applications">
-<h1>Applications<a class="headerlink" href="#applications" title="Link to this heading">¶</a></h1>
+          <section id="human-in-the-loop">
+<h1>Human in the Loop<a class="headerlink" href="#human-in-the-loop" title="Link to this heading">¶</a></h1>
 <div class="admonition note" id="id1">
 <p class="admonition-title">Note</p>
-<p>Applications tie everything in Burr together. They specify which actions should be included,
-how they connect (including conditional edges), and how to run.</p>
+<p>The person stays outside the graph. An action that needs them declares extra function
+parameters (runtime <a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a>). You stop the application with
+<code class="docutils literal notranslate"><span class="pre">run(halt_before=[&quot;human_step&quot;])</span></code>, collect those values yourself, then call <code class="docutils literal notranslate"><span class="pre">run</span></code>
+again and pass them as <code class="docutils literal notranslate"><span class="pre">inputs</span></code>.</p>
 </div>
-<p>Applications form the core representation of the state machine. You build them with the <code class="docutils literal notranslate"><span class="pre">ApplicationBuilder</span></code>.
-Here is the minimum that is required:</p>
-<ol class="arabic simple">
-<li><p>A <code class="docutils literal notranslate"><span class="pre">**kwargs</span></code> of actions passed to <code class="docutils literal notranslate"><span class="pre">with_actions(...)</span></code></p></li>
-<li><p>Any relevant transitions (with conditions)</p></li>
-<li><p>An entry point – this is the first action to execute</p></li>
-</ol>
-<p>This is shown in the example from <a class="reference internal" href="../../getting_started/simple-example/#simpleexample"><span class="std std-ref">getting started</span></a></p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">ApplicationBuilder</span><span class="p">,</span> <span class="n">default</span><span class="p">,</span> <span class="n">expr</span>
+<p>An agent can run on its own until it needs a person – a prompt, a clarification, an
+approval. Burr does not prompt the user. It stops, hands control back to your code, and
+waits for the next <code class="docutils literal notranslate"><span class="pre">run</span></code>.</p>
+<p>The action that needs a person looks like any other action. The extra parameters are not
+read from state; they come from the caller:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"draft"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"approved"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">human_step</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">approved</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">approved</span><span class="o">=</span><span class="n">approved</span><span class="p">)</span>
+</pre></div>
+</div>
+<p><code class="docutils literal notranslate"><span class="pre">approved</span></code> is a runtime input. Bind long-lived objects (an API client, a DB handle) with
+<code class="docutils literal notranslate"><span class="pre">.bind(...)</span></code>. Pass per-turn values with <code class="docutils literal notranslate"><span class="pre">inputs={...}</span></code> on <code class="docutils literal notranslate"><span class="pre">run</span></code> / <code class="docutils literal notranslate"><span class="pre">step</span></code> /
+<code class="docutils literal notranslate"><span class="pre">iterate</span></code>. See <a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a>.</p>
+<section id="halt-before-and-run">
+<h2><code class="docutils literal notranslate"><span class="pre">halt_before</span></code> and <code class="docutils literal notranslate"><span class="pre">run</span></code><a class="headerlink" href="#halt-before-and-run" title="Link to this heading">¶</a></h2>
+<p><code class="docutils literal notranslate"><span class="pre">Application.run</span></code> walks the graph until a halt condition hits, then returns
+<code class="docutils literal notranslate"><span class="pre">(action,</span> <span class="pre">result,</span> <span class="pre">state)</span></code>.</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">halt_before=[&quot;human_step&quot;]</span></code> stops when <code class="docutils literal notranslate"><span class="pre">human_step</span></code> is the <em>next</em> action. That
+action has <strong>not</strong> run. <code class="docutils literal notranslate"><span class="pre">result</span></code> is <code class="docutils literal notranslate"><span class="pre">None</span></code>. The returned <code class="docutils literal notranslate"><span class="pre">action</span></code> is
+<code class="docutils literal notranslate"><span class="pre">human_step</span></code>.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">halt_after=[&quot;final_result&quot;]</span></code> stops after that action has run. <code class="docutils literal notranslate"><span class="pre">result</span></code> is that
+action’s result dict. The returned <code class="docutils literal notranslate"><span class="pre">action</span></code> is <code class="docutils literal notranslate"><span class="pre">final_result</span></code>.</p></li>
+</ul>
+<p>If both could apply, <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> wins. <code class="docutils literal notranslate"><span class="pre">run</span></code> always executes at least one action
+before it checks halt conditions, then <code class="docutils literal notranslate"><span class="pre">inputs</span></code> apply only to that first action. Later
+actions in the same <code class="docutils literal notranslate"><span class="pre">run</span></code> that also need <code class="docutils literal notranslate"><span class="pre">inputs</span></code> are undefined – halt before those
+instead, and pass their values on the next <code class="docutils literal notranslate"><span class="pre">run</span></code>.</p>
+<p>You can pass action names or tags (<code class="docutils literal notranslate"><span class="pre">&quot;&#64;tag:needs_human&quot;</span></code>). The same halt arguments work
+on <code class="docutils literal notranslate"><span class="pre">iterate</span></code> / <code class="docutils literal notranslate"><span class="pre">arun</span></code> / <code class="docutils literal notranslate"><span class="pre">aiterate</span></code>. Details are in <a class="reference internal" href="../state-machine/#id1"><span class="std std-ref">Applications</span></a>.</p>
+</section>
+<section id="a-graph-with-one-handoff">
+<h2>A graph with one handoff<a class="headerlink" href="#a-graph-with-one-handoff" title="Link to this heading">¶</a></h2>
+<p>This is the shape <code class="docutils literal notranslate"><span class="pre">run(halt_before=[&quot;human_step&quot;])</span></code> is for. No LLM required:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">ApplicationBuilder</span><span class="p">,</span> <span class="n">State</span><span class="p">,</span> <span class="n">action</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"task"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">start</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">task</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">task</span><span class="o">=</span><span class="n">task</span><span class="p">)</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"task"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"draft"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">agent_work</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">draft</span><span class="o">=</span><span class="sa">f</span><span class="s2">"draft for: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'task'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"draft"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"approved"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">human_step</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">approved</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">approved</span><span class="o">=</span><span class="n">approved</span><span class="p">)</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"draft"</span><span class="p">,</span> <span class="s2">"approved"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"result"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">finish</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">result</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"draft"</span><span class="p">]</span> <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">"approved"</span><span class="p">]</span> <span class="k">else</span> <span class="kc">None</span [...]
+
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
-    <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">agent_work</span><span class="p">,</span> <span class="n">human_step</span><span class="p">,</span> <span class="n">finish</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
-    <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"start"</span><span class="p">,</span> <span class="s2">"agent_work"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"agent_work"</span><span class="p">,</span> <span class="s2">"human_step"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_step"</span><span class="p">,</span> <span class="s2">"finish"</span><span class="p">),</span>
+    <span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"start"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
-</pre></div>
-</div>
-<section id="running">
-<h2>Running<a class="headerlink" href="#running" title="Link to this heading">¶</a></h2>
-<p>There are four APIs for executing an application.</p>
-<section id="step-astep">
-<h3><code class="docutils literal notranslate"><span class="pre">step</span></code>/<code class="docutils literal notranslate"><span class="pre">astep</span></code><a class="headerlink" href="#step-astep" title="Link to this heading">¶</a></h3>
-<p>Returns the tuple of the action, the result of that action, and the new state. Call this if you want to run the application step-by-step.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">step</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>If you’re in an async context, you can run <cite>astep</cite> instead:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astep</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>Step can also take in <code class="docutils literal notranslate"><span class="pre">inputs</span></code> as a dictionary, which will be passed to the action’s run function as keyword arguments.
-This is specifically meant for a “human in the loop” scenario, where the action needs to ask for input from a user. In this case,
-the control flow is meant to be interrupted to allow for the user to provide input. See <a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a> for more information.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">step</span><span class="p">(</span><span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</ [...]
-</pre></div>
-</div>
-</section>
-<section id="iterate-aiterate">
-<h3><code class="docutils literal notranslate"><span class="pre">iterate</span></code>/<code class="docutils literal notranslate"><span class="pre">aiterate</span></code><a class="headerlink" href="#iterate-aiterate" title="Link to this heading">¶</a></h3>
-<p>Iterate just runs <code class="docutils literal notranslate"><span class="pre">step</span></code> in a row, functioning as a generator:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">application</span><span class="o">.</span><span class="n">iterate</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;fi [...]
-    <span class="nb">print</span><span class="p">(</span><span class="n">action</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">result</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>You can also run <code class="docutils literal notranslate"><span class="pre">aiterate</span></code> in an async context:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">async</span> <span class="k">for</span> <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">application</span><span class="o">.</span><span class="n">aiterate</span><span class="p">():</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">action</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">result</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>In the synchronous context this also has a return value of a tuple of:</p>
-<ol class="arabic simple">
-<li><p>the action that was specified in <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> or <code class="docutils literal notranslate"><span class="pre">halt_before</span></code>. In the <cite>after</cite> case the action will have already run. In the <code class="docutils literal notranslate"><span class="pre">before</span></code> case the action will not have run.</p></li>
-<li><p>The result of that action, in the <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> case, else None in the <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> case.</p></li>
-<li><p>The state of the application at the time of halting.</p></li>
-</ol>
-<p>You can access this by looking at the <code class="docutils literal notranslate"><span class="pre">value</span></code> variable of the <code class="docutils literal notranslate"><span class="pre">StopIteration</span></code> exception that is thrown
-at the end of the loop, as is standard for python generators.
-See the function implementation of <code class="docutils literal notranslate"><span class="pre">run</span></code> to show how this is done.</p>
-<p>In the async context, this does not return anything (asynchronous generators are not allowed a return value).</p>
-<p>If you want it to (attempt to) run forever, you can pass empty lists to <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> and <code class="docutils literal notranslate"><span class="pre">halt_before</span></code>.</p>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>You can add inputs to <code class="docutils literal notranslate"><span class="pre">iterate</span></code>/<code class="docutils literal notranslate"><span class="pre">aiterate</span></code> by passing in a dictionary of inputs through the <code class="docutils literal notranslate"><span class="pre">inputs</span></code> parameter.
-This will only apply to the first action. Actions that are not the first but require inputs are considered undefined behavior.</p>
-</div>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>The state machine has the capability of halting even if it does not reach one of the specified conditions – if there are
-no more transitions to take. This, however, is not a supported feature (and will log a warning). This is considered undefined behavior
-– use at your own risk, and consider adding a halting condition, or a default transition to a terminal.</p>
-</div>
-</section>
-<section id="run-arun">
-<h3><code class="docutils literal notranslate"><span class="pre">run</span></code>/<code class="docutils literal notranslate"><span class="pre">arun</span></code><a class="headerlink" href="#run-arun" title="Link to this heading">¶</a></h3>
-<p>Run just calls out to <code class="docutils literal notranslate"><span class="pre">iterate</span></code> and returns the final state.</p>
-<p>The <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> and <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> keyword arguments specify when to break out of running the state machine
-and return control back. <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> will stop after the specified action(s) has run, and <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> will stop before the specified action(s) has run.
-If multiple are specified, it will stop after the first one encountered, and the return values will be for that action.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;final_action_1&quot;</span><span class="p">,</span> <span class="s2">&quot;final_action_2&quot;</span><span class="p">]</span>
+
+<span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
+    <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_step"</span><span class="p">],</span>
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"task"</span><span class="p">:</span> <span class="s2">"write a thank-you note"</span><span class="p">},</span>
 <span class="p">)</span>
-</pre></div>
-</div>
-<p>In the async context, you can run <code class="docutils literal notranslate"><span class="pre">arun</span></code>:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">arun</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;final_action_1&quot;</span><span class="p">,</span> <span class="s2">&quot;final_action_2&quot;</span><span class="p">]</span>
+<span class="c1"># action.name == "human_step", result is None</span>
+<span class="c1"># start and agent_work have run; human_step has not</span>
+<span class="c1"># state["draft"] is ready for the person to look at</span>
+
+<span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"finish"</span><span class="p">],</span>
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"approved"</span><span class="p">:</span> <span class="kc">True</span><span class="p">},</span>
 <span class="p">)</span>
+<span class="c1"># first action of this run is human_step, so it receives approved=True</span>
+<span class="c1"># then finish runs; action.name == "finish"</span>
 </pre></div>
 </div>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>You can add inputs to <code class="docutils literal notranslate"><span class="pre">run</span></code>/<code class="docutils literal notranslate"><span class="pre">arun</span></code> in the same way as you can with <code class="docutils literal notranslate"><span class="pre">iterate</span></code> – it will only apply to the first action.</p>
-</div>
-<p><code class="docutils literal notranslate"><span class="pre">run</span></code> and <code class="docutils literal notranslate"><span class="pre">arun</span></code> largely have the same behavior as <code class="docutils literal notranslate"><span class="pre">iterate</span></code> and <code class="docutils literal notranslate"><span class="pre">aiterate</span></code>.</p>
-</section>
-<section id="stream-result-astream-result">
-<h3><code class="docutils literal notranslate"><span class="pre">stream_result</span></code>/<code class="docutils literal notranslate"><span class="pre">astream_result</span></code><a class="headerlink" href="#stream-result-astream-result" title="Link to this heading">¶</a></h3>
-<p>These allow you to stream responses back. Note they work best with streaming actions.
-Read about them in the <a class="reference internal" href="../streaming-actions/#streaming"><span class="std std-ref">streaming</span></a> section.</p>
+<p>The first <code class="docutils literal notranslate"><span class="pre">run</span></code> stops <em>before</em> <code class="docutils literal notranslate"><span class="pre">human_step</span></code>. The second <code class="docutils literal notranslate"><span class="pre">run</span></code> starts <em>at</em>
+<code class="docutils literal notranslate"><span class="pre">human_step</span></code>, so <code class="docutils literal notranslate"><span class="pre">inputs={&quot;approved&quot;:</span> <span class="pre">True}</span></code> is what that action receives.</p>
+<p><code class="docutils literal notranslate"><span class="pre">app.get_next_action()</span></code> tells you which action is queued if you want to inspect
+without running.</p>
 </section>
-</section>
-<section id="graph-api">
-<h2>Graph API<a class="headerlink" href="#graph-api" title="Link to this heading">¶</a></h2>
-<p>The application exposes a graph API, allowing you to specify it as a graph separate from application concerns.
-While you likely won’t use this in your first few applications, it will become useful when you want to run it
-in a web-server (create a graph once, application many times), import the graph from another context, or run it in multiple contexts.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">ApplicationBuilder</span><span class="p">,</span> <span class="n">default</span><span class="p">,</span> <span class="n">expr</span>
-<span class="n">graph</span> <span class="o">=</span> <span class="p">(</span>
-    <span class="n">GraphBuilder</span><span class="p">()</span>
-    <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
-    <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
-<span class="p">)</span>
+<section id="a-chat-loop">
+<h2>A chat loop<a class="headerlink" href="#a-chat-loop" title="Link to this heading">¶</a></h2>
+<p>When the human action is both the entrypoint and the place you return to, collect the
+prompt in the outer loop and halt before that same action. The first step of each
+<code class="docutils literal notranslate"><span class="pre">run</span></code> is the human action (it gets <code class="docutils literal notranslate"><span class="pre">inputs</span></code>); the application then continues until
+that action is next again:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">ApplicationBuilder</span><span class="p">,</span> <span class="n">State</span><span class="p">,</span> <span class="n">action</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">human_input</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+        <span class="n">chat_history</span><span class="o">=</span><span class="p">{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
+    <span class="p">)</span>
+
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">ai_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+    <span class="n">reply</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"you said: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'chat_history'</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="s1">'content'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">reply</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+        <span class="n">chat_history</span><span class="o">=</span><span class="p">{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="n">reply</span><span class="p">}</span>
+    <span class="p">)</span>
+
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
-    <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">graph</span><span class="p">)</span>
-    <span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">),</span>
+    <span class="p">)</span>
+    <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
+
+<span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
+    <span class="n">prompt</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"you: "</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">prompt</span> <span class="o">==</span> <span class="s2">"exit"</span><span class="p">:</span>
+        <span class="k">break</span>
+    <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_input"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">},</span>
+    <span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">"ai:"</span><span class="p">,</span> <span class="n">state</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 </pre></div>
 </div>
-<p>You can read more about it in the <a class="reference internal" href="../../reference/application/#burr.core.graph.GraphBuilder" title="burr.core.graph.GraphBuilder"><code class="xref py py-class docutils literal notranslate"><span class="pre">GraphBuilder</span> <span class="pre">docs</span></code></a>.</p>
+<p>In this two-node cycle, <code class="docutils literal notranslate"><span class="pre">halt_after=[&quot;ai_response&quot;]</span></code> stops at the same place – after
+the model has spoken, before the next human turn. <code class="docutils literal notranslate"><span class="pre">halt_before=[&quot;human_input&quot;]</span></code> is the
+same stop, with <code class="docutils literal notranslate"><span class="pre">result</span> <span class="pre">is</span> <span class="pre">None</span></code> and <code class="docutils literal notranslate"><span class="pre">action.name</span> <span class="pre">==</span> <span class="pre">&quot;human_input&quot;</span></code>. The getting
+started chatbot uses <code class="docutils literal notranslate"><span class="pre">halt_after=[&quot;ai_response&quot;]</span></code> for a single turn; a running CLI
+example of the <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> loop is
+<a class="reference external" href="https://github.com/apache/burr/blob/main/examples/conversational-rag/graph_db_example/application.py">examples/conversational-rag/graph_db_example/application.py</a>
+(<code class="docutils literal notranslate"><span class="pre">human_converse</span></code> / <code class="docutils literal notranslate"><span class="pre">user_question</span></code>).</p>
+</section>
+<section id="several-handoff-points">
+<h2>Several handoff points<a class="headerlink" href="#several-handoff-points" title="Link to this heading">¶</a></h2>
+<p>Some applications need a person more than once, at different actions. Halt before every
+action that needs <code class="docutils literal notranslate"><span class="pre">inputs</span></code>, halt after the terminal action, and use <code class="docutils literal notranslate"><span class="pre">action.name</span></code> to
+decide what to collect next.</p>
+<p>This is the email assistant
+(<a class="reference external" href="https://github.com/apache/burr/tree/main/examples/email-assistant">examples/email-assistant</a>).
+<code class="docutils literal notranslate"><span class="pre">process_input</span></code> takes <code class="docutils literal notranslate"><span class="pre">email_to_respond</span></code> and <code class="docutils literal notranslate"><span class="pre">response_instructions</span></code>.
+<code class="docutils literal notranslate"><span class="pre">clarify_instructions</span></code> takes <code class="docutils literal notranslate"><span class="pre">clarification_inputs</span></code> (a <code class="docutils literal notranslate"><span class="pre">list[str]</span></code>).
+<code class="docutils literal notranslate"><span class="pre">process_feedback</span></code> takes <code class="docutils literal notranslate"><span class="pre">feedback</span></code>. The graph goes
+<code class="docutils literal notranslate"><span class="pre">process_input</span> <span class="pre">→</span> <span class="pre">determine_clarifications</span> <span class="pre">→</span> <span class="pre">(clarify_instructions?)</span> <span class="pre">→</span> <span class="pre">formulate_draft</span> <span class="pre">→</span> <span class="pre">process_feedback</span> <span class="pre">→</span> <span class="pre">…</span> <span class="pre">→</span> <span class="pre">final_result</span></ [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">inputs</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="s2">"email_to_respond"</span><span class="p">:</span> <span class="n">incoming</span><span class="p">,</span>
+    <span class="s2">"response_instructions"</span><span class="p">:</span> <span class="n">instructions</span><span class="p">,</span>
+<span class="p">}</span>
+<span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
+    <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"clarify_instructions"</span><span class="p">,</span> <span class="s2">"process_feedback"</span><span class="p">],</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"final_result"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="n">inputs</span><span class="p">,</span>
+    <span class="p">)</span>
+    <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"clarify_instructions"</span><span class="p">:</span>
+        <span class="c1"># clarify_instructions has not run; questions are already in state</span>
+        <span class="n">answers</span> <span class="o">=</span> <span class="p">[</span><span class="nb">input</span><span class="p">(</span><span class="n">q</span> <span class="o">+</span> <span class="s2">" "</span><span class="p">)</span> <span class="k">for</span> <span class="n">q</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"clarification_questions"</span><span class="p">]]</span>
+        <span class="n">inputs</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"clarification_inputs"</span><span class="p">:</span> <span class="n">answers</span><span class="p">}</span>
+    <span class="k">elif</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"process_feedback"</span><span class="p">:</span>
+        <span class="n">comment</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"feedback (empty accepts the draft): "</span><span class="p">)</span>
+        <span class="n">inputs</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"feedback"</span><span class="p">:</span> <span class="n">comment</span><span class="p">}</span>
+    <span class="k">elif</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"final_result"</span><span class="p">:</span>
+        <span class="k">break</span>
+</pre></div>
+</div>
+<p>Include <code class="docutils literal notranslate"><span class="pre">halt_after=[&quot;final_result&quot;]</span></code>. Without it, an empty <code class="docutils literal notranslate"><span class="pre">feedback</span></code> sends the
+graph through <code class="docutils literal notranslate"><span class="pre">final_result</span></code> and then leaves it with no next action, which <code class="docutils literal notranslate"><span class="pre">run</span></code>
+treats as undefined (it logs a warning).</p>
+<p>The FastAPI wiring for the same halt list is
+<a class="reference external" href="https://github.com/apache/burr/blob/main/examples/email-assistant/server.py">examples/email-assistant/server.py</a>
+(<code class="docutils literal notranslate"><span class="pre">_run_through</span></code>) and the walkthrough in
+<a class="reference external" href="https://github.com/apache/burr/tree/main/examples/web-server">examples/web-server</a>.</p>
+</section>
+<section id="web-servers-and-persistence">
+<h2>Web servers and persistence<a class="headerlink" href="#web-servers-and-persistence" title="Link to this heading">¶</a></h2>
+<p>The loop does not have to live in one process. On a web server each request loads the
+application, calls <code class="docutils literal notranslate"><span class="pre">run</span></code> once, and returns. The next request supplies the next
+<code class="docutils literal notranslate"><span class="pre">inputs</span></code>.</p>
+<p><code class="docutils literal notranslate"><span class="pre">examples/email-assistant</span></code> does that with <code class="docutils literal notranslate"><span class="pre">initialize_from(...,</span> <span class="pre">resume_at_next_action=True)</span></code>
+and a persister / tracker keyed by <code class="docutils literal notranslate"><span class="pre">app_id</span></code>. The person can come back seconds or days
+later. See <a class="reference internal" href="../state-persistence/#id1"><span class="std std-ref">State Persistence</span></a>.</p>
+<p><code class="docutils literal notranslate"><span class="pre">app.get_next_action()</span></code> is useful here: the handler can tell the client which form to
+show without advancing the graph.</p>
 </section>
-<section id="inspection">
-<h2>Inspection<a class="headerlink" href="#inspection" title="Link to this heading">¶</a></h2>
-<p>You can ask various questions of the state machine using publicly-supported APIs:</p>
+<section id="command-line-only">
+<h2>Command-line only<a class="headerlink" href="#command-line-only" title="Link to this heading">¶</a></h2>
+<p>If the application only ever runs in a terminal, you can call <code class="docutils literal notranslate"><span class="pre">input(...)</span></code> inside an
+action and skip the outer loop. That does not work for a web server, a persisted app, or
+any caller that is not sitting on stdin. Prefer <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> + <code class="docutils literal notranslate"><span class="pre">inputs</span></code> unless you
+are writing a one-off CLI.</p>
+</section>
+<section id="nested-applications">
+<h2>Nested applications<a class="headerlink" href="#nested-applications" title="Link to this heading">¶</a></h2>
+<p>Halting <em>inside</em> a sub-application and surfacing that to the parent is more involved.
+The wrapping action runs the child with <code class="docutils literal notranslate"><span class="pre">halt_before</span></code>, then either:</p>
+<ul class="simple">
+<li><p>sets a flag such as <code class="docutils literal notranslate"><span class="pre">need_input=True</span></code> and returns, with a parent transition back to
+itself, or</p></li>
+<li><p>copies the child’s finished state up and continues.</p></li>
+</ul>
+<p>The parent still collects the person’s values and passes them as <code class="docutils literal notranslate"><span class="pre">inputs</span></code> into the
+wrapping action on the next <code class="docutils literal notranslate"><span class="pre">run</span></code>. The child is not visible to the parent’s
+<code class="docutils literal notranslate"><span class="pre">halt_before</span></code> list.</p>
+</section>
+<section id="see-also">
+<h2>See also<a class="headerlink" href="#see-also" title="Link to this heading">¶</a></h2>
 <ul class="simple">
-<li><p><code class="docutils literal notranslate"><span class="pre">application.graph</span></code> will give you a static representation of the state machine with enough information to visualize</p></li>
-<li><p><code class="docutils literal notranslate"><span class="pre">application.state</span></code> will give you the current state of the state machine. Note that if you modify it the results will not show up – state is immutable! Modify the state through actions.</p></li>
+<li><p><a class="reference internal" href="../state-machine/#id1"><span class="std std-ref">Applications</span></a> – <code class="docutils literal notranslate"><span class="pre">run</span></code>, <code class="docutils literal notranslate"><span class="pre">iterate</span></code>, <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> / <code class="docutils literal notranslate"><span class="pre">halt_after</span></code></p></li>
+<li><p><a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a> – runtime inputs vs <code class="docutils literal notranslate"><span class="pre">.bind(...)</span></code></p></li>
+<li><p><a class="reference internal" href="../state-persistence/#id1"><span class="std std-ref">State Persistence</span></a> – pause and resume across requests</p></li>
+<li><p><a class="reference external" href="https://github.com/apache/burr/tree/main/examples/email-assistant">Email assistant</a></p></li>
+<li><p><a class="reference external" href="https://github.com/apache/burr/blob/main/examples/conversational-rag/graph_db_example/application.py">Graph-DB RAG CLI loop</a></p></li>
+<li><p><a class="reference external" href="https://github.com/apache/burr/tree/main/examples/web-server">Burr in a web server</a></p></li>
 </ul>
-<p>See the <a class="reference internal" href="../../reference/application/#applicationref"><span class="std std-ref">application docs</span></a></p>
 </section>
 </section>
 
@@ -573,14 +656,14 @@ in a web-server (create a graph once, application many times), import the graph
               </div>
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
             </a>
-          <a class="prev-page" href="../state/">
+          <a class="prev-page" href="../state-machine/">
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
               <div class="page-info">
                 <div class="context">
                   <span>Previous</span>
                 </div>
                 
-                <div class="title">State</div>
+                <div class="title">Applications</div>
                 
               </div>
             </a>
@@ -627,16 +710,15 @@ in a web-server (create a graph once, application many times), import the graph
         <div class="toc-tree-container">
           <div class="toc-tree">
             <ul>
-<li><a class="reference internal" href="#">Applications</a><ul>
-<li><a class="reference internal" href="#running">Running</a><ul>
-<li><a class="reference internal" href="#step-astep"><code class="docutils literal notranslate"><span class="pre">step</span></code>/<code class="docutils literal notranslate"><span class="pre">astep</span></code></a></li>
-<li><a class="reference internal" href="#iterate-aiterate"><code class="docutils literal notranslate"><span class="pre">iterate</span></code>/<code class="docutils literal notranslate"><span class="pre">aiterate</span></code></a></li>
-<li><a class="reference internal" href="#run-arun"><code class="docutils literal notranslate"><span class="pre">run</span></code>/<code class="docutils literal notranslate"><span class="pre">arun</span></code></a></li>
-<li><a class="reference internal" href="#stream-result-astream-result"><code class="docutils literal notranslate"><span class="pre">stream_result</span></code>/<code class="docutils literal notranslate"><span class="pre">astream_result</span></code></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#graph-api">Graph API</a></li>
-<li><a class="reference internal" href="#inspection">Inspection</a></li>
+<li><a class="reference internal" href="#">Human in the Loop</a><ul>
+<li><a class="reference internal" href="#halt-before-and-run"><code class="docutils literal notranslate"><span class="pre">halt_before</span></code> and <code class="docutils literal notranslate"><span class="pre">run</span></code></a></li>
+<li><a class="reference internal" href="#a-graph-with-one-handoff">A graph with one handoff</a></li>
+<li><a class="reference internal" href="#a-chat-loop">A chat loop</a></li>
+<li><a class="reference internal" href="#several-handoff-points">Several handoff points</a></li>
+<li><a class="reference internal" href="#web-servers-and-persistence">Web servers and persistence</a></li>
+<li><a class="reference internal" href="#command-line-only">Command-line only</a></li>
+<li><a class="reference internal" href="#nested-applications">Nested applications</a></li>
+<li><a class="reference internal" href="#see-also">See also</a></li>
 </ul>
 </li>
 </ul>
diff --git a/content/docs/concepts/index.html b/content/docs/concepts/index.html
index 2c792b3e..764d8dbf 100644
--- a/content/docs/concepts/index.html
+++ b/content/docs/concepts/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -435,6 +436,17 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="state-machine/#inspection">Inspection</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="human-in-the-loop/">Human in the Loop</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#halt-before-and-run"><code class="docutils literal notranslate"><span class="pre">halt_before</span></code> and <code class="docutils literal notranslate"><span class="pre">run</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#a-graph-with-one-handoff">A graph with one handoff</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#a-chat-loop">A chat loop</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#several-handoff-points">Several handoff points</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#web-servers-and-persistence">Web servers and persistence</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#command-line-only">Command-line only</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#nested-applications">Nested applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="human-in-the-loop/#see-also">See also</a></li>
+</ul>
+</li>
 <li class="toctree-l1"><a class="reference internal" href="transitions/">Transitions</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="transitions/#conditions">Conditions</a></li>
 </ul>
diff --git a/content/docs/concepts/overview/index.html b/content/docs/concepts/overview/index.html
index a2b8069d..5bab2aa5 100644
--- a/content/docs/concepts/overview/index.html
+++ b/content/docs/concepts/overview/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/concepts/parallelism/index.html b/content/docs/concepts/parallelism/index.html
index 43a47c7a..bc224a6b 100644
--- a/content/docs/concepts/parallelism/index.html
+++ b/content/docs/concepts/parallelism/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -473,25 +474,25 @@ Beyond that, Burr can support parallelism however you wish to run it – see the
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]))</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]))</span>
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultiplePrompts</span><span class="p">(</span><span class="n">MapStates</span><span class="p">):</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">action</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o"> [...]
         <span class="c1"># make sure to add a name to the action</span>
         <span class="c1"># This is not necessary for subgraphs, as actions will already have names</span>
-        <span class="k">return</span> <span class="n">query_llm</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;query_llm&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">query_llm</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"query_llm"</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span [...]
-        <span class="c1"># You could easily have a list_prompts upstream action that writes to &quot;prompts&quot; in state</span>
+        <span class="c1"># You could easily have a list_prompts upstream action that writes to "prompts" in state</span>
         <span class="c1"># And loop through those</span>
         <span class="c1"># This hardcodes for simplicity</span>
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
@@ -499,16 +500,16 @@ Beyond that, Burr can support parallelism however you wish to run it – see the
     <span class="k">def</span><span class="w"> </span><span class="nf">reduce</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">states</span><span class="p">:</span> <span class="n">Generator</span><span class="p">[</span><span class="n">State</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span cla [...]
         <span class="n">all_llm_outputs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
-            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompts"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 <p>Then, to run the application:</p>
@@ -518,7 +519,7 @@ Beyond that, Burr can support parallelism however you wish to run it – see the
         <span class="n">prompt_generator</span><span class="o">=</span><span class="n">generate_prompts</span><span class="p">,</span> <span class="c1"># not defined above, this writes to prompts</span>
         <span class="n">multi_prompt_test</span><span class="o">=</span><span class="n">TestMultiplePrompts</span><span class="p">(),</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;prompt_generator&quot;</span><span class="p">,</span> <span class="s2">&quot;multi_prompt_test&quot;</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"prompt_generator"</span><span class="p">,</span> <span class="s2">"multi_prompt_test"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
@@ -546,41 +547,41 @@ Beyond that, Burr can support parallelism however you wish to run it – see the
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapActions</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">Any</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultipleModels</span><span class="p">(</span><span class="n">MapActions</span><span class="p">):</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">actions</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</spa [...]
         <span class="c1"># Make sure to add a name to the action if you use bind() with a function,</span>
         <span class="c1"># note that these can be different actions, functions, etc...</span>
-        <span class="c1"># in this case we&#39;re using `.bind()` to create multiple actions, but we can use some mix of</span>
+        <span class="c1"># in this case we're using `.bind()` to create multiple actions, but we can use some mix of</span>
         <span class="c1"># subgraphs, functions, action objects, etc...</span>
         <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
         <span class="p">]</span>
             <span class="k">yield</span> <span class="n">action</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">state</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">- [...]
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="s2">"What is the meaning of life?"</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">reduce</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">states</span><span class="p">:</span> <span class="n">Generator</span><span class="p">[</span><span class="n">State</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span cla [...]
         <span class="n">all_llm_outputs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
-            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span> <span class="c1"># we&#39;re just running this on a single prompt, for multiple actions</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span> <span class="c1"># we're just running this on a single prompt, for multiple actions</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 <p>Then, it’s almost identical to the <code class="docutils literal notranslate"><span class="pre">MapStates</span></code> case:</p>
@@ -590,7 +591,7 @@ Beyond that, Burr can support parallelism however you wish to run it – see the
         <span class="n">prompt_generator</span><span class="o">=</span><span class="n">generate_prompts</span><span class="p">,</span> <span class="c1"># not defined above, this writes to prompts</span>
         <span class="n">multi_prompt_test</span><span class="o">=</span><span class="n">TestMultipleModels</span><span class="p">(),</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;prompt_generator&quot;</span><span class="p">,</span> <span class="s2">&quot;multi_prompt_test&quot;</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"prompt_generator"</span><span class="p">,</span> <span class="s2">"multi_prompt_test"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
@@ -607,10 +608,10 @@ combinations.</p>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapActionsAndStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestModelsOverPrompts</span><span class="p">(</span><span class="n">MapActionsAndStates</span><span class="p">):</span>
 
@@ -618,17 +619,17 @@ combinations.</p>
         <span class="c1"># make sure to add a name to the action</span>
         <span class="c1"># This is not necessary for subgraphs, as actions will already have names</span>
         <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
         <span class="p">]</span>
             <span class="k">yield</span> <span class="n">action</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span [...]
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
@@ -637,20 +638,20 @@ combinations.</p>
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
             <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
                 <span class="p">{</span>
-                    <span class="s2">&quot;output&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;model&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;prompt&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+                    <span class="s2">"output"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">],</span>
+                    <span class="s2">"model"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"model"</span><span class="p">],</span>
+                    <span class="s2">"prompt"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
                 <span class="p">}</span>
             <span class="p">)</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompts"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 </section>
@@ -675,16 +676,16 @@ combinations.</p>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">Graph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">RunnableGraph</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">process_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">processed_prompt</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;The user has asked: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">. Please respond directly to that prompt, but only in riddles.&quot;</span>
+    <span class="n">processed_prompt</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"The user has asked: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">]</span><span class="si">}</span><span class="s2">. Please respond directly to that prompt, but only in riddles."</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-        <span class="n">processed_prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+        <span class="n">processed_prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
     <span class="p">)</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">]))</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">]))</span>
 
 <span class="n">graph</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">GraphBuilder</span><span class="p">()</span>
@@ -692,14 +693,14 @@ combinations.</p>
         <span class="n">process_prompt</span><span class="o">=</span><span class="n">process_prompt</span><span class="p">,</span>
         <span class="n">query_llm</span><span class="o">=</span><span class="n">query</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;process_prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;query_llm&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"process_prompt"</span><span class="p">,</span> <span class="s2">"query_llm"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 
 <span class="n">runnable_graph</span> <span class="o">=</span> <span class="n">RunnableGraph</span><span class="p">(</span>
     <span class="n">graph</span><span class="o">=</span><span class="n">graph</span><span class="p">,</span>
-    <span class="n">entrypoint</span><span class="o">=</span><span class="s2">&quot;process_prompt&quot;</span><span class="p">,</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;query_llm&quot;</span><span class="p">]</span>
+    <span class="n">entrypoint</span><span class="o">=</span><span class="s2">"process_prompt"</span><span class="p">,</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"query_llm"</span><span class="p">]</span>
 <span class="p">)</span>
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultiplePromptsWithSubgraph</span><span class="p">(</span><span class="n">MapStates</span><span class="p">):</span>
@@ -709,9 +710,9 @@ combinations.</p>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span [...]
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
@@ -730,16 +731,16 @@ inputs as well to ensure it has everything it needs – we will likely be automa
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span><span class="p">,</span> <span class="n">State</span><span class="p">,</span> <span class="n">ApplicationContext</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">Graph</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">process_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">processed_prompt</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;The user has asked: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">. Please respond directly to that prompt, but only in riddles.&quot;</span>
+    <span class="n">processed_prompt</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"The user has asked: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">]</span><span class="si">}</span><span class="s2">. Please respond directly to that prompt, but only in riddles."</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-        <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+        <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
     <span class="p">)</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;processed_prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span>< [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"processed_prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
 
 <span class="n">graph</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">GraphBuilder</span><span class="p">()</span>
@@ -747,14 +748,14 @@ inputs as well to ensure it has everything it needs – we will likely be automa
         <span class="n">process_prompt</span><span class="o">=</span><span class="n">process_prompt</span><span class="p">,</span>
         <span class="n">query_llm</span><span class="o">=</span><span class="n">query</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;process_prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;query_llm&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"process_prompt"</span><span class="p">,</span> <span class="s2">"query_llm"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 
 <span class="n">runnable_graph</span> <span class="o">=</span> <span class="n">RunnableGraph</span><span class="p">(</span>
     <span class="n">graph</span><span class="o">=</span><span class="n">graph</span><span class="p">,</span>
-    <span class="n">entrypoint</span><span class="o">=</span><span class="s2">&quot;process_prompt&quot;</span><span class="p">,</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="s2">&quot;query_llm&quot;</span>
+    <span class="n">entrypoint</span><span class="o">=</span><span class="s2">"process_prompt"</span><span class="p">,</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="s2">"query_llm"</span>
 <span class="p">)</span>
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultiplePromptsWithSubgraph</span><span class="p">(</span><span class="n">MapStates</span><span class="p">):</span>
@@ -764,10 +765,10 @@ inputs as well to ensure it has everything it needs – we will likely be automa
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">inputs</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">inputs</span> <span class="c1"># make sure to include the superclass inputs</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompts"</span><span class="p">]</span> <span class="o">+</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">inputs</span> <span class="c1"># make sure to include the superclass inputs</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span [...]
-        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">inputs</span><span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]:</span>
+        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">inputs</span><span class="p">[</span><span class="s2">"prompts"</span><span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
     <span class="o">...</span> <span class="c1"># same as above</span>
@@ -793,18 +794,18 @@ which can be actions or subgraphs. These tasks are then executed by the <code cl
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">MultipleTaskExample</span><span class="p">(</span><span class="n">TaskBasedParallelAction</span><span class="p">):</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">tasks</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="n">SubGraphTask</span><span class="p">,</span> <span class=" [...]
-        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]:</span>
+        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompts"</span><span class="p">]:</span>
             <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
             <span class="p">]</span>
                 <span class="k">yield</span> <span class="n">SubGraphTask</span><span class="p">(</span>
                     <span class="n">action</span><span class="o">=</span><span class="n">action</span><span class="p">,</span> <span class="c1"># can be a RunnableGraph as well</span>
@@ -820,9 +821,9 @@ which can be actions or subgraphs. These tasks are then executed by the <code cl
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
             <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
                 <span class="p">{</span>
-                    <span class="s2">&quot;output&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;model&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;prompt&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+                    <span class="s2">"output"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">],</span>
+                    <span class="s2">"model"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"model"</span><span class="p">],</span>
+                    <span class="s2">"prompt"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
                 <span class="p">}</span>
             <span class="p">)</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
@@ -898,12 +899,12 @@ if you are using the lower-level API.</p>
         <span class="k">return</span> <span class="n">runnable_graph</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">tracker</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">context</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">TrackingBehavior</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="c1"># return &quot;cascade&quot; # default</span>
+        <span class="c1"># return "cascade" # default</span>
         <span class="c1"># return None # no tracking</span>
         <span class="k">return</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="o">...</span><span class="p">)</span> <span class="c1"># custom tracker</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">state_persister</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Persister</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="c1"># return &quot;cascade&quot; # default</span>
+        <span class="c1"># return "cascade" # default</span>
         <span class="c1"># return None # no persistence</span>
         <span class="k">return</span> <span class="n">SQLLitePersister</span><span class="p">(</span><span class="o">...</span><span class="p">)</span> <span class="c1"># custom persister</span>
 
@@ -980,14 +981,14 @@ LLM might come up with a solution.</p>
     <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">action</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class=" [...]
         <span class="c1"># Yield multiple model components to run in parallel</span>
         <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">model_config</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_model_configs</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">ModelResponse</span><span class="p">(</span><span class="n">config</span><span class="o">=</span><span class="n">model_config</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;model_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+            <span class="k">yield</span> <span class="n">ModelResponse</span><span class="p">(</span><span class="n">config</span><span class="o">=</span><span class="n">model_config</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="sa">f</span><span class="s2">"model_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 
     <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class=" [...]
         <span class="c1"># Prepare the state with the user query</span>
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
@@ -995,8 +996,8 @@ LLM might come up with a solution.</p>
         <span class="c1"># Collect all model responses</span>
         <span class="n">all_responses</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">async</span> <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
-            <span class="n">model_key</span> <span class="o">=</span> <span class="n">sub_state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;model_key&quot;</span><span class="p">)</span>
-            <span class="n">response</span> <span class="o">=</span> <span class="n">sub_state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">model_key</span><span class="p">,</span> <span class="p">[])[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;content&quot;</span><span class="p">,</span> <span class="s2">& [...]
+            <span class="n">model_key</span> <span class="o">=</span> <span class="n">sub_state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"model_key"</span><span class="p">)</span>
+            <span class="n">response</span> <span class="o">=</span> <span class="n">sub_state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">model_key</span><span class="p">,</span> <span class="p">[])[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"content"</span><span class="p">,</span> <span class="s2">""</span><s [...]
             <span class="n">all_responses</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="p">)</span>
 
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">ensemble_responses</span><span class="o">=</span><span class="n">all_responses</span><span class="p">)</span>
@@ -1023,11 +1024,11 @@ LLM might come up with a solution.</p>
 
 <span class="c1"># Create an async persister with a connection pool</span>
 <span class="n">persister</span> <span class="o">=</span> <span class="k">await</span> <span class="n">AsyncPGPersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span>
-    <span class="n">host</span><span class="o">=</span><span class="s2">&quot;localhost&quot;</span><span class="p">,</span>
+    <span class="n">host</span><span class="o">=</span><span class="s2">"localhost"</span><span class="p">,</span>
     <span class="n">port</span><span class="o">=</span><span class="mi">5432</span><span class="p">,</span>
-    <span class="n">user</span><span class="o">=</span><span class="s2">&quot;postgres&quot;</span><span class="p">,</span>
-    <span class="n">password</span><span class="o">=</span><span class="s2">&quot;postgres&quot;</span><span class="p">,</span>
-    <span class="n">database</span><span class="o">=</span><span class="s2">&quot;burr&quot;</span><span class="p">,</span>
+    <span class="n">user</span><span class="o">=</span><span class="s2">"postgres"</span><span class="p">,</span>
+    <span class="n">password</span><span class="o">=</span><span class="s2">"postgres"</span><span class="p">,</span>
+    <span class="n">database</span><span class="o">=</span><span class="s2">"burr"</span><span class="p">,</span>
     <span class="n">use_pool</span><span class="o">=</span><span class="kc">True</span>  <span class="c1"># Important for parallelism!</span>
 <span class="p">)</span>
 
diff --git a/content/docs/concepts/planned-capabilities/index.html b/content/docs/concepts/planned-capabilities/index.html
index 381bc4c7..bf3a0134 100644
--- a/content/docs/concepts/planned-capabilities/index.html
+++ b/content/docs/concepts/planned-capabilities/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -452,32 +453,32 @@ if an exception is expected, the program will stop early. We will be adding the
 on exceptions, which will allow you to transition to an error-handling (or retry) action that does not
 need the full outputs of the prior action.</p>
 <p>Here is what it would look like in the current API:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;attempts&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">,</span> <span class="s2">&quot;attempts&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"attempts"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"output"</span><span class="p">,</span> <span class="s2">"attempts"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">some_flaky_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">max_retries</span><span class="p">:</span> <span class="nb">int</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;output&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span> <span class="s2">&quot;attempts&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;attempts&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">}</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"output"</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span> <span class="s2">"attempts"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"attempts"</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">}</span>
     <span class="k">try</span><span class="p">:</span>
-        <span class="n">result</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">call_some_api</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
+        <span class="n">result</span><span class="p">[</span><span class="s2">"output"</span><span class="p">]</span> <span class="o">=</span> <span class="n">call_some_api</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
     <span class="k">except</span> <span class="n">APIException</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;attempts&quot;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">max_retries</span><span class="p">:</span>
+        <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">"attempts"</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">max_retries</span><span class="p">:</span>
            <span class="k">raise</span> <span class="n">e</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>One could imagine adding it as a condition (a few possibilities)</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">some_flaky_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;output&quot;</span><span class="p">:</span> <span class="n">call_some_api</span><span class="p">(</span><span class="o">...</span><span class="p">)}</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"output"</span><span class="p">:</span> <span class="n">call_some_api</span><span class="p">(</span><span class="o">...</span><span class="p">)}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 <span class="n">builder</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
    <span class="n">some_flaky_action</span><span class="o">=</span><span class="n">some_flaky_action</span>
 <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
    <span class="p">(</span>
-      <span class="s2">&quot;some_flaky_action&quot;</span><span class="p">,</span>
-      <span class="s2">&quot;some_flaky_action&quot;</span><span class="p">,</span>
+      <span class="s2">"some_flaky_action"</span><span class="p">,</span>
+      <span class="s2">"some_flaky_action"</span><span class="p">,</span>
       <span class="n">error</span><span class="p">(</span><span class="n">APIException</span><span class="p">)</span> <span class="c1"># infinite retries</span>
       <span class="n">error</span><span class="p">(</span><span class="n">APIException</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span> <span class="c1"># 3 visits to this edge then it gets reset if this is not chosen</span>
-      <span class="c1"># That&#39;s stored in state</span>
+      <span class="c1"># That's stored in state</span>
    <span class="p">)</span>
 <span class="p">)</span>
 </pre></div>
diff --git a/content/docs/concepts/recursion/index.html b/content/docs/concepts/recursion/index.html
index df29bbf0..544a5920 100644
--- a/content/docs/concepts/recursion/index.html
+++ b/content/docs/concepts/recursion/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -437,11 +438,11 @@ but we are actively working on building first-level constructs that allow this.<
 <li><p>Wire through tracker + parent data for the sub-application</p></li>
 </ol>
 <p>After creating a simple application (1)/(2) above, you can wire through the tracker like this (some pseudocode, see the example for a fully working application).</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;parameters_to_map&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;joined_results&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"parameters_to_map"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"joined_results"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">run_multiple_sub_apps</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># for every parameter incoming, run a sub-application</span>
     <span class="n">results</span> <span class="o">=</span> <span class="p">[]</span>
-    <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;parameters_to_map&quot;</span><span class="p">]:</span>
+    <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"parameters_to_map"</span><span class="p">]:</span>
         <span class="n">subapp</span> <span class="o">=</span> <span class="p">(</span>
             <span class="n">ApplicationBuilder</span><span class="p">()</span>
             <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
@@ -467,7 +468,7 @@ but we are actively working on building first-level constructs that allow this.<
 The tracker knows how to record the link so its in the UI.</p>
 <p>You can also run this in parallel – this leverages <a class="reference external" href="https://joblib.readthedocs.io/en/latest/">joblib</a>’s
 Parallel and delayed functions, but you can use whatever tooling you want (multiprocessing, threading, etc…).</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;parameters_to_map&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;joined_results&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"parameters_to_map"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"joined_results"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">run_multiple_sub_apps</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">run_subapp</span><span class="p">(</span><span class="n">parameter_set</span><span class="p">):</span>
         <span class="n">subapp</span> <span class="o">=</span> <span class="p">(</span>
@@ -486,7 +487,7 @@ Parallel and delayed functions, but you can use whatever tooling you want (multi
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">subapp</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
 
-    <span class="n">results</span> <span class="o">=</span> <span class="n">Parallel</span><span class="p">(</span><span class="n">n_jobs</span><span class="o">=-</span><span class="mi">1</span><span class="p">)(</span><span class="n">delayed</span><span class="p">(</span><span class="n">run_subapp</span><span class="p">)(</span><span class="n">parameter_set</span><span class="p">)</span> <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span cla [...]
+    <span class="n">results</span> <span class="o">=</span> <span class="n">Parallel</span><span class="p">(</span><span class="n">n_jobs</span><span class="o">=-</span><span class="mi">1</span><span class="p">)(</span><span class="n">delayed</span><span class="p">(</span><span class="n">run_subapp</span><span class="p">)(</span><span class="n">parameter_set</span><span class="p">)</span> <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span cla [...]
     <span class="n">joined</span> <span class="o">=</span> <span class="n">_join</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
 
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">joined_results</span><span class="o">=</span><span class="n">joined</span><span class="p">)</span>
@@ -509,7 +510,7 @@ yourself.</p>
 (say, for instance, that it’s run through levels of other frameworks), you can get access to the active context and tracker by using the following:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_active_context</span><span class="p">,</span> <span class="n">get_active_tracker</span><span class="p">,</span> <span class="n">ApplicationContext</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;parameters_to_map&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;joined_results&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"parameters_to_map"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"joined_results"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
    <span class="n">context</span> <span class="o">=</span> <span class="n">ApplicationContext</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
    <span class="k">def</span><span class="w"> </span><span class="nf">run_subapp</span><span class="p">(</span><span class="n">parameter_set</span><span class="p">):</span>
@@ -529,7 +530,7 @@ yourself.</p>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">subapp</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
 
-    <span class="n">results</span> <span class="o">=</span> <span class="n">Parallel</span><span class="p">(</span><span class="n">n_jobs</span><span class="o">=-</span><span class="mi">1</span><span class="p">)(</span><span class="n">delayed</span><span class="p">(</span><span class="n">run_subapp</span><span class="p">)(</span><span class="n">parameter_set</span><span class="p">)</span> <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span cla [...]
+    <span class="n">results</span> <span class="o">=</span> <span class="n">Parallel</span><span class="p">(</span><span class="n">n_jobs</span><span class="o">=-</span><span class="mi">1</span><span class="p">)(</span><span class="n">delayed</span><span class="p">(</span><span class="n">run_subapp</span><span class="p">)(</span><span class="n">parameter_set</span><span class="p">)</span> <span class="k">for</span> <span class="n">parameter_set</span> <span class="ow">in</span> <span cla [...]
     <span class="n">joined</span> <span class="o">=</span> <span class="n">_join</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
 
     <span class="c1"># do something with the context and tracker</span>
diff --git a/content/docs/concepts/s3-tracking-aws/index.html b/content/docs/concepts/s3-tracking-aws/index.html
index 7798e2c8..aba27a52 100644
--- a/content/docs/concepts/s3-tracking-aws/index.html
+++ b/content/docs/concepts/s3-tracking-aws/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">S3 Tracking on AWS (Concepts)</a></li>
@@ -416,11 +417,11 @@ s=d.getElementsByTagName('script')[0];
 <p>This guide explains how Burr tracking works with S3-backed storage, and how to
 choose between local, hybrid, and production deployment modes.</p>
 <p>Use the S3 client in your app:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;burr[tracking-client-s3]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"burr[tracking-client-s3]"</span>
 </pre></div>
 </div>
 <p>and run the S3-backed tracking server/UI:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;burr[tracking-server-s3,cli]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"burr[tracking-server-s3,cli]"</span>
 </pre></div>
 </div>
 <section id="deployment-models">
@@ -507,9 +508,9 @@ infrastructure:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.tracking.s3client</span><span class="w"> </span><span class="kn">import</span> <span class="n">S3TrackingClient</span>
 
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">S3TrackingClient</span><span class="p">(</span>
-    <span class="n">project</span><span class="o">=</span><span class="s2">&quot;my_project&quot;</span><span class="p">,</span>
-    <span class="n">bucket</span><span class="o">=</span><span class="s2">&quot;my-burr-tracking-bucket&quot;</span><span class="p">,</span>
-    <span class="n">region</span><span class="o">=</span><span class="s2">&quot;us-east-1&quot;</span><span class="p">,</span>
+    <span class="n">project</span><span class="o">=</span><span class="s2">"my_project"</span><span class="p">,</span>
+    <span class="n">bucket</span><span class="o">=</span><span class="s2">"my-burr-tracking-bucket"</span><span class="p">,</span>
+    <span class="n">region</span><span class="o">=</span><span class="s2">"us-east-1"</span><span class="p">,</span>
 <span class="p">)</span>
 </pre></div>
 </div>
diff --git a/content/docs/concepts/sdlc/index.html b/content/docs/concepts/sdlc/index.html
index 46876ea5..7c1c7e1c 100644
--- a/content/docs/concepts/sdlc/index.html
+++ b/content/docs/concepts/sdlc/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/concepts/serde/index.html b/content/docs/concepts/serde/index.html
index 28d596ec..5c65c8a3 100644
--- a/content/docs/concepts/serde/index.html
+++ b/content/docs/concepts/serde/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -442,35 +443,35 @@ here is that you have some custom class/type you want to serialize/deserialize.<
 
 <span class="nd">@serde</span><span class="o">.</span><span class="n">serialize</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">MY_CLASS</span><span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">serialize_myclass</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="bp">cls</span><span class="p">,</span> <span class="n">myclass_kwargs</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</s [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Serializes the value using my custom methodology.</span>
+<span class="w">    </span><span class="sd">"""Serializes the value using my custom methodology.</span>
 
 <span class="sd">    :param value: the value to serialize.</span>
 <span class="sd">    :param myclass_kwargs: not required. Optional.</span>
 <span class="sd">    :param kwargs:</span>
 <span class="sd">    :return: dictionary of serde.KEY and value</span>
-<span class="sd">    &quot;&quot;&quot;</span>
+<span class="sd">    """</span>
     <span class="k">if</span> <span class="n">myclass_kwargs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
         <span class="n">myclass_kwargs</span> <span class="o">=</span> <span class="p">{}</span>
     <span class="k">return</span> <span class="p">{</span>
         <span class="c1"># required to identify how to deserialize</span>
-        <span class="n">serde</span><span class="o">.</span><span class="n">KEY</span><span class="p">:</span> <span class="s2">&quot;myclass&quot;</span><span class="p">,</span>
+        <span class="n">serde</span><span class="o">.</span><span class="n">KEY</span><span class="p">:</span> <span class="s2">"myclass"</span><span class="p">,</span>
         <span class="c1"># delegate to your custom serialization</span>
-        <span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">some_custom_serialization</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="o">**</span><span class="n">myclass_kwargs</span><span class="p">),</span>
+        <span class="s2">"value"</span><span class="p">:</span> <span class="n">some_custom_serialization</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="o">**</span><span class="n">myclass_kwargs</span><span class="p">),</span>
     <span class="p">}</span>
 
-<span class="nd">@serde</span><span class="o">.</span><span class="n">deserializer</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;myclass&quot;</span><span class="p">)</span>
+<span class="nd">@serde</span><span class="o">.</span><span class="n">deserializer</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">"myclass"</span><span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">deserialize_myclass</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">myclass_kwargs</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt; [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Deserializes the value using my custom methodology.</span>
+<span class="w">    </span><span class="sd">"""Deserializes the value using my custom methodology.</span>
 
 <span class="sd">    :param value: the value to deserialize from.</span>
 <span class="sd">    :param myclass_kwargs: not required. Optional.</span>
 <span class="sd">    :param kwargs:</span>
 <span class="sd">    :return: object of type cls</span>
-<span class="sd">    &quot;&quot;&quot;</span>
+<span class="sd">    """</span>
     <span class="k">if</span> <span class="n">myclass_kwargs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
         <span class="n">myclass_kwargs</span> <span class="o">=</span> <span class="p">{}</span>
     <span class="c1"># delegate to your custom deserialization</span>
-    <span class="k">return</span> <span class="n">some_custom_deserialization</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">&quot;value&quot;</span><span class="p">],</span> <span class="o">**</span><span class="n">myclass_kwargs</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">some_custom_deserialization</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">"value"</span><span class="p">],</span> <span class="o">**</span><span class="n">myclass_kwargs</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>You’ll need to this code to run/be imported so it can register itself.</p>
@@ -487,13 +488,13 @@ type based serialization/deserialization mechanism.</p>
 
 <span class="k">def</span><span class="w"> </span><span class="nf">my_field_serializer</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="n">MyType</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
     <span class="n">serde_value</span> <span class="o">=</span> <span class="n">_do_something_to_serialize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">serde_value</span><span class="p">}</span>
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="n">serde_value</span><span class="p">}</span>
 
 <span class="k">def</span><span class="w"> </span><span class="nf">my_field_deserializer</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">MyType</span><span class="p">:</span>
-    <span class="n">serde_value</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="s2">&quot;value&quot;</span><span class="p">]</span>
+    <span class="n">serde_value</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="s2">"value"</span><span class="p">]</span>
     <span class="k">return</span> <span class="n">_do_something_to_deserialize</span><span class="p">(</span><span class="n">serde_value</span><span class="p">)</span>
 
-<span class="n">state</span><span class="o">.</span><span class="n">register_field_serde</span><span class="p">(</span><span class="s2">&quot;my_field&quot;</span><span class="p">,</span> <span class="n">my_field_serializer</span><span class="p">,</span> <span class="n">my_field_deserializer</span><span class="p">)</span>
+<span class="n">state</span><span class="o">.</span><span class="n">register_field_serde</span><span class="p">(</span><span class="s2">"my_field"</span><span class="p">,</span> <span class="n">my_field_serializer</span><span class="p">,</span> <span class="n">my_field_deserializer</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>This will register a custom serializer/deserializer for the field “my_field”.</p>
diff --git a/content/docs/concepts/state-machine/index.html b/content/docs/concepts/state-machine/index.html
index cabdf0ca..5bf1b842 100644
--- a/content/docs/concepts/state-machine/index.html
+++ b/content/docs/concepts/state-machine/index.html
@@ -22,7 +22,7 @@
   <head><meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Transitions" href="../transitions/"><link rel="prev" title="State" href="../state/">
+<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Human in the Loop" href="../human-in-the-loop/"><link rel="prev" title="State" href="../state/">
         <link rel="canonical" href="https://burr.apache.org/docs/concepts/state-machine/">
         <link rel="prefetch" href="../../_static/burr_logo.svg" as="image">
 
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -431,10 +432,10 @@ Here is the minimum that is required:</p>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -454,15 +455,16 @@ Here is the minimum that is required:</p>
 </div>
 <p>Step can also take in <code class="docutils literal notranslate"><span class="pre">inputs</span></code> as a dictionary, which will be passed to the action’s run function as keyword arguments.
 This is specifically meant for a “human in the loop” scenario, where the action needs to ask for input from a user. In this case,
-the control flow is meant to be interrupted to allow for the user to provide input. See <a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a> for more information.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">step</span><span class="p">(</span><span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</ [...]
+the control flow is meant to be interrupted to allow for the user to provide input. See <a class="reference internal" href="../actions/#inputref"><span class="std std-ref">inputs</span></a> and
+<a class="reference internal" href="../human-in-the-loop/#id1"><span class="std std-ref">human in the loop</span></a> for more information.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">step</span><span class="p">(</span><span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <spa [...]
 </pre></div>
 </div>
 </section>
 <section id="iterate-aiterate">
 <h3><code class="docutils literal notranslate"><span class="pre">iterate</span></code>/<code class="docutils literal notranslate"><span class="pre">aiterate</span></code><a class="headerlink" href="#iterate-aiterate" title="Link to this heading">¶</a></h3>
 <p>Iterate just runs <code class="docutils literal notranslate"><span class="pre">step</span></code> in a row, functioning as a generator:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">application</span><span class="o">.</span><span class="n">iterate</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;fi [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">application</span><span class="o">.</span><span class="n">iterate</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"final_a [...]
     <span class="nb">print</span><span class="p">(</span><span class="n">action</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">result</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -501,13 +503,13 @@ no more transitions to take. This, however, is not a supported feature (and will
 and return control back. <code class="docutils literal notranslate"><span class="pre">halt_after</span></code> will stop after the specified action(s) has run, and <code class="docutils literal notranslate"><span class="pre">halt_before</span></code> will stop before the specified action(s) has run.
 If multiple are specified, it will stop after the first one encountered, and the return values will be for that action.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;final_action_1&quot;</span><span class="p">,</span> <span class="s2">&quot;final_action_2&quot;</span><span class="p">]</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"final_action_1"</span><span class="p">,</span> <span class="s2">"final_action_2"</span><span class="p">]</span>
 <span class="p">)</span>
 </pre></div>
 </div>
 <p>In the async context, you can run <code class="docutils literal notranslate"><span class="pre">arun</span></code>:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">arun</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;final_action_1&quot;</span><span class="p">,</span> <span class="s2">&quot;final_action_2&quot;</span><span class="p">]</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"final_action_1"</span><span class="p">,</span> <span class="s2">"final_action_2"</span><span class="p">]</span>
 <span class="p">)</span>
 </pre></div>
 </div>
@@ -533,15 +535,15 @@ in a web-server (create a graph once, application many times), import the graph
     <span class="n">GraphBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">graph</span><span class="p">)</span>
     <span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -564,12 +566,12 @@ in a web-server (create a graph once, application many times), import the graph
       <footer>
         
         <div class="related-pages">
-          <a class="next-page" href="../transitions/">
+          <a class="next-page" href="../human-in-the-loop/">
               <div class="page-info">
                 <div class="context">
                   <span>Next</span>
                 </div>
-                <div class="title">Transitions</div>
+                <div class="title">Human in the Loop</div>
               </div>
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
             </a>
diff --git a/content/docs/concepts/state-persistence/index.html b/content/docs/concepts/state-persistence/index.html
index f1c82b2f..4da7a2ce 100644
--- a/content/docs/concepts/state-persistence/index.html
+++ b/content/docs/concepts/state-persistence/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -502,24 +503,24 @@ video on how they use this feature:</p>
 <section id="an-example">
 <h3>An example<a class="headerlink" href="#an-example" title="Link to this heading">¶</a></h3>
 <p>To make the above more concrete, let’s look at a basic chatbot:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state_persister</span> <span class="o">=</span>  <span class="n">SQLLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;.sqllite.db&quot;</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;< [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state_persister</span> <span class="o">=</span>  <span class="n">SQLLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">".sqllite.db"</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span><span class="p [...]
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="p">,</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">state_persister</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
-        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span> <span class="p">:</span> <span class="p">[]},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_converse&quot;</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span> <span class="p">:</span> <span class="p">[]},</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_converse"</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_state_persister</span><span class="p">(</span><span class="n">state_persister</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">)</span>
@@ -550,8 +551,8 @@ synchronous persisters, the connection gets closed when the object is deleted. F
 persisters this is not possible. Therefore, we suggest that you either use the persister as a context
 manager</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">with</span> <span class="n">SQLLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span>
-        <span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;.sqllite.db&quot;</span><span class="p">,</span>
-        <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;</span>
+        <span class="n">db_path</span><span class="o">=</span><span class="s2">".sqllite.db"</span><span class="p">,</span>
+        <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span>
         <span class="p">)</span> <span class="k">as</span> <span class="n">state_persister</span><span class="p">:</span>
 
     <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
@@ -570,7 +571,7 @@ manager</p>
 </pre></div>
 </div>
 <p>or manually close the connection to the database, by using the <cite>.cleanup()</cite> method of the persister</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state_persister</span> <span class="o">=</span> <span class="n">SQLLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;.sqllite.db&quot;</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;</ [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state_persister</span> <span class="o">=</span> <span class="n">SQLLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">".sqllite.db"</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span><span class="p" [...]
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
@@ -610,18 +611,18 @@ tracked runs. This is useful for debugging, or building an application that enab
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="p">,</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
-        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span> <span class="p">:</span> <span class="p">[]},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_converse&quot;</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span> <span class="p">:</span> <span class="p">[]},</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_converse"</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">tracker</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">)</span>
diff --git a/content/docs/concepts/state-typing/index.html b/content/docs/concepts/state-typing/index.html
index c2a66a74..d6a6ee1b 100644
--- a/content/docs/concepts/state-typing/index.html
+++ b/content/docs/concepts/state-typing/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -440,7 +441,7 @@ This takes in a <code class="xref py py-class docutils literal notranslate"><spa
 <span class="k">class</span><span class="w"> </span><span class="nc">ApplicationState</span><span class="p">(</span><span class="n">pydantic</span><span class="o">.</span><span class="n">BaseModel</span><span class="p">):</span>
     <span class="n">chat_history</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="n">pydantic</span><span class="o">.</span><span class="n">Field</span><span class="p">(</span><span class="n">default_factory</span><span class="o">=</span><span class="nb">list</spa [...]
     <span class="n">prompt</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="n">mode</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;text&quot;</span><span class="p">,</span> <span class="s2">&quot;image&quot;</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
+    <span class="n">mode</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Literal</span><span class="p">[</span><span class="s2">"text"</span><span class="p">,</span> <span class="s2">"image"</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="n">response</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
 </pre></div>
 </div>
@@ -473,14 +474,14 @@ integration in your IDE (E.G. pylance), it will know that the state of your appl
 <p>You can also define type computations on on the action-level:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span>
 
-<span class="nd">@action</span><span class="o">.</span><span class="n">pydantic</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
-<span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">ApplicationState</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;dall-e-2&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ApplicationState</span><span class="p">:</span>
+<span class="nd">@action</span><span class="o">.</span><span class="n">pydantic</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">ApplicationState</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"dall-e-2"</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ApplicationState</span><span class="p">:</span>
     <span class="n">client</span> <span class="o">=</span> <span class="n">_get_openai_client</span><span class="p">()</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">images</span><span class="o">.</span><span class="n">generate</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="o">.</span><span class="n">prompt</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="s2">&quot;1024x1024&quot;</span><span class="p">,</span> <span class="n">quality</span><span class="o">=</span><span class="s2">&quot;standard&quot;</span>< [...]
+        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="o">.</span><span class="n">prompt</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="s2">"1024x1024"</span><span class="p">,</span> <span class="n">quality</span><span class="o">=</span><span class="s2">"standard"</span><span class="p">,</sp [...]
     <span class="p">)</span>
     <span class="n">response</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">url</span>
-    <span class="n">state</span><span class="o">.</span><span class="n">response</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">response</span><span class="p">,</span> <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="o">.</span><span class="n">mode</span><span class="p">],</span> <span cla [...]
+    <span class="n">state</span><span class="o">.</span><span class="n">response</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"content"</span><span class="p">:</span> <span class="n">response</span><span class="p">,</span> <span class="s2">"type"</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="o">.</span><span class="n">mode</span><span class="p">],</span> <span class="s2">"role"</span [...]
     <span class="k">return</span> <span class="n">state</span>
 </pre></div>
 </div>
diff --git a/content/docs/concepts/state/index.html b/content/docs/concepts/state/index.html
index da8e76af..8d422ac8 100644
--- a/content/docs/concepts/state/index.html
+++ b/content/docs/concepts/state/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -421,11 +422,11 @@ Burr has a <code class="docutils literal notranslate"><span class="pre">State</s
 <p>The <a class="reference internal" href="../../reference/state/#burr.core.state.State" title="burr.core.state.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a> class provides the ability to manipulate state for a given action. It is entirely immutable,
 meaning that you can only create new states from old ones, not modify them in place.</p>
 <p>State manipulation is done through calling methods on the <code class="docutils literal notranslate"><span class="pre">State</span></code> class. The most common write are:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="n">bar</span><span class="p">)</span>  <span class="c1"># update the state with the key &quot;foo&quot; set to &quot;bar&quot;</span>
-<span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="n">bar</span><span class="p">)</span>  <span class="c1"># append &quot;bar&quot; to the list at &quot;foo&quot;</span>
-<span class="n">state</span><span class="o">.</span><span class="n">increment</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>  <span class="c1"># increment the value at &quot;foo&quot; by 1</span>
-<span class="n">state</span><span class="o">.</span><span class="n">wipe</span><span class="p">(</span><span class="n">keep</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;foo&quot;</span><span class="p">,</span> <span class="s2">&quot;bar&quot;</span><span class="p">])</span>  <span class="c1"># remove all keys except &quot;foo&quot; and &quot;bar&quot;</span>
-<span class="n">state</span><span class="o">.</span><span class="n">wipe</span><span class="p">(</span><span class="n">delete</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;foo&quot;</span><span class="p">,</span> <span class="s2">&quot;bar&quot;</span><span class="p">])</span>  <span class="c1"># remove &quot;foo&quot; and &quot;bar&quot; from the state</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="n">bar</span><span class="p">)</span>  <span class="c1"># update the state with the key "foo" set to "bar"</span>
+<span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="n">bar</span><span class="p">)</span>  <span class="c1"># append "bar" to the list at "foo"</span>
+<span class="n">state</span><span class="o">.</span><span class="n">increment</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>  <span class="c1"># increment the value at "foo" by 1</span>
+<span class="n">state</span><span class="o">.</span><span class="n">wipe</span><span class="p">(</span><span class="n">keep</span><span class="o">=</span><span class="p">[</span><span class="s2">"foo"</span><span class="p">,</span> <span class="s2">"bar"</span><span class="p">])</span>  <span class="c1"># remove all keys except "foo" and "bar"</span>
+<span class="n">state</span><span class="o">.</span><span class="n">wipe</span><span class="p">(</span><span class="n">delete</span><span class="o">=</span><span class="p">[</span><span class="s2">"foo"</span><span class="p">,</span> <span class="s2">"bar"</span><span class="p">])</span>  <span class="c1"># remove "foo" and "bar" from the state</span>
 </pre></div>
 </div>
 <div class="admonition warning">
@@ -439,7 +440,7 @@ Any modifications to them outside of the framework is considered undefined behav
 </div>
 <p>The read operations extend from those in the <a class="reference external" href="https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping">Mapping</a>
 interface, but there are a few extra:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span><span class="o">.</span><span class="n">subset</span><span class="p">([</span><span class="s2">&quot;foo&quot;</span><span class="p">,</span> <span class="s2">&quot;bar&quot;</span><span class="p">])</span>  <span class="c1"># return a new state with only the keys &quot;foo&quot; and &quot;bar&quot;</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span><span class="o">.</span><span class="n">subset</span><span class="p">([</span><span class="s2">"foo"</span><span class="p">,</span> <span class="s2">"bar"</span><span class="p">])</span>  <span class="c1"># return a new state with only the keys "foo" and "bar"</span>
 <span class="n">state</span><span class="o">.</span><span class="n">get_all</span><span class="p">()</span>  <span class="c1"># return a dictionary with every key/value of the state</span>
 </pre></div>
 </div>
diff --git a/content/docs/concepts/streaming-actions/index.html b/content/docs/concepts/streaming-actions/index.html
index a3778479..adef1e0b 100644
--- a/content/docs/concepts/streaming-actions/index.html
+++ b/content/docs/concepts/streaming-actions/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -438,14 +439,14 @@ we yield a tuple of the result and the state update. The state update is <code c
 the final state for the final result.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.action</span><span class="w"> </span><span class="kn">import</span> <span class="n">streaming_action</span>
 
-<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">streaming_chat_call</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</sp [...]
     <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
     <span class="n">response</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-            <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-            <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+            <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+            <span class="s1">'content'</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
         <span class="p">}],</span>
         <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
         <span class="n">stream</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
@@ -454,9 +455,9 @@ the final state for the final result.</p>
     <span class="k">for</span> <span class="n">chunk</span> <span class="ow">in</span> <span class="n">response</span><span class="p">:</span>
         <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># No state update on intermediate results</span>
-    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span> <span class="c1"># Update state on final results</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># No state update on intermediate results</span>
+    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span> <span class="c1"># Update state on final results</span>
 </pre></div>
 </div>
 <p>A class-based streaming action might look like this:</p>
@@ -466,10 +467,10 @@ the final state for the final result.</p>
     <span class="k">def</span><span class="w"> </span><span class="nf">stream_run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span>  [...]
         <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
         <span class="n">response</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-            <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+            <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
             <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-                <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-                <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+                <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+                <span class="s1">'content'</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
             <span class="p">}],</span>
             <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
             <span class="n">stream</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
@@ -478,20 +479,20 @@ the final state for the final result.</p>
         <span class="k">for</span> <span class="n">chunk</span> <span class="ow">in</span> <span class="n">response</span><span class="p">:</span>
             <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
             <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
-            <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">}</span>
-        <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">}</span>
+            <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">}</span>
+        <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"response"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 </pre></div>
 </div>
 <p>The logic is split between <code class="docutils literal notranslate"><span class="pre">stream_run</span></code>, which is responsible for generating the intermediate results and
@@ -503,14 +504,14 @@ that it only yields the <code class="docutils literal notranslate"><span class="
 <details class="summary-code-fn-based-async-code">
 <summary>&lt;code&gt;fn_based_async&lt;/code&gt;</summary><div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.action</span><span class="w"> </span><span class="kn">import</span> <span class="n">streaming_action</span>
 
-<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
 <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">streaming_chat_call</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">AsyncGenerator</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="nb [...]
     <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">()</span>
     <span class="n">response</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-            <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-            <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+            <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+            <span class="s1">'content'</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
         <span class="p">}],</span>
         <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
         <span class="n">stream</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
@@ -519,9 +520,9 @@ that it only yields the <code class="docutils literal notranslate"><span class="
     <span class="k">async</span> <span class="k">for</span> <span class="n">chunk</span> <span class="ow">in</span> <span class="n">response</span><span class="p">:</span> <span class="c1"># loop over in async</span>
         <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># No state update on intermediate results</span>
-    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span> <span class="c1"># Update state on final results</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># No state update on intermediate results</span>
+    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span> <span class="c1"># Update state on final results</span>
 </pre></div>
 </div>
 </details><p>The class-based async streaming action will look like this:</p>
@@ -532,10 +533,10 @@ that it only yields the <code class="docutils literal notranslate"><span class="
     <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">stream_run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">AsyncGenerator</span><span class="p">[</span><span class="nb">di [...]
         <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
         <span class="n">response</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-            <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+            <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
             <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-                <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-                <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+                <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+                <span class="s1">'content'</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
             <span class="p">}],</span>
             <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
             <span class="n">stream</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
@@ -544,20 +545,20 @@ that it only yields the <code class="docutils literal notranslate"><span class="
         <span class="k">async</span> <span class="k">for</span> <span class="n">chunk</span> <span class="ow">in</span> <span class="n">response</span><span class="p">:</span>
             <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
             <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
-            <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">}</span>
-        <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">}</span>
+            <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">}</span>
+        <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"response"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 </pre></div>
 </div>
 </details></section>
@@ -569,7 +570,7 @@ a <a class="reference internal" href="../../reference/actions/#burr.core.action.
 object.</p>
 <p>This object is effectively a cached iterator. You can use it as follows:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
 <span class="p">)</span>
 <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
     <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="c1"># one by one</span>
@@ -579,7 +580,7 @@ object.</p>
 </pre></div>
 </div>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">async_streaming_result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
 <span class="p">)</span>
 <span class="k">async</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">async_streaming_result</span><span class="p">:</span>
     <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="c1"># one by one</span>
diff --git a/content/docs/concepts/sync-vs-async/index.html b/content/docs/concepts/sync-vs-async/index.html
index 87986c87..2a8544bd 100644
--- a/content/docs/concepts/sync-vs-async/index.html
+++ b/content/docs/concepts/sync-vs-async/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/concepts/tracking/index.html b/content/docs/concepts/tracking/index.html
index c8da4658..becb3696 100644
--- a/content/docs/concepts/tracking/index.html
+++ b/content/docs/concepts/tracking/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../transitions/">Transitions</a></li>
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -461,9 +462,9 @@ useful for debugging, because you can quickly recreate the issue by running the
 
 <span class="n">prior_app_id</span> <span class="o">=</span> <span class="o">...</span> <span class="c1"># some value</span>
 <span class="n">sequence_id</span> <span class="o">=</span> <span class="o">...</span> <span class="c1"># None or some prior step</span>
-<span class="n">partition_key</span> <span class="o">=</span> <span class="s2">&quot;SOME_VALUE&quot;</span> <span class="c1"># use None if not using a partition key</span>
+<span class="n">partition_key</span> <span class="o">=</span> <span class="s2">"SOME_VALUE"</span> <span class="c1"># use None if not using a partition key</span>
 
-<span class="n">project_name</span> <span class="o">=</span> <span class="s2">&quot;PROJECT_NAME&quot;</span>
+<span class="n">project_name</span> <span class="o">=</span> <span class="s2">"PROJECT_NAME"</span>
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project_name</span><span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
@@ -472,7 +473,7 @@ useful for debugging, because you can quickly recreate the issue by running the
         <span class="n">tracker</span><span class="p">,</span> <span class="c1"># local tracker above</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
         <span class="n">default_state</span><span class="o">=</span><span class="p">{},</span> <span class="c1"># your default state</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;SOME_DEFAULT&quot;</span><span class="p">,</span> <span class="c1"># your default entry point</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"SOME_DEFAULT"</span><span class="p">,</span> <span class="c1"># your default entry point</span>
         <span class="n">fork_from_app_id</span><span class="o">=</span><span class="n">prior_app_id</span><span class="p">,</span>
         <span class="n">fork_from_sequence_id</span><span class="o">=</span><span class="n">sequence_id</span><span class="p">,</span>
         <span class="n">fork_from_partition_key</span><span class="o">=</span><span class="n">partition_key</span>
@@ -500,7 +501,7 @@ This will print the URL to access the Burr UI web app.</p>
 <span class="o">%</span><span class="n">load_ext</span> <span class="n">burr</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">notebook</span>
 <span class="o">%</span><span class="n">burr_ui</span>
 
-<span class="s2">&quot;Burr UI: http://127.0.0.1:7241&quot;</span>
+<span class="s2">"Burr UI: http://127.0.0.1:7241"</span>
 </pre></div>
 </div>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># But you need to expose the port to the browser:</span>
@@ -522,7 +523,7 @@ This will print the URL to access the Burr UI web app.</p>
 <span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">()</span>
 
 <span class="c1"># Mount Burr UI under /burr</span>
-<span class="n">mount_burr_ui</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="s2">&quot;/burr&quot;</span><span class="p">)</span>
+<span class="n">mount_burr_ui</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="s2">"/burr"</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>This allows you to run the Burr tracking UI alongside your own FastAPI
diff --git a/content/docs/concepts/transitions/index.html b/content/docs/concepts/transitions/index.html
index 24352684..26faf179 100644
--- a/content/docs/concepts/transitions/index.html
+++ b/content/docs/concepts/transitions/index.html
@@ -22,7 +22,7 @@
   <head><meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Tracking Burr" href="../tracking/"><link rel="prev" title="Applications" href="../state-machine/">
+<link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="Tracking Burr" href="../tracking/"><link rel="prev" title="Human in the Loop" href="../human-in-the-loop/">
         <link rel="canonical" href="https://burr.apache.org/docs/concepts/transitions/">
         <link rel="prefetch" href="../../_static/burr_logo.svg" as="image">
 
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -430,25 +431,25 @@ You can think of them as edges in a graph.</p>
 <p>Conditions have a few APIs, but the most common are the three convenience functions:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">when</span><span class="p">,</span> <span class="n">expr</span><span class="p">,</span> <span class="n">default</span>
 <span class="n">with_transitions</span><span class="p">(</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">),</span>  <span class="c1"># will evaluate when the state has the variable &quot;foo&quot; set to the value &quot;bar&quot;</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s1">&#39;epochs&gt;100&#39;</span><span class="p">))</span> <span class="c1"># will evaluate to True when epochs is greater than 100</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>  <span class="c1"># will always evaluate to True</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">)</span> <span class="c1"># leaving out a third conditions we allow defaults</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">),</span>  <span class="c1"># will evaluate when the state has the variable "foo" set to the value "bar"</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s1">'epochs&gt;100'</span><span class="p">))</span> <span class="c1"># will evaluate to True when epochs is greater than 100</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>  <span class="c1"># will always evaluate to True</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">)</span> <span class="c1"># leaving out a third conditions we allow defaults</span>
 <span class="p">)</span>
 </pre></div>
 </div>
 <p><code class="docutils literal notranslate"><span class="pre">when()</span></code> also supports comparison operators via Django-style <code class="docutils literal notranslate"><span class="pre">__</span></code> suffixes:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">when</span>
 <span class="n">with_transitions</span><span class="p">(</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;adult&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">)),</span>       <span class="c1"># age &gt;= 18</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;child&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">age__lt</span><span class="o">=</span><span class="mi">18</span><span class="p">)),</span>         <span class="c1"># age &lt; 18</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;valid&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">score__gt</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">score__lte</span><span class="o">=</span><span class="mi">100</span><span class="p">)),</span>  <span class="c1"># 0 &lt; score &lt;= 100</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;active&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__in</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;active&quot;</span><span class="p">,</span> <span class="s2">&quot;pending&quot;</span><span class="p">])),</span>  <span class="c1"># membership</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;tagged&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">tags__contains</span><span class="o">=</span><span class="s2">&quot;python&quot;</span><span class="p">)),</span>  <span class="c1"># collection contains value</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;clean&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__notin</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;banned&quot;</span><span class="p">,</span> <span class="s2">&quot;suspended&quot;</span><span class="p">])),</span>  <span class="c1"># not in</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;changed&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__ne</span><span class="o">=</span><span class="s2">&quot;initial&quot;</span><span class="p">)),</span>  <span class="c1"># not equal</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;missing&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">value__is</span><span class="o">=</span><span class="kc">None</span><span class="p">)),</span>  <span class="c1"># identity check</span>
-    <span class="p">(</span><span class="s2">&quot;check&quot;</span><span class="p">,</span> <span class="s2">&quot;present&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">value__isnot</span><span class="o">=</span><span class="kc">None</span><span class="p">)),</span>  <span class="c1"># not-identity check</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"adult"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">)),</span>       <span class="c1"># age &gt;= 18</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"child"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">age__lt</span><span class="o">=</span><span class="mi">18</span><span class="p">)),</span>         <span class="c1"># age &lt; 18</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"valid"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">score__gt</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">score__lte</span><span class="o">=</span><span class="mi">100</span><span class="p">)),</span>  <span class="c1"># 0 &lt; score &lt;= 100</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"active"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__in</span><span class="o">=</span><span class="p">[</span><span class="s2">"active"</span><span class="p">,</span> <span class="s2">"pending"</span><span class="p">])),</span>  <span class="c1"># membership</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"tagged"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">tags__contains</span><span class="o">=</span><span class="s2">"python"</span><span class="p">)),</span>  <span class="c1"># collection contains value</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"clean"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__notin</span><span class="o">=</span><span class="p">[</span><span class="s2">"banned"</span><span class="p">,</span> <span class="s2">"suspended"</span><span class="p">])),</span>  <span class="c1"># not in</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"changed"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">status__ne</span><span class="o">=</span><span class="s2">"initial"</span><span class="p">)),</span>  <span class="c1"># not equal</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"missing"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">value__is</span><span class="o">=</span><span class="kc">None</span><span class="p">)),</span>  <span class="c1"># identity check</span>
+    <span class="p">(</span><span class="s2">"check"</span><span class="p">,</span> <span class="s2">"present"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">value__isnot</span><span class="o">=</span><span class="kc">None</span><span class="p">)),</span>  <span class="c1"># not-identity check</span>
 <span class="p">)</span>
 </pre></div>
 </div>
@@ -473,8 +474,8 @@ when determining which action to run next. If no condition evaluates to <code cl
 <p>The <code class="docutils literal notranslate"><span class="pre">~</span></code> operator will invert a condition. For instance:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">when</span><span class="p">,</span> <span class="n">expr</span>
 <span class="n">with_transitions</span><span class="p">(</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">,</span> <span class="o">~</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;baz&quot;</span><span class="p">),</span>  <span class="c1"># will evaluate to True when foo != baz</span>
-    <span class="p">(</span><span class="s2">&quot;from&quot;</span><span class="p">,</span> <span class="s2">&quot;to&quot;</span><span class="p">,</span> <span class="o">~</span><span class="n">expr</span><span class="p">(</span><span class="s1">&#39;epochs&lt;=100&#39;</span><span class="p">))</span> <span class="c1"># will evaluate to True when epochs hits 101</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">,</span> <span class="o">~</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"baz"</span><span class="p">),</span>  <span class="c1"># will evaluate to True when foo != baz</span>
+    <span class="p">(</span><span class="s2">"from"</span><span class="p">,</span> <span class="s2">"to"</span><span class="p">,</span> <span class="o">~</span><span class="n">expr</span><span class="p">(</span><span class="s1">'epochs&lt;=100'</span><span class="p">))</span> <span class="c1"># will evaluate to True when epochs hits 101</span>
 <span class="p">)</span>
 </pre></div>
 </div>
@@ -503,14 +504,14 @@ default condition will be used.</p>
               </div>
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
             </a>
-          <a class="prev-page" href="../state-machine/">
+          <a class="prev-page" href="../human-in-the-loop/">
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
               <div class="page-info">
                 <div class="context">
                   <span>Previous</span>
                 </div>
                 
-                <div class="title">Applications</div>
+                <div class="title">Human in the Loop</div>
                 
               </div>
             </a>
diff --git a/content/docs/contributing/architecture/index.html b/content/docs/contributing/architecture/index.html
index 8f11be61..26bea253 100644
--- a/content/docs/contributing/architecture/index.html
+++ b/content/docs/contributing/architecture/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/contributing/contributing/index.html b/content/docs/contributing/contributing/index.html
index c3ac5154..a63d163f 100644
--- a/content/docs/contributing/contributing/index.html
+++ b/content/docs/contributing/contributing/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/contributing/index.html b/content/docs/contributing/index.html
index 8e053a09..94bd8242 100644
--- a/content/docs/contributing/index.html
+++ b/content/docs/contributing/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/contributing/iterating/index.html b/content/docs/contributing/iterating/index.html
index fe059c03..f6b13a9e 100644
--- a/content/docs/contributing/iterating/index.html
+++ b/content/docs/contributing/iterating/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/contributing/setup/index.html b/content/docs/contributing/setup/index.html
index 8d8d20b9..599bfd1a 100644
--- a/content/docs/contributing/setup/index.html
+++ b/content/docs/contributing/setup/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -427,7 +428,7 @@ Replace with your package manager of choice if you prefer.</p>
 <p>Next you’ll want to <code class="docutils literal notranslate"><span class="pre">cd</span></code> into the directory and install
 <code class="docutils literal notranslate"><span class="pre">burr</span></code> in developer mode:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span><span class="w"> </span>burr
-pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span><span class="s2">&quot;.[developer]&quot;</span>
+pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span><span class="s2">".[developer]"</span>
 </pre></div>
 </div>
 <p>You can also use dependency group:</p>
diff --git a/content/docs/ecosystem/index.html b/content/docs/ecosystem/index.html
index e9c5b4d9..fef5179e 100644
--- a/content/docs/ecosystem/index.html
+++ b/content/docs/ecosystem/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/agents/agent-patterns/index.html b/content/docs/examples/agents/agent-patterns/index.html
index 979aa95f..9661083d 100644
--- a/content/docs/examples/agents/agent-patterns/index.html
+++ b/content/docs/examples/agents/agent-patterns/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/agents/divide-and-conquer/index.html b/content/docs/examples/agents/divide-and-conquer/index.html
index e4fb391d..f2ec8952 100644
--- a/content/docs/examples/agents/divide-and-conquer/index.html
+++ b/content/docs/examples/agents/divide-and-conquer/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/agents/index.html b/content/docs/examples/agents/index.html
index 001c6da7..66b838c8 100644
--- a/content/docs/examples/agents/index.html
+++ b/content/docs/examples/agents/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/chatbots/basic-chatbot/index.html b/content/docs/examples/chatbots/basic-chatbot/index.html
index 88b0ee1d..a6df00fd 100644
--- a/content/docs/examples/chatbots/basic-chatbot/index.html
+++ b/content/docs/examples/chatbots/basic-chatbot/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -460,42 +461,42 @@ s=d.getElementsByTagName('script')[0];
 <p>While this is just a pass-through to OpenAI (and is thus a little pointless) – its a start. We’ll be adding more later.</p>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">human_input</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span cla [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Pulls human input from the outside world and massages it into a standard chat format.</span>
-<span class="sd">    Note we&#39;re adding it into the chat history (with an `append` operation). This </span>
+<span class="w">    </span><span class="sd">"""Pulls human input from the outside world and massages it into a standard chat format.</span>
+<span class="sd">    Note we're adding it into the chat history (with an `append` operation). This </span>
 <span class="sd">    is just for convenience of reference -- we could easily just store the chat history</span>
 <span class="sd">    and access it.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
+<span class="sd">    """</span>
     
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span>
     <span class="p">}</span>
     <span class="c1"># return the prompt as the result</span>
     <span class="c1"># put the prompt in state and update the chat_history</span>
     <span class="k">return</span> <span class="p">(</span>
-        <span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">},</span> 
+        <span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">},</span> 
         <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
     <span class="p">)</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">ai_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Queries OpenAI with the chat. You could easily use langchain, etc... to handle this,</span>
-<span class="sd">    but we wanted to keep it simple to demonstrate&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""Queries OpenAI with the chat. You could easily use langchain, etc... to handle this,</span>
+<span class="sd">    but we wanted to keep it simple to demonstrate"""</span>
     <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>  <span class="c1"># replace with your favorite LLM client library</span>
     <span class="n">content</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-3.5-turbo&quot;</span><span class="p">,</span>
-        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+        <span class="n">model</span><span class="o">=</span><span class="s2">"gpt-3.5-turbo"</span><span class="p">,</span>
+        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span>
     <span class="p">)</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">message</span><span class="o">.</span><span class="n">content</span>
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;assistant&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span>
     <span class="p">}</span>
     <span class="c1"># return the response as the result</span>
     <span class="c1"># put the response in state and update the chat history</span>
     <span class="k">return</span> <span class="p">(</span>
-        <span class="p">{</span><span class="s2">&quot;response&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">},</span>     
+        <span class="p">{</span><span class="s2">"response"</span><span class="p">:</span> <span class="n">content</span><span class="p">},</span>     
         <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">content</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
     <span class="p">)</span>
 </pre></div>
@@ -515,13 +516,13 @@ will pause (move from the application to the caller) after every <code class="do
         <span class="n">human_input</span><span class="o">=</span><span class="n">human_input</span><span class="p">,</span>
         <span class="n">ai_response</span><span class="o">=</span><span class="n">ai_response</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">&quot;digraph_initial&quot;</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">&quot;png&quot;</span><span class="p">)</span>
+<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">"digraph_initial"</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">"png"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -534,10 +535,10 @@ It returns the action it ran, the result it got, and the state. We use te state
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">final_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> 
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span> <span class="p">:</span> <span class="s2">&quot;Who was Aaron Burr?&quot;</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">],</span> 
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span> <span class="p">:</span> <span class="s2">"Who was Aaron Burr?"</span><span class="p">}</span>
 <span class="p">)</span>
-<span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
@@ -550,22 +551,22 @@ We’re going to add one step that checks for safety, and another that drafts a
 <p>Then, we’re going to add a “conditional” transition, allowing us to respond differently depending on the value of <code class="docutils literal notranslate"><span class="pre">safe</span></code>.</p>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;safe&quot;</span><span class="p">])</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"safe"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">safety_check</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-    <span class="n">safe</span> <span class="o">=</span> <span class="s2">&quot;unsafe&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span>
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;safe&quot;</span><span class="p">:</span> <span class="n">safe</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="n">safe</span><span class="p">)</span>
+    <span class="n">safe</span> <span class="o">=</span> <span class="s2">"unsafe"</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span>
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"safe"</span><span class="p">:</span> <span class="n">safe</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="n">safe</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">unsafe_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-    <span class="n">content</span> <span class="o">=</span> <span class="s2">&quot;I&#39;m sorry, my overlords have forbidden me to respond.&quot;</span>
+    <span class="n">content</span> <span class="o">=</span> <span class="s2">"I'm sorry, my overlords have forbidden me to respond."</span>
     <span class="n">new_state</span> <span class="o">=</span> <span class="p">(</span>
         <span class="n">state</span>
         <span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">content</span><span class="p">)</span>
         <span class="o">.</span><span class="n">append</span><span class="p">(</span>
-            <span class="n">chat_history</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span> <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;assistant&quot;</span><span class="p">})</span>
+            <span class="n">chat_history</span><span class="o">=</span><span class="p">{</span><span class="s2">"content"</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span> <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span><span class="p">})</span>
     <span class="p">)</span>
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;response&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">},</span> <span class="n">new_state</span>
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"response"</span><span class="p">:</span> <span class="n">content</span><span class="p">},</span> <span class="n">new_state</span>
 </pre></div>
 </div>
 </div>
@@ -579,15 +580,15 @@ We’re going to add one step that checks for safety, and another that drafts a
         <span class="n">safety_check</span><span class="o">=</span><span class="n">safety_check</span><span class="p">,</span>
         <span class="n">unsafe_response</span><span class="o">=</span><span class="n">unsafe_response</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;safety_check&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
-        <span class="p">([</span><span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> <span class="s2">&quot;human_input&quot;</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"safety_check"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
+        <span class="p">([</span><span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">],</span> <span class="s2">"human_input"</span><span class="p">),</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
-<span class="n">safe_app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">&quot;digraph_safe&quot;</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="n">safe_app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">"digraph_safe"</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -595,10 +596,10 @@ We’re going to add one step that checks for safety, and another that drafts a
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">safe_app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">],</span> 
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="s2">&quot;Who was Aaron Burr, sir (unsafe)?&quot;</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">],</span> 
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="s2">"Who was Aaron Burr, sir (unsafe)?"</span><span class="p">}</span>
 <span class="p">)</span>
-<span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
@@ -616,14 +617,14 @@ We’re going to add one step that checks for safety, and another that drafts a
         <span class="n">safety_check</span><span class="o">=</span><span class="n">safety_check</span><span class="p">,</span>
         <span class="n">unsafe_response</span><span class="o">=</span><span class="n">unsafe_response</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;safety_check&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
-        <span class="p">([</span><span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> <span class="s2">&quot;human_input&quot;</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"safety_check"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
+        <span class="p">([</span><span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">],</span> <span class="s2">"human_input"</span><span class="p">),</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span>
-        <span class="s2">&quot;local&quot;</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">&quot;demo_getting_started&quot;</span>
+        <span class="s2">"local"</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">"demo_getting_started"</span>
     <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -640,16 +641,16 @@ We’re going to add one step that checks for safety, and another that drafts a
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-    <span class="s2">&quot;Who was Aaron Burr, sir?&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;Who was Aaron Burr, sir (unsafe)?&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;If you had ml/ai libraries called &#39;Hamilton&#39; and &#39;Burr&#39;, what would they do?&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;Who was Aaron Burr, sir?&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;Who was Aaron Burr, sir (unsafe)?&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;If you had ml/ai libraries called &#39;Hamilton&#39; and &#39;Burr&#39;, what would they do?&quot;</span><span class="p">,</span>
+    <span class="s2">"Who was Aaron Burr, sir?"</span><span class="p">,</span>
+    <span class="s2">"Who was Aaron Burr, sir (unsafe)?"</span><span class="p">,</span>
+    <span class="s2">"If you had ml/ai libraries called 'Hamilton' and 'Burr', what would they do?"</span><span class="p">,</span>
+    <span class="s2">"Who was Aaron Burr, sir?"</span><span class="p">,</span>
+    <span class="s2">"Who was Aaron Burr, sir (unsafe)?"</span><span class="p">,</span>
+    <span class="s2">"If you had ml/ai libraries called 'Hamilton' and 'Burr', what would they do?"</span><span class="p">,</span>
 <span class="p">]:</span>
     <span class="n">action_we_ran</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app_with_tracker</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">],</span> 
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">],</span> 
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">}</span>
     <span class="p">)</span>
 </pre></div>
 </div>
@@ -663,7 +664,7 @@ We’re going to add one step that checks for safety, and another that drafts a
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">IPython.display</span><span class="w"> </span><span class="kn">import</span> <span class="n">Markdown</span>
-<span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;[Link to UI](http://localhost:7241/project/demo_getting_started/</span><span class="si">{</span><span class="n">app_with_tracker</span><span class="o">.</span><span class="n">uid</span><span class="si">}</span><span class="s2">)&quot;</span>
+<span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"[Link to UI](http://localhost:7241/project/demo_getting_started/</span><span class="si">{</span><span class="n">app_with_tracker</span><span class="o">.</span><span class="n">uid</span><span class="si">}</span><span class="s2">)"</span>
 <span class="n">Markdown</span><span class="p">(</span><span class="n">url</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -677,8 +678,8 @@ We’re going to add one step that checks for safety, and another that drafts a
 <span class="n">get_ipython</span><span class="p">()</span><span class="o">.</span><span class="n">system</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">system</span>
 <span class="o">!</span>burr<span class="w"> </span>--no-open<span class="w"> </span>&gt;<span class="w"> </span>/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
 <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="c1"># quick trick to wait for the server to start</span>
-<span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;http://localhost:7241/project/demo_getting_started/</span><span class="si">{</span><span class="n">app_with_tracker</span><span class="o">.</span><span class="n">uid</span><span class="si">}</span><span class="s2">&quot;</span>
-<span class="n">iframe</span> <span class="o">=</span> <span class="sa">f</span><span class="s1">&#39;&lt;iframe src=&quot;</span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s1">&quot; width=&quot;100%&quot; height=&quot;1000px&quot;&gt;&lt;/iframe&gt;&#39;</span>
+<span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"http://localhost:7241/project/demo_getting_started/</span><span class="si">{</span><span class="n">app_with_tracker</span><span class="o">.</span><span class="n">uid</span><span class="si">}</span><span class="s2">"</span>
+<span class="n">iframe</span> <span class="o">=</span> <span class="sa">f</span><span class="s1">'&lt;iframe src="</span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s1">" width="100%" height="1000px"&gt;&lt;/iframe&gt;'</span>
 <span class="n">display</span><span class="p">(</span><span class="n">HTML</span><span class="p">(</span><span class="n">iframe</span><span class="p">))</span>
 </pre></div>
 </div>
@@ -697,17 +698,17 @@ We’re going to add one step that checks for safety, and another that drafts a
 <p>More about persistence <a class="reference external" href="https://burr.apache.org/concepts/state-persistence/">here</a>.</p>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;unique_app_id_</span><span class="si">{</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="si">}</span><span class="s2">&quot;</span> <span class="c1"># unique app ID -- we create it here but this will be generated for you</span>
-<span class="n">partition_key</span> <span class="o">=</span> <span class="s2">&quot;new_burr_user&quot;</span> <span class="c1"># this can be anything. In a chatbot it will </span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"unique_app_id_</span><span class="si">{</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="si">}</span><span class="s2">"</span> <span class="c1"># unique app ID -- we create it here but this will be generated for you</span>
+<span class="n">partition_key</span> <span class="o">=</span> <span class="s2">"new_burr_user"</span> <span class="c1"># this can be anything. In a chatbot it will </span>
 </pre></div>
 </div>
 </div>
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># we&#39;re going to be creating this multiple times to demonstrate so let&#39;s stick it in a function</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># we're going to be creating this multiple times to demonstrate so let's stick it in a function</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">create_persistable_app</span><span class="p">():</span>
-    <span class="n">sqllite_persister</span> <span class="o">=</span> <span class="n">persistence</span><span class="o">.</span><span class="n">SQLLitePersister</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;./sqlite.db&quot;</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;</span><span class="p">)</span>
+    <span class="n">sqllite_persister</span> <span class="o">=</span> <span class="n">persistence</span><span class="o">.</span><span class="n">SQLLitePersister</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">"./sqlite.db"</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span><span class="p">)</span>
     <span class="n">sqllite_persister</span><span class="o">.</span><span class="n">initialize</span><span class="p">()</span>
     <span class="k">return</span> <span class="p">(</span>
         <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
@@ -716,19 +717,19 @@ We’re going to add one step that checks for safety, and another that drafts a
             <span class="n">safety_check</span><span class="o">=</span><span class="n">safety_check</span><span class="p">,</span>
             <span class="n">unsafe_response</span><span class="o">=</span><span class="n">unsafe_response</span>
         <span class="p">)</span><span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-            <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;safety_check&quot;</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
-            <span class="p">(</span><span class="s2">&quot;safety_check&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
-            <span class="p">([</span><span class="s2">&quot;unsafe_response&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> <span class="s2">&quot;human_input&quot;</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"safety_check"</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">False</span><span class="p">)),</span>
+            <span class="p">(</span><span class="s2">"safety_check"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">safe</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
+            <span class="p">([</span><span class="s2">"unsafe_response"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">],</span> <span class="s2">"human_input"</span><span class="p">),</span>
         <span class="p">)</span><span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
             <span class="n">initializer</span><span class="o">=</span><span class="n">sqllite_persister</span><span class="p">,</span>
             <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
-            <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="p">[]},</span>
-            <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_input&quot;</span>
+            <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span><span class="p">:</span> <span class="p">[]},</span>
+            <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_input"</span>
         <span class="p">)</span><span class="o">.</span><span class="n">with_state_persister</span><span class="p">(</span><span class="n">sqllite_persister</span><span class="p">)</span>
         <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="n">partition_key</span><span class="p">)</span>
         <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span>
-            <span class="s2">&quot;local&quot;</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">&quot;demo_getting_started&quot;</span>
+            <span class="s2">"local"</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">"demo_getting_started"</span>
         <span class="p">)</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
     <span class="p">)</span>
 </pre></div>
@@ -739,11 +740,11 @@ We’re going to add one step that checks for safety, and another that drafts a
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_initial</span> <span class="o">=</span> <span class="n">create_persistable_app</span><span class="p">()</span>
 <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app_initial</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">],</span> 
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="s2">&quot;Who was Aaron Burr, sir?&quot;</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">],</span> 
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="s2">"Who was Aaron Burr, sir?"</span><span class="p">}</span>
 <span class="p">)</span>
-<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s1">&#39;chat_history&#39;</span><span class="p">]:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">item</span><span class="p">[</span><span class="s1">&#39;role&#39;</span><span class="p">]</span> <span class="o">+</span> <span class="s1">&#39;:&#39;</span> <span class="o">+</span> <span class="n">item</span><span class="p">[</span><span class="s1">&#39;content&#39;</span><span class="p">]</span> <span class="o">+</span> <span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span cla [...]
+<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s1">'chat_history'</span><span class="p">]:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">item</span><span class="p">[</span><span class="s1">'role'</span><span class="p">]</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span> <span class="n">item</span><span class="p">[</span><span class="s1">'content'</span><span class="p">]</span> <span class="o">+</span> <span class="s1">'</span><span class="se">\n</span><span class="s1">'</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -754,11 +755,11 @@ We’re going to add one step that checks for safety, and another that drafts a
 <span class="n">app_reloaded</span> <span class="o">=</span> <span class="n">create_persistable_app</span><span class="p">()</span>
 
 <span class="n">action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app_reloaded</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;unsafe_response&quot;</span><span class="p">],</span> 
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="s2">&quot;Who was Alexander Hamilton?&quot;</span><span class="p">}</span>
+    <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"unsafe_response"</span><span class="p">],</span> 
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="s2">"Who was Alexander Hamilton?"</span><span class="p">}</span>
 <span class="p">)</span>
-<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s1">&#39;chat_history&#39;</span><span class="p">]:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">item</span><span class="p">[</span><span class="s1">&#39;role&#39;</span><span class="p">]</span> <span class="o">+</span> <span class="s1">&#39;:&#39;</span> <span class="o">+</span> <span class="n">item</span><span class="p">[</span><span class="s1">&#39;content&#39;</span><span class="p">]</span> <span class="o">+</span> <span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span cla [...]
+<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s1">'chat_history'</span><span class="p">]:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">item</span><span class="p">[</span><span class="s1">'role'</span><span class="p">]</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span> <span class="n">item</span><span class="p">[</span><span class="s1">'content'</span><span class="p">]</span> <span class="o">+</span> <span class="s1">'</span><span class="se">\n</span><span class="s1">'</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
diff --git a/content/docs/examples/chatbots/gpt-like-chatbot/index.html b/content/docs/examples/chatbots/gpt-like-chatbot/index.html
index b27c7b88..a66a8b65 100644
--- a/content/docs/examples/chatbots/gpt-like-chatbot/index.html
+++ b/content/docs/examples/chatbots/gpt-like-chatbot/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -482,72 +483,72 @@ s=d.getElementsByTagName('script')[0];
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.tracking</span><span class="w"> </span><span class="kn">import</span> <span class="n">LocalTrackingClient</span>
 
 <span class="n">MODES</span> <span class="o">=</span> <span class="p">{</span>
-    <span class="s2">&quot;answer_question&quot;</span><span class="p">:</span> <span class="s2">&quot;text&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;generate_image&quot;</span><span class="p">:</span> <span class="s2">&quot;image&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;generate_code&quot;</span><span class="p">:</span> <span class="s2">&quot;code&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;unknown&quot;</span><span class="p">:</span> <span class="s2">&quot;text&quot;</span><span class="p">,</span>
+    <span class="s2">"answer_question"</span><span class="p">:</span> <span class="s2">"text"</span><span class="p">,</span>
+    <span class="s2">"generate_image"</span><span class="p">:</span> <span class="s2">"image"</span><span class="p">,</span>
+    <span class="s2">"generate_code"</span><span class="p">:</span> <span class="s2">"code"</span><span class="p">,</span>
+    <span class="s2">"unknown"</span><span class="p">:</span> <span class="s2">"text"</span><span class="p">,</span>
 <span class="p">}</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">,</span> <span class="s2">"prompt"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">process_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;chat_item&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span><span class="p">,</span> <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span> <span class="s2">&quot;type&quot;</span><span class="p">:</span [...]
-    <span class="n">state</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;chat_item&quot;</span><span class="p">])</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"chat_item"</span><span class="p">:</span> <span class="p">{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span> <span class="s2">"type"</span><span class="p">:</span> <span class="s2">"text"</span><span class="p">}}</span>
+    <span class="n">state</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"chat_item"</span><span class="p">])</span>
     <span class="n">state</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">state</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;mode&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"mode"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">choose_mode</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">prompt</span> <span class="o">=</span> <span class="p">(</span>
-        <span class="sa">f</span><span class="s2">&quot;You are a chatbot. You&#39;ve been prompted this: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">. &quot;</span>
-        <span class="sa">f</span><span class="s2">&quot;You have the capability of responding in the following modes: </span><span class="si">{</span><span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">MODES</span><span class="p">)</span><span class="si">}</span><span class="s2">. &quot;</span>
-        <span class="s2">&quot;Please respond with *only* a single word representing the mode that most accurately &quot;</span>
-        <span class="s2">&quot;corresponds to the prompt. Fr instance, if the prompt is &#39;draw a picture of a cat&#39;, &quot;</span>
-        <span class="s2">&quot;the mode would be &#39;generate_image&#39;. If the prompt is &quot;</span>
-        <span class="s2">&quot;&#39;what is the capital of France&#39;, the mode would be &#39;answer_question&#39;.&quot;</span>
-        <span class="s2">&quot;If none of these modes apply, please respond with &#39;unknown&#39;.&quot;</span>
+        <span class="sa">f</span><span class="s2">"You are a chatbot. You've been prompted this: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">]</span><span class="si">}</span><span class="s2">. "</span>
+        <span class="sa">f</span><span class="s2">"You have the capability of responding in the following modes: </span><span class="si">{</span><span class="s1">', '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">MODES</span><span class="p">)</span><span class="si">}</span><span class="s2">. "</span>
+        <span class="s2">"Please respond with *only* a single word representing the mode that most accurately "</span>
+        <span class="s2">"corresponds to the prompt. Fr instance, if the prompt is 'draw a picture of a cat', "</span>
+        <span class="s2">"the mode would be 'generate_image'. If the prompt is "</span>
+        <span class="s2">"'what is the capital of France', the mode would be 'answer_question'."</span>
+        <span class="s2">"If none of these modes apply, please respond with 'unknown'."</span>
     <span class="p">)</span>
 
     <span class="n">llm_result</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[</span>
-            <span class="p">{</span><span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;system&quot;</span><span class="p">,</span> <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="s2">&quot;You are a helpful assistant&quot;</span><span class="p">},</span>
-            <span class="p">{</span><span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span><span class="p">,</span> <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">},</span>
+            <span class="p">{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"system"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="s2">"You are a helpful assistant"</span><span class="p">},</span>
+            <span class="p">{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">},</span>
         <span class="p">],</span>
     <span class="p">)</span>
     <span class="n">content</span> <span class="o">=</span> <span class="n">llm_result</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">message</span><span class="o">.</span><span class="n">content</span>
     <span class="n">mode</span> <span class="o">=</span> <span class="n">content</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
     <span class="k">if</span> <span class="n">mode</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">MODES</span><span class="p">:</span>
-        <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;unknown&quot;</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;mode&quot;</span><span class="p">:</span> <span class="n">mode</span><span class="p">}</span>
+        <span class="n">mode</span> <span class="o">=</span> <span class="s2">"unknown"</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"mode"</span><span class="p">:</span> <span class="n">mode</span><span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">prompt_for_more</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">result</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;response&quot;</span><span class="p">:</span> <span class="p">{</span>
-            <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="s2">&quot;None of the response modes I support apply to your question. &quot;</span>
-                       <span class="s2">&quot;Please clarify?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;text&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
+        <span class="s2">"response"</span><span class="p">:</span> <span class="p">{</span>
+            <span class="s2">"content"</span><span class="p">:</span> <span class="s2">"None of the response modes I support apply to your question. "</span>
+                       <span class="s2">"Please clarify?"</span><span class="p">,</span>
+            <span class="s2">"type"</span><span class="p">:</span> <span class="s2">"text"</span><span class="p">,</span>
+            <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span><span class="p">,</span>
         <span class="p">}</span>
     <span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">,</span> <span class="s2">&quot;mode&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">chat_response</span><span class="p">(</span>
-        <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prepend_prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;gpt-3.5-turbo&quot;</span>
+        <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prepend_prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"gpt-3.5-turbo"</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     
-    <span class="n">chat_history</span> <span class="o">=</span> <span class="n">copy</span><span class="o">.</span><span class="n">deepcopy</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
-    <span class="n">chat_history</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="s2">&quot;content&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">prepend_prompt</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">chat_history</span><span class="p">[</span><span clas [...]
+    <span class="n">chat_history</span> <span class="o">=</span> <span class="n">copy</span><span class="o">.</span><span class="n">deepcopy</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">])</span>
+    <span class="n">chat_history</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="s2">"content"</span><span class="p">]</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">prepend_prompt</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">chat_history</span><span class="p">[</span><span class="o">-</span>< [...]
     <span class="n">chat_history_api_format</span> <span class="o">=</span> <span class="p">[</span>
         <span class="p">{</span>
-            <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="n">chat</span><span class="p">[</span><span class="s2">&quot;role&quot;</span><span class="p">],</span>
-            <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">chat</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">],</span>
+            <span class="s2">"role"</span><span class="p">:</span> <span class="n">chat</span><span class="p">[</span><span class="s2">"role"</span><span class="p">],</span>
+            <span class="s2">"content"</span><span class="p">:</span> <span class="n">chat</span><span class="p">[</span><span class="s2">"content"</span><span class="p">],</span>
         <span class="p">}</span>
         <span class="k">for</span> <span class="n">chat</span> <span class="ow">in</span> <span class="n">chat_history</span>
     <span class="p">]</span>
@@ -557,28 +558,28 @@ s=d.getElementsByTagName('script')[0];
         <span class="n">messages</span><span class="o">=</span><span class="n">chat_history_api_format</span><span class="p">,</span>
     <span class="p">)</span>
     <span class="n">text_response</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">message</span><span class="o">.</span><span class="n">content</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;response&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">text_response</span><span class="p">,</span> <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="p">[</span><span class="s2">& [...]
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"response"</span><span class="p">:</span> <span class="p">{</span><span class="s2">"content"</span><span class="p">:</span> <span class="n">text_response</span><span class="p">,</span> <span class="s2">"type"</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="p">[</span><span class="s2">"mode"</span><span class="p">]] [...]
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">,</span> <span class="s2">&quot;mode&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
-<span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;dall-e-2&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Generates an image response to the prompt. Optional save function to save the image to a URL.&quot;&quot;&quot;</span>
-    <span class="c1"># raise ValueError(&quot;Demo error&quot;)</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"dall-e-2"</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">"""Generates an image response to the prompt. Optional save function to save the image to a URL."""</span>
+    <span class="c1"># raise ValueError("Demo error")</span>
     <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">images</span><span class="o">.</span><span class="n">generate</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">size</span><span class="o">=</span><span class="s2">&quot;1024x1024&quot;</span><span class="p">,</span> <span class="n">quality</span><span class="o">=</span><span class="s2">&quot;standard [...]
+        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">size</span><span class="o">=</span><span class="s2">"1024x1024"</span><span class="p">,</span> <span class="n">quality</span><span class="o">=</span><span class="s2">"standard"</span><span class="p">, [...]
     <span class="p">)</span>
     <span class="n">image_url</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">url</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;response&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">image_url</span><span class="p">,</span> <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot [...]
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"response"</span><span class="p">:</span> <span class="p">{</span><span class="s2">"content"</span><span class="p">:</span> <span class="n">image_url</span><span class="p">,</span> <span class="s2">"type"</span><span class="p">:</span> <span class="n">MODES</span><span class="p">[</span><span class="n">state</span><span class="p">[</span><span class="s2">"mode"</span><span class="p">]],</s [...]
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;mode&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="c1"># you&#39;d do something specific here based on prior state</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;chat_item&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">]}</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;chat_item&quot;</span><span class="p">])</span>
+    <span class="c1"># you'd do something specific here based on prior state</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"chat_item"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"response"</span><span class="p">]}</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"chat_item"</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
@@ -589,31 +590,31 @@ s=d.getElementsByTagName('script')[0];
 <span class="n">base_graph</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">graph</span><span class="o">.</span><span class="n">GraphBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
-        <span class="c1"># these are the &quot;nodes&quot; </span>
+        <span class="c1"># these are the "nodes" </span>
         <span class="n">prompt</span><span class="o">=</span><span class="n">process_prompt</span><span class="p">,</span>
         <span class="n">decide_mode</span><span class="o">=</span><span class="n">choose_mode</span><span class="p">,</span>
         <span class="n">generate_image</span><span class="o">=</span><span class="n">image_response</span><span class="p">,</span>
         <span class="n">generate_code</span><span class="o">=</span><span class="n">chat_response</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span>
-            <span class="n">prepend_prompt</span><span class="o">=</span><span class="s2">&quot;Please respond with *only* code and no other text (at all) to the following:&quot;</span><span class="p">,</span>
+            <span class="n">prepend_prompt</span><span class="o">=</span><span class="s2">"Please respond with *only* code and no other text (at all) to the following:"</span><span class="p">,</span>
         <span class="p">),</span>
         <span class="n">answer_question</span><span class="o">=</span><span class="n">chat_response</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span>
-            <span class="n">prepend_prompt</span><span class="o">=</span><span class="s2">&quot;Please answer the following question:&quot;</span><span class="p">,</span>
+            <span class="n">prepend_prompt</span><span class="o">=</span><span class="s2">"Please answer the following question:"</span><span class="p">,</span>
         <span class="p">),</span>
         <span class="n">prompt_for_more</span><span class="o">=</span><span class="n">prompt_for_more</span><span class="p">,</span>
         <span class="n">response</span><span class="o">=</span><span class="n">response</span><span class="p">,</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
         <span class="c1"># these are the edges between nodes, based on state.</span>
-        <span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;decide_mode&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;decide_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;generate_image&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">&quot;generate_image&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;decide_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;generate_code&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">&quot;generate_code&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;decide_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;answer_question&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">&quot;answer_question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;decide_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt_for_more&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"decide_mode"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"decide_mode"</span><span class="p">,</span> <span class="s2">"generate_image"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">"generate_image"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"decide_mode"</span><span class="p">,</span> <span class="s2">"generate_code"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">"generate_code"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"decide_mode"</span><span class="p">,</span> <span class="s2">"answer_question"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="s2">"answer_question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"decide_mode"</span><span class="p">,</span> <span class="s2">"prompt_for_more"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
         <span class="p">(</span>
-            <span class="p">[</span><span class="s2">&quot;generate_image&quot;</span><span class="p">,</span> <span class="s2">&quot;answer_question&quot;</span><span class="p">,</span> <span class="s2">&quot;generate_code&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt_for_more&quot;</span><span class="p">],</span>
-            <span class="s2">&quot;response&quot;</span><span class="p">,</span>
+            <span class="p">[</span><span class="s2">"generate_image"</span><span class="p">,</span> <span class="s2">"answer_question"</span><span class="p">,</span> <span class="s2">"generate_code"</span><span class="p">,</span> <span class="s2">"prompt_for_more"</span><span class="p">],</span>
+            <span class="s2">"response"</span><span class="p">,</span>
         <span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"prompt"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
@@ -630,15 +631,15 @@ s=d.getElementsByTagName('script')[0];
 <h2>2. Build application –&gt; built in checkpointing &amp; tracking<a class="headerlink" href="#build-application-built-in-checkpointing-tracking" title="Link to this heading">¶</a></h2>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">&quot;agent-demo&quot;</span><span class="p">)</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">"agent-demo"</span><span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">base_graph</span><span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">tracker</span><span class="p">,</span> 
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> 
-        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="p">[]},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span><span class="p">:</span> <span class="p">[]},</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"prompt"</span><span class="p">,</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">tracker</span><span class="p">)</span>  <span class="c1"># tracking + checkpointing; one line 🪄.</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
@@ -658,18 +659,18 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Hi, how can I help?&quot;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="s2">&quot;quit&quot;</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
+    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Hi, how can I help?"</span><span class="p">)</span>
+    <span class="k">if</span> <span class="s2">"quit"</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
         <span class="k">break</span>
     <span class="n">last_action</span><span class="p">,</span> <span class="n">action_result</span><span class="p">,</span> <span class="n">app_state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">],</span> 
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">],</span> 
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
     <span class="p">)</span>
-    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;image&#39;</span><span class="p">:</span>
-        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]))</span>
+    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">==</span> <span class="s1">'image'</span><span class="p">:</span>
+        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">"content"</span><span class="p">]))</span>
     <span class="k">else</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;content&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">'content'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -686,7 +687,7 @@ s=d.getElementsByTagName('script')[0];
 <div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>🤖: ```
 public class HelloWorld {
     public static void main(String[] args) {
-        System.out.println(&quot;Hello, World!&quot;);
+        System.out.println("Hello, World!");
     }
 }
 ```
@@ -702,38 +703,38 @@ Join our discord and ask for help! https://discord.gg/4FxBMyzW5n
 -------------------------------------------------------------------
 &gt; Action: `generate_image` encountered an error!&lt;
 &gt; State (at time of action):
-{&#39;__PRIOR_STEP&#39;: &#39;decide_mode&#39;,
- &#39;__SEQUENCE_ID&#39;: 10,
- &#39;chat_history&#39;: &quot;[{&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;what is the capital ...&quot;,
- &#39;mode&#39;: &#39;generate_image&#39;,
- &#39;prompt&#39;: &#39;draw a pen&#39;,
- &#39;response&#39;: &quot;{&#39;content&#39;: &#39;```\\npublic class HelloWorld {\\n    p...&quot;}
+{'__PRIOR_STEP': 'decide_mode',
+ '__SEQUENCE_ID': 10,
+ 'chat_history': "[{'role': 'user', 'content': 'what is the capital ...",
+ 'mode': 'generate_image',
+ 'prompt': 'draw a pen',
+ 'response': "{'content': '```\\npublic class HelloWorld {\\n    p..."}
 &gt; Inputs (at time of action):
-{&#39;prompt&#39;: &#39;draw a pen&#39;}
+{'prompt': 'draw a pen'}
 ********************************************************************************
 Traceback (most recent call last):
-  File &quot;/Users/stefankrawczyk/dagworks/burr/burr/core/application.py&quot;, line 534, in _step
+  File "/Users/stefankrawczyk/dagworks/burr/burr/core/application.py", line 534, in _step
     result, new_state = _run_single_step_action(
-  File &quot;/Users/stefankrawczyk/dagworks/burr/burr/core/application.py&quot;, line 233, in _run_single_step_action
+  File "/Users/stefankrawczyk/dagworks/burr/burr/core/application.py", line 233, in _run_single_step_action
     action.run_and_update(state, **inputs), action.name
-  File &quot;/Users/stefankrawczyk/dagworks/burr/burr/core/action.py&quot;, line 533, in run_and_update
+  File "/Users/stefankrawczyk/dagworks/burr/burr/core/action.py", line 533, in run_and_update
     return self._fn(state, **self._bound_params, **run_kwargs)
-  File &quot;/var/folders/gv/q39lb_1s26x7gbyyypqc3dkm0000gn/T/ipykernel_43564/1354917547.py&quot;, line 94, in image_response
-    raise ValueError(&quot;Demo error&quot;)
+  File "/var/folders/gv/q39lb_1s26x7gbyyypqc3dkm0000gn/T/ipykernel_43564/1354917547.py", line 94, in image_response
+    raise ValueError("Demo error")
 ValueError: Demo error
 </pre></div>
 </div>
 <div class="output traceback highlight-ipythontb notranslate"><div class="highlight"><pre><span></span><span class="gt">---------------------------------------------------------------------------</span>
 <span class="ne">ValueError</span><span class="g g-Whitespace">                                </span>Traceback (most recent call last)
 <span class="n">Cell</span> <span class="n">In</span><span class="p">[</span><span class="mi">12</span><span class="p">],</span> <span class="n">line</span> <span class="mi">5</span>
-<span class="g g-Whitespace">      </span><span class="mi">3</span> <span class="k">if</span> <span class="s2">&quot;quit&quot;</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
+<span class="g g-Whitespace">      </span><span class="mi">3</span> <span class="k">if</span> <span class="s2">"quit"</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
 <span class="g g-Whitespace">      </span><span class="mi">4</span>     <span class="k">break</span>
 <span class="ne">----&gt; </span><span class="mi">5</span> <span class="n">last_action</span><span class="p">,</span> <span class="n">action_result</span><span class="p">,</span> <span class="n">app_state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-<span class="g g-Whitespace">      </span><span class="mi">6</span>     <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">],</span> 
-<span class="g g-Whitespace">      </span><span class="mi">7</span>     <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
+<span class="g g-Whitespace">      </span><span class="mi">6</span>     <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">],</span> 
+<span class="g g-Whitespace">      </span><span class="mi">7</span>     <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
 <span class="g g-Whitespace">      </span><span class="mi">8</span> <span class="p">)</span>
-<span class="g g-Whitespace">      </span><span class="mi">9</span> <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-<span class="g g-Whitespace">     </span><span class="mi">10</span> <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;image&#39;</span><span class="p">:</span>
+<span class="g g-Whitespace">      </span><span class="mi">9</span> <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+<span class="g g-Whitespace">     </span><span class="mi">10</span> <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">==</span> <span class="s1">'image'</span><span class="p">:</span>
 
 <span class="nn">File ~/dagworks/burr/burr/telemetry.py:273,</span> in <span class="ni">capture_function_usage.&lt;locals&gt;.wrapped_fn</span><span class="nt">(*args, **kwargs)</span>
 <span class="g g-Whitespace">    </span><span class="mi">270</span> <span class="nd">@functools</span><span class="o">.</span><span class="n">wraps</span><span class="p">(</span><span class="n">call_fn</span><span class="p">)</span>
@@ -760,7 +761,7 @@ ValueError: Demo error
 
 <span class="nn">File ~/dagworks/burr/burr/core/application.py:495,</span> in <span class="ni">Application.step</span><span class="nt">(self, inputs)</span>
 <span class="g g-Whitespace">    </span><span class="mi">492</span> <span class="c1"># we need to increment the sequence before we start computing</span>
-<span class="g g-Whitespace">    </span><span class="mi">493</span> <span class="c1"># that way if we&#39;re replaying from state, we don&#39;t get stuck</span>
+<span class="g g-Whitespace">    </span><span class="mi">493</span> <span class="c1"># that way if we're replaying from state, we don't get stuck</span>
 <span class="g g-Whitespace">    </span><span class="mi">494</span> <span class="bp">self</span><span class="o">.</span><span class="n">_increment_sequence_id</span><span class="p">()</span>
 <span class="ne">--&gt; </span><span class="mi">495</span> <span class="n">out</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_step</span><span class="p">(</span><span class="n">inputs</span><span class="o">=</span><span class="n">inputs</span><span class="p">,</span> <span class="n">_run_hooks</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 <span class="g g-Whitespace">    </span><span class="mi">496</span> <span class="k">return</span> <span class="n">out</span>
@@ -797,13 +798,13 @@ ValueError: Demo error
 <span class="ne">--&gt; </span><span class="mi">533</span>     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fn</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_bound_params</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span>
 
 <span class="nn">Cell In[8], line 94,</span> in <span class="ni">image_response</span><span class="nt">(state, model)</span>
-<span class="g g-Whitespace">     </span><span class="mi">91</span> <span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">,</span> <span class="s2">&quot;mode&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span clas [...]
-<span class="g g-Whitespace">     </span><span class="mi">92</span> <span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;dall-e-2&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <s [...]
-<span class="g g-Whitespace">     </span><span class="mi">93</span><span class="w">     </span><span class="sd">&quot;&quot;&quot;Generates an image response to the prompt. Optional save function to save the image to a URL.&quot;&quot;&quot;</span>
-<span class="ne">---&gt; </span><span class="mi">94</span>     <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Demo error&quot;</span><span class="p">)</span>
+<span class="g g-Whitespace">     </span><span class="mi">91</span> <span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">,</span> <span class="s2">"mode"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span  [...]
+<span class="g g-Whitespace">     </span><span class="mi">92</span> <span class="k">def</span><span class="w"> </span><span class="nf">image_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"dall-e-2"</span><span class="p">)</span> <span class="o">-&gt;</span> <span class= [...]
+<span class="g g-Whitespace">     </span><span class="mi">93</span><span class="w">     </span><span class="sd">"""Generates an image response to the prompt. Optional save function to save the image to a URL."""</span>
+<span class="ne">---&gt; </span><span class="mi">94</span>     <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">"Demo error"</span><span class="p">)</span>
 <span class="g g-Whitespace">     </span><span class="mi">95</span>     <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
 <span class="g g-Whitespace">     </span><span class="mi">96</span>     <span class="n">result</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">images</span><span class="o">.</span><span class="n">generate</span><span class="p">(</span>
-<span class="g g-Whitespace">     </span><span class="mi">97</span>         <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">size</span><span class="o">=</span><span class="s2">&quot;1024x1024&quot;</span><span class="p">,</span> <span class="n">q [...]
+<span class="g g-Whitespace">     </span><span class="mi">97</span>         <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">size</span><span class="o">=</span><span class="s2">"1024x1024"</span><span class="p">,</span> <span class="n">quality</span><span c [...]
 <span class="g g-Whitespace">     </span><span class="mi">98</span>     <span class="p">)</span>
 
 <span class="ne">ValueError</span>: Demo error
@@ -821,7 +822,7 @@ ValueError: Demo error
 </ul>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="s2">&quot;a6d74912-9ad6-42f0-9a18-bc17c5e77eaf&quot;</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="s2">"a6d74912-9ad6-42f0-9a18-bc17c5e77eaf"</span>
 </pre></div>
 </div>
 </div>
@@ -834,8 +835,8 @@ ValueError: Demo error
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> 
-        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="p">[]},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span><span class="p">:</span> <span class="p">[]},</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"prompt"</span><span class="p">,</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">tracker</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">)</span>
@@ -847,20 +848,20 @@ ValueError: Demo error
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">resumed_app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">]</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">resumed_app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">]</span>
 </pre></div>
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>[{&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;what is the capital of France?&#39;, &#39;type&#39;: &#39;text&#39;},
- {&#39;content&#39;: &#39;The capital of France is Paris.&#39;,
-  &#39;type&#39;: &#39;text&#39;,
-  &#39;role&#39;: &#39;assistant&#39;},
- {&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;write hello world in java&#39;, &#39;type&#39;: &#39;text&#39;},
- {&#39;content&#39;: &#39;```\npublic class HelloWorld {\n    public static void main(String[] args) {\n        System.out.println(&quot;Hello, World!&quot;);\n    }\n}\n```&#39;,
-  &#39;type&#39;: &#39;code&#39;,
-  &#39;role&#39;: &#39;assistant&#39;},
- {&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;draw a pen&#39;, &#39;type&#39;: &#39;text&#39;}]
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>[{'role': 'user', 'content': 'what is the capital of France?', 'type': 'text'},
+ {'content': 'The capital of France is Paris.',
+  'type': 'text',
+  'role': 'assistant'},
+ {'role': 'user', 'content': 'write hello world in java', 'type': 'text'},
+ {'content': '```\npublic class HelloWorld {\n    public static void main(String[] args) {\n        System.out.println("Hello, World!");\n    }\n}\n```',
+  'type': 'code',
+  'role': 'assistant'},
+ {'role': 'user', 'content': 'draw a pen', 'type': 'text'}]
 </pre></div>
 </div>
 </div>
@@ -868,18 +869,18 @@ ValueError: Demo error
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Hi, how can I help?&quot;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="s2">&quot;quit&quot;</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
+    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Hi, how can I help?"</span><span class="p">)</span>
+    <span class="k">if</span> <span class="s2">"quit"</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
         <span class="k">break</span>
     <span class="n">last_action</span><span class="p">,</span> <span class="n">action_result</span><span class="p">,</span> <span class="n">app_state</span> <span class="o">=</span> <span class="n">resumed_app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">],</span> 
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">],</span> 
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
     <span class="p">)</span>
-    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;image&#39;</span><span class="p">:</span>
-        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]))</span>
+    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">==</span> <span class="s1">'image'</span><span class="p">:</span>
+        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">"content"</span><span class="p">]))</span>
     <span class="k">else</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;content&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">'content'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -906,9 +907,9 @@ ValueError: Demo error
 </ul>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="s2">&quot;a6d74912-9ad6-42f0-9a18-bc17c5e77eaf&quot;</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app_id</span> <span class="o">=</span> <span class="s2">"a6d74912-9ad6-42f0-9a18-bc17c5e77eaf"</span>
 <span class="n">sequence_id</span> <span class="o">=</span> <span class="mi">4</span>
-<span class="c1"># partition_key = &quot;&quot;</span>
+<span class="c1"># partition_key = ""</span>
 </pre></div>
 </div>
 </div>
@@ -921,8 +922,8 @@ ValueError: Demo error
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> 
-        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="p">[]},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="p">{</span><span class="s2">"chat_history"</span><span class="p">:</span> <span class="p">[]},</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"prompt"</span><span class="p">,</span>
         <span class="n">fork_from_app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">,</span>
         <span class="n">fork_from_sequence_id</span><span class="o">=</span><span class="n">sequence_id</span><span class="p">,</span>
         <span class="c1"># fork_from_partition_key=partition_key</span>
@@ -937,16 +938,16 @@ ValueError: Demo error
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># show prior forked state</span>
-<span class="n">forked_app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">]</span>
+<span class="n">forked_app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">]</span>
 </pre></div>
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>[{&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;what is the capital of France?&#39;, &#39;type&#39;: &#39;text&#39;},
- {&#39;content&#39;: &#39;The capital of France is Paris.&#39;,
-  &#39;type&#39;: &#39;text&#39;,
-  &#39;role&#39;: &#39;assistant&#39;},
- {&#39;role&#39;: &#39;user&#39;, &#39;content&#39;: &#39;write hello world in java&#39;, &#39;type&#39;: &#39;text&#39;}]
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>[{'role': 'user', 'content': 'what is the capital of France?', 'type': 'text'},
+ {'content': 'The capital of France is Paris.',
+  'type': 'text',
+  'role': 'assistant'},
+ {'role': 'user', 'content': 'write hello world in java', 'type': 'text'}]
 </pre></div>
 </div>
 </div>
@@ -954,18 +955,18 @@ ValueError: Demo error
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Hi, how can I help?&quot;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="s2">&quot;quit&quot;</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
+    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Hi, how can I help?"</span><span class="p">)</span>
+    <span class="k">if</span> <span class="s2">"quit"</span> <span class="o">==</span> <span class="n">user_input</span><span class="o">.</span><span class="n">lower</span><span class="p">():</span>
         <span class="k">break</span>
     <span class="n">last_action</span><span class="p">,</span> <span class="n">action_result</span><span class="p">,</span> <span class="n">app_state</span> <span class="o">=</span> <span class="n">forked_app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">],</span> 
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">],</span> 
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</span> <span class="n">user_input</span><span class="p">}</span>
     <span class="p">)</span>
-    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;image&#39;</span><span class="p">:</span>
-        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">&quot;content&quot;</span><span class="p">]))</span>
+    <span class="n">last_message</span> <span class="o">=</span> <span class="n">app_state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">last_message</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">==</span> <span class="s1">'image'</span><span class="p">:</span>
+        <span class="n">display</span><span class="p">(</span><span class="n">Image</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="n">last_message</span><span class="p">[</span><span class="s2">"content"</span><span class="p">]))</span>
     <span class="k">else</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">&#39;content&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"🤖: </span><span class="si">{</span><span class="n">last_message</span><span class="p">[</span><span class="s1">'content'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -976,7 +977,7 @@ ValueError: Demo error
 <div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>🤖: ```java
 public class HelloWorld {
     public static void main(String[] args) {
-        System.out.println(&quot;Hello, World!&quot;);
+        System.out.println("Hello, World!");
     }
 }
 ```
diff --git a/content/docs/examples/chatbots/index.html b/content/docs/examples/chatbots/index.html
index 73172bd2..dfe9222f 100644
--- a/content/docs/examples/chatbots/index.html
+++ b/content/docs/examples/chatbots/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/chatbots/rag-chatbot-hamilton/index.html b/content/docs/examples/chatbots/rag-chatbot-hamilton/index.html
index 8fcb0409..830cc467 100644
--- a/content/docs/examples/chatbots/rag-chatbot-hamilton/index.html
+++ b/content/docs/examples/chatbots/rag-chatbot-hamilton/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -465,7 +466,7 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Loads Hamilton DAG</span>
-<span class="n">conversational_rag</span> <span class="o">=</span> <span class="n">dataflows</span><span class="o">.</span><span class="n">import_module</span><span class="p">(</span><span class="s2">&quot;conversational_rag&quot;</span><span class="p">)</span>
+<span class="n">conversational_rag</span> <span class="o">=</span> <span class="n">dataflows</span><span class="o">.</span><span class="n">import_module</span><span class="p">(</span><span class="s2">"conversational_rag"</span><span class="p">)</span>
 <span class="n">conversational_rag_driver</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">driver</span><span class="o">.</span><span class="n">Builder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_config</span><span class="p">({})</span>  <span class="c1"># replace with configuration as appropriate</span>
@@ -484,34 +485,34 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span>
-    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"question"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span>
 <span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">ai_converse</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">vector_store</span><span class="p">:</span> <span class="nb">object</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span> [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;AI conversing step. Uses Hamilton to execute the conversational pipeline.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""AI conversing step. Uses Hamilton to execute the conversational pipeline."""</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">conversational_rag_driver</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span>
-        <span class="p">[</span><span class="s2">&quot;conversational_rag_response&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">"conversational_rag_response"</span><span class="p">],</span>
         <span class="n">inputs</span><span class="o">=</span><span class="p">{</span>
-            <span class="s2">&quot;question&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span class="p">],</span>
-            <span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+            <span class="s2">"question"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"question"</span><span class="p">],</span>
+            <span class="s2">"chat_history"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span>
         <span class="p">},</span>
         <span class="c1"># we use overrides here because we want to pass in the vector store</span>
         <span class="n">overrides</span><span class="o">=</span><span class="p">{</span>
-            <span class="s2">&quot;vector_store&quot;</span><span class="p">:</span> <span class="n">vector_store</span><span class="p">,</span>
+            <span class="s2">"vector_store"</span><span class="p">:</span> <span class="n">vector_store</span><span class="p">,</span>
         <span class="p">}</span>
     <span class="p">)</span>
-    <span class="n">new_history</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;AI: </span><span class="si">{</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;conversational_rag_response&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span>
+    <span class="n">new_history</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"AI: </span><span class="si">{</span><span class="n">result</span><span class="p">[</span><span class="s1">'conversational_rag_response'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span>
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">new_history</span><span class="p">)</span>
 
 
 <span class="nd">@action</span><span class="p">(</span>
     <span class="n">reads</span><span class="o">=</span><span class="p">[],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"question"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">],</span>
 <span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">human_converse</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">user_question</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Human converse step -- make sure we get input, and store it as state.&quot;&quot;&quot;</span>
-    <span class="n">state</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">question</span><span class="o">=</span><span class="n">user_question</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Human: </span><span class="si" [...]
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span> <span class="n">state</span>
+<span class="w">    </span><span class="sd">"""Human converse step -- make sure we get input, and store it as state."""</span>
+    <span class="n">state</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">question</span><span class="o">=</span><span class="n">user_question</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="sa">f</span><span class="s2">"Human: </span><span class="si">{</s [...]
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span> <span class="n">state</span>
 </pre></div>
 </div>
 </div>
@@ -525,19 +526,19 @@ s=d.getElementsByTagName('script')[0];
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.lifecycle</span><span class="w"> </span><span class="kn">import</span> <span class="n">PostRunStepHook</span><span class="p">,</span> <span class="n">PreRunStepHook</span>
 
 <span class="k">class</span><span class="w"> </span><span class="nc">PrintStepHook</span><span class="p">(</span><span class="n">PostRunStepHook</span><span class="p">,</span> <span class="n">PreRunStepHook</span><span class="p">):</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Custom hook to print the action/result after each step.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""Custom hook to print the action/result after each step."""</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">pre_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="n">Action</span><span class="p">,</span> <span class="o">**</span><span class="n">future_kwargs</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;🤔 AI is thinking...&quot;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;⏳Processing input from user...&quot;</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"ai_converse"</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">"🤔 AI is thinking..."</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"human_converse"</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">"⏳Processing input from user..."</span><span class="p">)</span>
 
-    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">&quot;State&quot;</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="n">Action</span><span class="p">,</span> <span class="n">result</span><span class="p">:</ [...]
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;🎙💬&quot;</span><span class="p">,</span> <span class="n">result</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span class="p">],</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;🤖💬&quot;</span><span class="p">,</span> <span class="n">result</span><span class="p">[</span><span class="s2">&quot;conversational_rag_response&quot;</span><span class="p">],</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">"State"</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="n">Action</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <spa [...]
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"human_converse"</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">"🎙💬"</span><span class="p">,</span> <span class="n">result</span><span class="p">[</span><span class="s2">"question"</span><span class="p">],</span> <span class="s2">"</span><span class="se">\n</span><span class="s2">"</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"ai_converse"</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">"🤖💬"</span><span class="p">,</span> <span class="n">result</span><span class="p">[</span><span class="s2">"conversational_rag_response"</span><span class="p">],</span> <span class="s2">"</span><span class="se">\n</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -551,23 +552,23 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># what we will do RAG over.</span>
 <span class="n">initial_documents</span> <span class="o">=</span> <span class="p">[</span>
-    <span class="s2">&quot;harrison worked at kensho&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;stefan worked at Stitch Fix&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;stefan likes tacos&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;elijah worked at TwoSigma&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;elijah likes mango&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;stefan used to work at IBM&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;elijah likes to go biking&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;stefan likes to bake sourdough&quot;</span><span class="p">,</span>
+    <span class="s2">"harrison worked at kensho"</span><span class="p">,</span>
+    <span class="s2">"stefan worked at Stitch Fix"</span><span class="p">,</span>
+    <span class="s2">"stefan likes tacos"</span><span class="p">,</span>
+    <span class="s2">"elijah worked at TwoSigma"</span><span class="p">,</span>
+    <span class="s2">"elijah likes mango"</span><span class="p">,</span>
+    <span class="s2">"stefan used to work at IBM"</span><span class="p">,</span>
+    <span class="s2">"elijah likes to go biking"</span><span class="p">,</span>
+    <span class="s2">"stefan likes to bake sourdough"</span><span class="p">,</span>
 <span class="p">]</span>
 <span class="c1"># bootstrap the vector store;</span>
 <span class="n">vector_store</span> <span class="o">=</span> <span class="n">conversational_rag_driver</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span>
-    <span class="p">[</span><span class="s2">&quot;vector_store&quot;</span><span class="p">],</span>
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;input_texts&quot;</span><span class="p">:</span> <span class="n">initial_documents</span><span class="p">})[</span><span class="s2">&quot;vector_store&quot;</span><span class="p">]</span>
+    <span class="p">[</span><span class="s2">"vector_store"</span><span class="p">],</span>
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"input_texts"</span><span class="p">:</span> <span class="n">initial_documents</span><span class="p">})[</span><span class="s2">"vector_store"</span><span class="p">]</span>
 <span class="c1"># what we will initialize the application with</span>
 <span class="n">initial_state</span> <span class="o">=</span> <span class="p">{</span>
-    <span class="s2">&quot;question&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;chat_history&quot;</span><span class="p">:</span> <span class="p">[],</span>
+    <span class="s2">"question"</span><span class="p">:</span> <span class="s2">""</span><span class="p">,</span>
+    <span class="s2">"chat_history"</span><span class="p">:</span> <span class="p">[],</span>
 <span class="p">}</span>
 
 <span class="n">app_id</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">())</span>
@@ -578,24 +579,24 @@ s=d.getElementsByTagName('script')[0];
         <span class="c1"># bind the vector store to the AI conversational step</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">vector_store</span><span class="o">=</span><span class="n">vector_store</span><span class="p">),</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># set the transitions between actions</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># add identifiers that will help track the application</span>
-    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">)</span>
     <span class="c1"># initialize the state</span>
     <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="o">**</span><span class="n">initial_state</span><span class="p">)</span>
     <span class="c1"># say what the initial action is</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_converse"</span><span class="p">)</span>
     <span class="c1"># add a hook to print the steps -- optional but shows that Burr is pluggable</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">PrintStepHook</span><span class="p">())</span>
     <span class="c1"># add tracking -- this will show up in the BURR UI.</span>
-    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">&quot;demo:conversational-rag&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">"demo:conversational-rag"</span><span class="p">)</span>
     <span class="c1"># build the application</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
@@ -605,7 +606,7 @@ s=d.getElementsByTagName('script')[0];
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># let&#39;s visualize what we have</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># let's visualize what we have</span>
 <span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -618,20 +619,20 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">reset_to_entrypoint</span><span class="p">()</span> <span class="c1"># reset the app to the entrypoint</span>
-<span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Ask something (or type exit to quit): &quot;</span><span class="p">)</span>
+<span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Ask something (or type exit to quit): "</span><span class="p">)</span>
 <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">step</span><span class="p">(</span>
-    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;user_question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
+    <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"user_question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
 <span class="p">)</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Ran action </span><span class="si">{</span><span class="n">previous_action</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> with result:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n [...]
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ran action </span><span class="si">{</span><span class="n">previous_action</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> with result:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">res [...]
 </pre></div>
 </div>
 </div>
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># now let&#39;s run the AI conversational step</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># now let's run the AI conversational step</span>
 <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">step</span><span class="p">()</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Ran action </span><span class="si">{</span><span class="n">previous_action</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> with result:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n [...]
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ran action </span><span class="si">{</span><span class="n">previous_action</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> with result:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">res [...]
 </pre></div>
 </div>
 </div>
@@ -643,15 +644,15 @@ s=d.getElementsByTagName('script')[0];
 actions/conditions are met.</p>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Running RAG with initial state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">state</span><span c [...]
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Running RAG with initial state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">state</span><span class= [...]
 <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Ask something (or type exit to quit): &quot;</span><span class="p">)</span>
+    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Ask something (or type exit to quit): "</span><span class="p">)</span>
     <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;human_converse&quot;</span><span class="p">],</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;terminal&quot;</span><span class="p">],</span>
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;user_question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_converse"</span><span class="p">],</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"terminal"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"user_question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
     <span class="p">)</span>
-    <span class="k">if</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;terminal&quot;</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"terminal"</span><span class="p">:</span>
         <span class="c1"># reached the end</span>
         <span class="n">pprint</span><span class="o">.</span><span class="n">pprint</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
         <span class="k">break</span>
@@ -683,16 +684,16 @@ as well as pick up the prior conversation from where it left off.</p>
 <span class="n">rewind_to_sequence_id</span> <span class="o">=</span> <span class="n">last_sequence_id</span> <span class="o">-</span> <span class="mi">2</span>
 <span class="n">new_app_id</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">())</span>
 
-<span class="n">project_name</span> <span class="o">=</span> <span class="s2">&quot;demo:conversational-rag&quot;</span>
+<span class="n">project_name</span> <span class="o">=</span> <span class="s2">"demo:conversational-rag"</span>
 <span class="c1"># we use the tracking client here to get the state of the application at a prior sequence_id</span>
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project_name</span><span class="p">)</span>
-<span class="n">persisted_state</span> <span class="o">=</span> <span class="n">tracker</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">,</span> 
+<span class="n">persisted_state</span> <span class="o">=</span> <span class="n">tracker</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">,</span> 
                                <span class="n">app_id</span><span class="o">=</span><span class="n">prior_app_id</span><span class="p">,</span> 
                                <span class="n">sequence_id</span><span class="o">=</span><span class="n">rewind_to_sequence_id</span><span class="p">)</span>
-<span class="n">state_values</span> <span class="o">=</span> <span class="n">persisted_state</span><span class="p">[</span><span class="s1">&#39;state&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">get_all</span><span class="p">()</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Loaded state from app_id:</span><span class="si">{</span><span class="n">prior_app_id</span><span class="si">}</span><span class="s2">, &quot;</span>
-      <span class="sa">f</span><span class="s2">&quot;sequence_id:</span><span class="si">{</span><span class="n">rewind_to_sequence_id</span><span class="si">}</span><span class="s2">::</span><span class="se">\n</span><span class="s2"> &quot;</span>
-      <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">state_values</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="n">state_values</span> <span class="o">=</span> <span class="n">persisted_state</span><span class="p">[</span><span class="s1">'state'</span><span class="p">]</span><span class="o">.</span><span class="n">get_all</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Loaded state from app_id:</span><span class="si">{</span><span class="n">prior_app_id</span><span class="si">}</span><span class="s2">, "</span>
+      <span class="sa">f</span><span class="s2">"sequence_id:</span><span class="si">{</span><span class="n">rewind_to_sequence_id</span><span class="si">}</span><span class="s2">::</span><span class="se">\n</span><span class="s2"> "</span>
+      <span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">state_values</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -707,20 +708,20 @@ as well as pick up the prior conversation from where it left off.</p>
         <span class="c1"># bind the vector store to the AI conversational step</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">vector_store</span><span class="o">=</span><span class="n">vector_store</span><span class="p">),</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># set the transitions between actions</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># add identifiers that will help track the application</span>
-    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">)</span>
     <span class="c1"># set state to prior state</span>
-    <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="o">**</span><span class="n">persisted_state</span><span class="p">[</span><span class="s2">&quot;state&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get_all</span><span class="p">())</span>
+    <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="o">**</span><span class="n">persisted_state</span><span class="p">[</span><span class="s2">"state"</span><span class="p">]</span><span class="o">.</span><span class="n">get_all</span><span class="p">())</span>
     <span class="c1"># say where we want to start</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_converse"</span><span class="p">)</span>
     <span class="c1"># add a hook to print the steps -- optional but shows that Burr is pluggable</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">PrintStepHook</span><span class="p">())</span>
     <span class="c1"># add tracking -- this will show up in the BURR UI.</span>
@@ -735,15 +736,15 @@ as well as pick up the prior conversation from where it left off.</p>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># We can now change test, debug, etc. from this prior state.</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">state_values</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">state_values</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Ask something (or type exit to quit): &quot;</span><span class="p">)</span>
+    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Ask something (or type exit to quit): "</span><span class="p">)</span>
     <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">other_app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;human_converse&quot;</span><span class="p">],</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;terminal&quot;</span><span class="p">],</span>
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;user_question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_converse"</span><span class="p">],</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"terminal"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"user_question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
     <span class="p">)</span>
-    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;terminal&quot;</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"terminal"</span><span class="p">:</span>
         <span class="c1"># reached the end</span>
         <span class="n">pprint</span><span class="o">.</span><span class="n">pprint</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
         <span class="k">break</span>
@@ -755,13 +756,13 @@ as well as pick up the prior conversation from where it left off.</p>
 <h3>Picking up where we left off from a prior conversation with <code class="docutils literal notranslate"><span class="pre">initialize_from()</span></code><a class="headerlink" href="#picking-up-where-we-left-off-from-a-prior-conversation-with-initialize-from" title="Link to this heading">¶</a></h3>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Now let&#39;s show how to use the ApplicationBuilder.initialize_from() method to pick up where we left off.</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Now let's show how to use the ApplicationBuilder.initialize_from() method to pick up where we left off.</span>
 <span class="c1"># This is useful if you want to continue a conversation with a user, or if you had a crash, etc.</span>
 
 <span class="c1"># set up for rewinding to a prior state -- loading it in as initial state</span>
 <span class="n">prior_app_id</span> <span class="o">=</span> <span class="n">app_id</span>
 
-<span class="n">project_name</span> <span class="o">=</span> <span class="s2">&quot;demo:conversational-rag&quot;</span>
+<span class="n">project_name</span> <span class="o">=</span> <span class="s2">"demo:conversational-rag"</span>
 <span class="c1"># we use the tracking client here to get the state of the application at a prior sequence_id</span>
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project_name</span><span class="p">)</span>
 <span class="n">pick_up_where_we_left_off_app</span> <span class="o">=</span> <span class="p">(</span>
@@ -771,21 +772,21 @@ as well as pick up the prior conversation from where it left off.</p>
         <span class="c1"># bind the vector store to the AI conversational step</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">vector_store</span><span class="o">=</span><span class="n">vector_store</span><span class="p">),</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># set the transitions between actions</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># add identifiers that will help track the application</span>
-    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">prior_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">prior_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">initializer</span><span class="o">=</span><span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="c1"># we want to always start at human_converse; our entrypoint</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span>
-        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can&#39;t find the prior state</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_converse"</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can't find the prior state</span>
     <span class="p">)</span>
     <span class="c1"># add a hook to print the steps -- optional but shows that Burr is pluggable</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">PrintStepHook</span><span class="p">())</span>
@@ -800,15 +801,15 @@ as well as pick up the prior conversation from where it left off.</p>
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">pick_up_where_we_left_off_app</span><span class="o">.</span><span clas [...]
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">pick_up_where_we_left_off_app</span><span class="o">.</span><span class="n" [...]
 <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Ask something (or type exit to quit): &quot;</span><span class="p">)</span>
+    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Ask something (or type exit to quit): "</span><span class="p">)</span>
     <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">pick_up_where_we_left_off_app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;human_converse&quot;</span><span class="p">],</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;terminal&quot;</span><span class="p">],</span>
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;user_question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_converse"</span><span class="p">],</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"terminal"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"user_question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
     <span class="p">)</span>
-    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;terminal&quot;</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"terminal"</span><span class="p">:</span>
         <span class="c1"># reached the end</span>
         <span class="n">pprint</span><span class="o">.</span><span class="n">pprint</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
         <span class="k">break</span>
@@ -821,14 +822,14 @@ as well as pick up the prior conversation from where it left off.</p>
 <h3>Forking the application using prior state with <code class="docutils literal notranslate"><span class="pre">initialize_from()</span></code><a class="headerlink" href="#forking-the-application-using-prior-state-with-initialize-from" title="Link to this heading">¶</a></h3>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Now let&#39;s show how to use the ApplicationBuilder.initialize_from() method to fork a new application.</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Now let's show how to use the ApplicationBuilder.initialize_from() method to fork a new application.</span>
 <span class="c1"># This is useful if you want to debug/reuse prior state, rewind and try something else, etc.</span>
 
 <span class="c1"># set up for rewinding to a prior state -- loading it in as initial state</span>
 <span class="n">prior_app_id</span> <span class="o">=</span> <span class="n">app_id</span>
 <span class="n">new_app_id</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">())</span>
 
-<span class="n">project_name</span> <span class="o">=</span> <span class="s2">&quot;demo:conversational-rag&quot;</span>
+<span class="n">project_name</span> <span class="o">=</span> <span class="s2">"demo:conversational-rag"</span>
 <span class="c1"># we use the tracking client here to get the state of the application at a prior sequence_id</span>
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project_name</span><span class="p">)</span>
 <span class="n">forking_new_application</span> <span class="o">=</span> <span class="p">(</span>
@@ -838,23 +839,23 @@ as well as pick up the prior conversation from where it left off.</p>
         <span class="c1"># bind the vector store to the AI conversational step</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">vector_store</span><span class="o">=</span><span class="n">vector_store</span><span class="p">),</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># set the transitions between actions</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># add identifiers that will help track the application</span>
-    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">initializer</span><span class="o">=</span><span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="c1"># we want to always start at human_converse; our entrypoint</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span>
-        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can&#39;t find the prior state</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_converse"</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can't find the prior state</span>
         <span class="n">fork_from_app_id</span><span class="o">=</span><span class="n">prior_app_id</span><span class="p">,</span> <span class="c1"># &lt;---- The new addition </span>
-        <span class="n">fork_from_partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">,</span>  <span class="c1"># &lt;---- The new addition </span>
+        <span class="n">fork_from_partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">,</span>  <span class="c1"># &lt;---- The new addition </span>
         <span class="n">fork_from_sequence_id</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span>  <span class="c1"># &lt;---- The new addition </span>
     <span class="p">)</span>
     <span class="c1"># add a hook to print the steps -- optional but shows that Burr is pluggable</span>
@@ -870,15 +871,15 @@ as well as pick up the prior conversation from where it left off.</p>
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">forking_new_application</span><span class="o">.</span><span class="n"> [...]
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Running RAG with loaded state:</span><span class="se">\n</span><span class="s2"> </span><span class="si">{</span><span class="n">pprint</span><span class="o">.</span><span class="n">pformat</span><span class="p">(</span><span class="n">forking_new_application</span><span class="o">.</span><span class="n">state [...]
 <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Ask something (or type exit to quit): &quot;</span><span class="p">)</span>
+    <span class="n">user_question</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">"Ask something (or type exit to quit): "</span><span class="p">)</span>
     <span class="n">previous_action</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">forking_new_application</span><span class="o">.</span><span class="n">run</span><span class="p">(</span>
-        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;human_converse&quot;</span><span class="p">],</span>
-        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;terminal&quot;</span><span class="p">],</span>
-        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;user_question&quot;</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
+        <span class="n">halt_before</span><span class="o">=</span><span class="p">[</span><span class="s2">"human_converse"</span><span class="p">],</span>
+        <span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"terminal"</span><span class="p">],</span>
+        <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"user_question"</span><span class="p">:</span> <span class="n">user_question</span><span class="p">},</span>
     <span class="p">)</span>
-    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;terminal&quot;</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">previous_action</span> <span class="ow">and</span> <span class="n">previous_action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"terminal"</span><span class="p">:</span>
         <span class="c1"># reached the end</span>
         <span class="n">pprint</span><span class="o">.</span><span class="n">pprint</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
         <span class="k">break</span>
@@ -891,7 +892,7 @@ as well as pick up the prior conversation from where it left off.</p>
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># this should print some warnings:</span>
 <span class="n">new_app_id</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">())</span>
 
-<span class="n">project_name</span> <span class="o">=</span> <span class="s2">&quot;demo:conversational-rag&quot;</span>
+<span class="n">project_name</span> <span class="o">=</span> <span class="s2">"demo:conversational-rag"</span>
 <span class="c1"># we use the tracking client here to get the state of the application at a prior sequence_id</span>
 <span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project_name</span><span class="p">)</span>
 <span class="n">bad_fork</span> <span class="o">=</span> <span class="p">(</span>
@@ -901,22 +902,22 @@ as well as pick up the prior conversation from where it left off.</p>
         <span class="c1"># bind the vector store to the AI conversational step</span>
         <span class="n">ai_converse</span><span class="o">=</span><span class="n">ai_converse</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">vector_store</span><span class="o">=</span><span class="n">vector_store</span><span class="p">),</span>
         <span class="n">human_converse</span><span class="o">=</span><span class="n">human_converse</span><span class="p">,</span>
-        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">&quot;chat_history&quot;</span><span class="p">),</span>
+        <span class="n">terminal</span><span class="o">=</span><span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">Result</span><span class="p">(</span><span class="s2">"chat_history"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># set the transitions between actions</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;terminal&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;&#39;exit&#39; in question&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_converse&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_converse"</span><span class="p">,</span> <span class="s2">"human_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"terminal"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"'exit' in question"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"human_converse"</span><span class="p">,</span> <span class="s2">"ai_converse"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="c1"># add identifiers that will help track the application</span>
-    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">&quot;sample_user&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">new_app_id</span><span class="p">,</span> <span class="n">partition_key</span><span class="o">=</span><span class="s2">"sample_user"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">initialize_from</span><span class="p">(</span>
         <span class="n">initializer</span><span class="o">=</span><span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="c1"># we want to always start at human_converse; our entrypoint</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;human_converse&quot;</span><span class="p">,</span>
-        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can&#39;t find the prior state</span>
-        <span class="n">fork_from_app_id</span><span class="o">=</span><span class="s2">&quot;NO_SUCH_APP_ID&quot;</span><span class="p">,</span> <span class="c1"># &lt;---- The new addition </span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"human_converse"</span><span class="p">,</span>
+        <span class="n">default_state</span><span class="o">=</span><span class="n">initial_state</span><span class="p">,</span> <span class="c1"># set some default state incase we can't find the prior state</span>
+        <span class="n">fork_from_app_id</span><span class="o">=</span><span class="s2">"NO_SUCH_APP_ID"</span><span class="p">,</span> <span class="c1"># &lt;---- The new addition </span>
     <span class="p">)</span>
     <span class="c1"># add a hook to print the steps -- optional but shows that Burr is pluggable</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">PrintStepHook</span><span class="p">())</span>
diff --git a/content/docs/examples/data-science/index.html b/content/docs/examples/data-science/index.html
index 65883300..39492be6 100644
--- a/content/docs/examples/data-science/index.html
+++ b/content/docs/examples/data-science/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/data-science/ml_training/index.html b/content/docs/examples/data-science/ml_training/index.html
index e6a9e87a..3c36fe65 100644
--- a/content/docs/examples/data-science/ml_training/index.html
+++ b/content/docs/examples/data-science/ml_training/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -482,7 +483,7 @@ launching new ones as they complete (based on state).</p>
 <section id="code-example">
 <h2>Code example<a class="headerlink" href="#code-example" title="Link to this heading">¶</a></h2>
 <p>This uses the class-based API for defining an <code class="docutils literal notranslate"><span class="pre">action</span></code>.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">"""</span>
 <span class="sd">This is a sketch of an example of a machine learning training pipeline using Burr where you</span>
 <span class="sd">want to do something dynamic like train a model for a variable number of iterations and then</span>
 <span class="sd">pick the best model from each of the iterations based on some validation metric. E.g. hyperparameter search.</span>
@@ -491,7 +492,7 @@ launching new ones as they complete (based on state).</p>
 <span class="sd">or hit a max number of iterations (or epochs), etc.</span>
 
 <span class="sd">Note: this example uses the class based API to define the actions. You could also use the function+decorator API.</span>
-<span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">"""</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">burr.core.application</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">Action</span><span class="p">,</span> <span class="n">Condition</span><span class="p">,</span> <span class="n">State</span><span class="p">,</span> <span class="n">default</span>
 
@@ -499,100 +500,100 @@ launching new ones as they complete (based on state).</p>
 <span class="k">class</span><span class="w"> </span><span class="nc">ProcessDataAction</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;data_path&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"data_path"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;This is where you would load and process your data.</span>
+<span class="w">        </span><span class="sd">"""This is where you would load and process your data.</span>
 <span class="sd">        You can take in state and reference object fields.</span>
 
 <span class="sd">        You need to return a dictionary of the results that `update()` will then use to update the state.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+<span class="sd">        """</span>
         <span class="c1"># load data, and run some feature engineering -- create the data sets</span>
         <span class="c1"># TODO: fill in</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;training_data&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_OBJECT/PATH&quot;</span><span class="p">,</span> <span class="s2">&quot;evaluation_data&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_OBJECT/PATH&quot;</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"training_data"</span><span class="p">:</span> <span class="s2">"SOME_OBJECT/PATH"</span><span class="p">,</span> <span class="s2">"evaluation_data"</span><span class="p">:</span> <span class="s2">"SOME_OBJECT/PATH"</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;training_data&quot;</span><span class="p">,</span> <span class="s2">&quot;evaluation_data&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"training_data"</span><span class="p">,</span> <span class="s2">"evaluation_data"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-            <span class="n">training_data</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;training_data&quot;</span><span class="p">],</span> <span class="n">evaluation_data</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;evaluation_data&quot;</span><span class="p">]</span>
+            <span class="n">training_data</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"training_data"</span><span class="p">],</span> <span class="n">evaluation_data</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"evaluation_data"</span><span class="p">]</span>
         <span class="p">)</span>
 
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TrainModel</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;training_data&quot;</span><span class="p">,</span> <span class="s2">&quot;iterations&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"training_data"</span><span class="p">,</span> <span class="s2">"iterations"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;This is where you&#39;d build the model and on each iteration do something different.</span>
+<span class="w">        </span><span class="sd">"""This is where you'd build the model and on each iteration do something different.</span>
 <span class="sd">        E.g. hyperparameter search.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="c1"># train the model, i.e. run one &quot;iteration&quot; whatever that means for you.</span>
+<span class="sd">        """</span>
+        <span class="c1"># train the model, i.e. run one "iteration" whatever that means for you.</span>
         <span class="c1"># TODO: fill in</span>
         <span class="k">return</span> <span class="p">{</span>
-            <span class="s2">&quot;model&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_MODEL&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;iterations&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;iterations&quot;</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span>
-            <span class="s2">&quot;metrics&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_METRICS&quot;</span><span class="p">,</span>
+            <span class="s2">"model"</span><span class="p">:</span> <span class="s2">"SOME_MODEL"</span><span class="p">,</span>
+            <span class="s2">"iterations"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"iterations"</span><span class="p">]</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span>
+            <span class="s2">"metrics"</span><span class="p">:</span> <span class="s2">"SOME_METRICS"</span><span class="p">,</span>
         <span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;models&quot;</span><span class="p">,</span> <span class="s2">&quot;training_metrics&quot;</span><span class="p">,</span> <span class="s2">&quot;iterations&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"models"</span><span class="p">,</span> <span class="s2">"training_metrics"</span><span class="p">,</span> <span class="s2">"iterations"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-            <span class="n">iterations</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;iterations&quot;</span><span class="p">],</span>  <span class="c1"># set current iteration value</span>
+            <span class="n">iterations</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"iterations"</span><span class="p">],</span>  <span class="c1"># set current iteration value</span>
         <span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-            <span class="n">models</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">],</span>  <span class="c1"># append -- note this can get big if your model is big</span>
-            <span class="c1"># so you&#39;ll want to overwrite but store the conditions, or log somewhere</span>
-            <span class="n">metrics</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;metrics&quot;</span><span class="p">],</span>  <span class="c1"># append the metrics</span>
+            <span class="n">models</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"model"</span><span class="p">],</span>  <span class="c1"># append -- note this can get big if your model is big</span>
+            <span class="c1"># so you'll want to overwrite but store the conditions, or log somewhere</span>
+            <span class="n">metrics</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"metrics"</span><span class="p">],</span>  <span class="c1"># append the metrics</span>
         <span class="p">)</span>
 
 
 <span class="k">class</span><span class="w"> </span><span class="nc">ValidateModel</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;models&quot;</span><span class="p">,</span> <span class="s2">&quot;evaluation_data&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"models"</span><span class="p">,</span> <span class="s2">"evaluation_data"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute validation metrics using the model and evaluation data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">"""Compute validation metrics using the model and evaluation data."""</span>
         <span class="c1"># TODO: fill in</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;validation_metrics&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_METRICS&quot;</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"validation_metrics"</span><span class="p">:</span> <span class="s2">"SOME_METRICS"</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;validation_metrics&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"validation_metrics"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">validation_metrics</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;validation_metrics&quot;</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">validation_metrics</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"validation_metrics"</span><span class="p">])</span>
 
 
 <span class="k">class</span><span class="w"> </span><span class="nc">BestModel</span><span class="p">(</span><span class="n">Action</span><span class="p">):</span>
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;validation_metrics&quot;</span><span class="p">,</span> <span class="s2">&quot;models&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"validation_metrics"</span><span class="p">,</span> <span class="s2">"models"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Select the best model based on the validation metrics.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">"""Select the best model based on the validation metrics."""</span>
         <span class="c1"># TODO: fill in</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;best_model&quot;</span><span class="p">:</span> <span class="s2">&quot;SOME_MODEL&quot;</span><span class="p">}</span>
+        <span class="k">return</span> <span class="p">{</span><span class="s2">"best_model"</span><span class="p">:</span> <span class="s2">"SOME_MODEL"</span><span class="p">}</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;best_model&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"best_model"</span><span class="p">]</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">result</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">best_model</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;best_model&quot;</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">best_model</span><span class="o">=</span><span class="n">result</span><span class="p">[</span><span class="s2">"best_model"</span><span class="p">])</span>
 
 
 <span class="k">def</span><span class="w"> </span><span class="nf">application</span><span class="p">(</span><span class="n">iterations</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">application</span><span class="o">.</span><span class="n">Application</span><span class="p">:</span>
     <span class="k">return</span> <span class="p">(</span>
         <span class="n">burr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">ApplicationBuilder</span><span class="p">()</span>
         <span class="o">.</span><span class="n">with_state</span><span class="p">(</span>
-            <span class="n">data_path</span><span class="o">=</span><span class="s2">&quot;data.csv&quot;</span><span class="p">,</span>
+            <span class="n">data_path</span><span class="o">=</span><span class="s2">"data.csv"</span><span class="p">,</span>
             <span class="n">iterations</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
             <span class="n">training_data</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
             <span class="n">evaluation_data</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
@@ -608,21 +609,21 @@ launching new ones as they complete (based on state).</p>
             <span class="n">best_model</span><span class="o">=</span><span class="n">BestModel</span><span class="p">(),</span>
         <span class="p">)</span>
         <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-            <span class="p">(</span><span class="s2">&quot;process_data&quot;</span><span class="p">,</span> <span class="s2">&quot;train_model&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;train_model&quot;</span><span class="p">,</span> <span class="s2">&quot;validate_model&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;validate_model&quot;</span><span class="p">,</span> <span class="s2">&quot;best_model&quot;</span><span class="p">,</span> <span class="n">Condition</span><span class="o">.</span><span class="n">expr</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;iterations&gt;</span><span class="si">{</span><span class="n">iterations</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)),</span>
-            <span class="p">(</span><span class="s2">&quot;validate_model&quot;</span><span class="p">,</span> <span class="s2">&quot;train_model&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"process_data"</span><span class="p">,</span> <span class="s2">"train_model"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"train_model"</span><span class="p">,</span> <span class="s2">"validate_model"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"validate_model"</span><span class="p">,</span> <span class="s2">"best_model"</span><span class="p">,</span> <span class="n">Condition</span><span class="o">.</span><span class="n">expr</span><span class="p">(</span><span class="sa">f</span><span class="s2">"iterations&gt;</span><span class="si">{</span><span class="n">iterations</span><span class="si">}</span><span class="s2">"</span><span class="p">)),</span>
+            <span class="p">(</span><span class="s2">"validate_model"</span><span class="p">,</span> <span class="s2">"train_model"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
         <span class="p">)</span>
-        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;process_data&quot;</span><span class="p">)</span>
+        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"process_data"</span><span class="p">)</span>
         <span class="o">.</span><span class="n">build</span><span class="p">()</span>
     <span class="p">)</span>
 
 
-<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
+<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">"__main__"</span><span class="p">:</span>
     <span class="n">app</span> <span class="o">=</span> <span class="n">application</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span>  <span class="c1"># doing good data science is up to you...</span>
-    <span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">&quot;statemachine&quot;</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="nb">format< [...]
+    <span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">"statemachine"</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="nb">format</span><spa [...]
     <span class="c1"># you could run things like this:</span>
-    <span class="c1"># last_action, result, state = app.run(halt_after=[&quot;best_model&quot;])</span>
+    <span class="c1"># last_action, result, state = app.run(halt_after=["best_model"])</span>
 </pre></div>
 </div>
 </section>
diff --git a/content/docs/examples/data-science/simulation/index.html b/content/docs/examples/data-science/simulation/index.html
index 878ca4d2..fe0126dd 100644
--- a/content/docs/examples/data-science/simulation/index.html
+++ b/content/docs/examples/data-science/simulation/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -468,15 +469,15 @@ actions, or an action that loops over all “users”. We are still figuring out
 </section>
 <section id="code-example">
 <h2>Code example<a class="headerlink" href="#code-example" title="Link to this heading">¶</a></h2>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">"""</span>
 <span class="sd">This module contains a stubbed out structure for one way of doing a simulation</span>
 <span class="sd"> for forecasting purposes.</span>
 
 <span class="sd">For more sophisticated forecasts where prediction of one timestep</span>
 <span class="sd">depends on the previous timestep, you need to forecast on a per-step basis. So</span>
-<span class="sd">you&#39;re effectively simulating the future at each step. This is a simple example of</span>
+<span class="sd">you're effectively simulating the future at each step. This is a simple example of</span>
 <span class="sd">how you might structure such a simulation.</span>
-<span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">"""</span>
 
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Tuple</span>
 
@@ -484,42 +485,42 @@ actions, or an action that loops over all “users”. We are still figuring out
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.action</span><span class="w"> </span><span class="kn">import</span> <span class="n">action</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;data_path&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"data_path"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"data"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">prepare_data</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This would pull the data, prepare it, and return it.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This would pull the data, prepare it, and return it."""</span>
     <span class="c1"># pull data, prepare as necessary</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">_process_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;data_path&quot;</span><span class="p">])}</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"data"</span><span class="p">:</span> <span class="n">_process_data</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"data_path"</span><span class="p">])}</span>
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">,</span> <span class="s2">&quot;simulation_start&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"data"</span><span class="p">,</span> <span class="s2">"simulation_start"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"model"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">build_model</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This would fit the model on data before the simulation start date.&quot;&quot;&quot;</span>
-    <span class="n">training_data</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span>
-    <span class="n">model</span> <span class="o">=</span> <span class="n">_fit_model</span><span class="p">(</span><span class="n">training_data</span><span class="p">,</span> <span class="n">upto</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;simulation_start&quot;</span><span class="p">])</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;model&quot;</span><span class="p">:</span> <span class="n">model</span><span class="p">}</span>
+<span class="w">    </span><span class="sd">"""This would fit the model on data before the simulation start date."""</span>
+    <span class="n">training_data</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"data"</span><span class="p">]</span>
+    <span class="n">model</span> <span class="o">=</span> <span class="n">_fit_model</span><span class="p">(</span><span class="n">training_data</span><span class="p">,</span> <span class="n">upto</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"simulation_start"</span><span class="p">])</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"model"</span><span class="p">:</span> <span class="n">model</span><span class="p">}</span>
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
 <span class="nd">@action</span><span class="p">(</span>
-    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;simulation_start&quot;</span><span class="p">,</span> <span class="s2">&quot;simulation_end&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">,</span> <span class="s2">&quot;data&quot;</span><span class="p">,</span> <span class="s2">&quot;current_timestep&quot;</span><span class="p">],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">],</span>
+    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"simulation_start"</span><span class="p">,</span> <span class="s2">"simulation_end"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">,</span> <span class="s2">"data"</span><span class="p">,</span> <span class="s2">"current_timestep"</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"data"</span><span class="p">],</span>
 <span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">forecast</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This action forecasts the next timestep in the simulation and appends it to data.&quot;&quot;&quot;</span>
-    <span class="n">model</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">]</span>
-    <span class="n">data</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span>
-    <span class="n">start_time</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;simulation_start&quot;</span><span class="p">]</span>
-    <span class="n">current_time_step</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;current_timestep&quot;</span><span class="p">,</span> <span class="n">start_time</span><span class="p">)</span>
+<span class="w">    </span><span class="sd">"""This action forecasts the next timestep in the simulation and appends it to data."""</span>
+    <span class="n">model</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"model"</span><span class="p">]</span>
+    <span class="n">data</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"data"</span><span class="p">]</span>
+    <span class="n">start_time</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"simulation_start"</span><span class="p">]</span>
+    <span class="n">current_time_step</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"current_timestep"</span><span class="p">,</span> <span class="n">start_time</span><span class="p">)</span>
     <span class="n">next_timestep</span> <span class="o">=</span> <span class="n">_forecast_timestep</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">current_time_step</span><span class="p">)</span>
     <span class="n">data</span> <span class="o">=</span> <span class="n">_update_data</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">next_timestep</span><span class="p">)</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">&quot;current_timestep&quot;</span><span class="p">:</span> <span class="n">next_timestep</span><span class="p">}</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"data"</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">"current_timestep"</span><span class="p">:</span> <span class="n">next_timestep</span><span class="p">}</span>
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"data"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">terminate</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This is a terminal step that would save the forecast or do something else.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This is a terminal step that would save the forecast or do something else."""</span>
     <span class="k">return</span> <span class="p">{},</span> <span class="n">state</span>
 
 
@@ -528,17 +529,17 @@ actions, or an action that loops over all “users”. We are still figuring out
         <span class="n">ApplicationBuilder</span><span class="p">()</span>
         <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">prepare_data</span><span class="p">,</span> <span class="n">build_model</span><span class="p">,</span> <span class="n">forecast</span><span class="p">,</span> <span class="n">terminate</span><span class="p">)</span>
         <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-            <span class="p">(</span><span class="s2">&quot;prepare_data&quot;</span><span class="p">,</span> <span class="s2">&quot;build_model&quot;</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;build_model&quot;</span><span class="p">,</span> <span class="s2">&quot;forecast&quot;</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;forecast&quot;</span><span class="p">,</span> <span class="s2">&quot;forecast&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;current_timestep&lt;simulation_end&quot;</span><span class="p">)),</span>
-            <span class="p">(</span><span class="s2">&quot;forecast&quot;</span><span class="p">,</span> <span class="s2">&quot;terminate&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;current_timestep&gt;=simulation_end&quot;</span><span class="p">)),</span>
+            <span class="p">(</span><span class="s2">"prepare_data"</span><span class="p">,</span> <span class="s2">"build_model"</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"build_model"</span><span class="p">,</span> <span class="s2">"forecast"</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"forecast"</span><span class="p">,</span> <span class="s2">"forecast"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"current_timestep&lt;simulation_end"</span><span class="p">)),</span>
+            <span class="p">(</span><span class="s2">"forecast"</span><span class="p">,</span> <span class="s2">"terminate"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"current_timestep&gt;=simulation_end"</span><span class="p">)),</span>
         <span class="p">)</span>
         <span class="o">.</span><span class="n">with_state</span><span class="p">(</span>
-            <span class="n">data_path</span><span class="o">=</span><span class="s2">&quot;SOME_PATH&quot;</span><span class="p">,</span>
-            <span class="n">simulation_start</span><span class="o">=</span><span class="s2">&quot;some-value&quot;</span><span class="p">,</span>
-            <span class="n">simulation_end</span><span class="o">=</span><span class="s2">&quot;some-end-value&quot;</span><span class="p">,</span>
+            <span class="n">data_path</span><span class="o">=</span><span class="s2">"SOME_PATH"</span><span class="p">,</span>
+            <span class="n">simulation_start</span><span class="o">=</span><span class="s2">"some-value"</span><span class="p">,</span>
+            <span class="n">simulation_end</span><span class="o">=</span><span class="s2">"some-end-value"</span><span class="p">,</span>
         <span class="p">)</span>
-        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prepare_data&quot;</span><span class="p">)</span>
+        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prepare_data"</span><span class="p">)</span>
         <span class="o">.</span><span class="n">build</span><span class="p">()</span>
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">app</span>
@@ -546,32 +547,32 @@ actions, or an action that loops over all “users”. We are still figuring out
 
 <span class="c1"># --- stubbed out functions to fill out for the simulation</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">_process_data</span><span class="p">(</span><span class="n">data_path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">object</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This function would read and process data from a file.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This function would read and process data from a file."""</span>
     <span class="k">return</span> <span class="p">{}</span>
 
 
 <span class="k">def</span><span class="w"> </span><span class="nf">_fit_model</span><span class="p">(</span><span class="n">data</span><span class="p">:</span> <span class="nb">object</span><span class="p">,</span> <span class="n">upto</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">object</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This function would fit a model on data upto a certain date.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This function would fit a model on data upto a certain date."""</span>
     <span class="k">return</span> <span class="p">{}</span>
 
 
 <span class="k">def</span><span class="w"> </span><span class="nf">_forecast_timestep</span><span class="p">(</span><span class="n">model</span><span class="p">:</span> <span class="nb">object</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">object</span><span class="p">,</span> <span class="n">current_timestep</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb" [...]
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This function would forecast the next timestep in the simulation given the model and data.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This function would forecast the next timestep in the simulation given the model and data."""</span>
     <span class="k">return</span> <span class="p">{}</span>
 
 
 <span class="k">def</span><span class="w"> </span><span class="nf">_update_data</span><span class="p">(</span><span class="n">data</span><span class="p">:</span> <span class="nb">object</span><span class="p">,</span> <span class="n">next_timestep</span><span class="p">:</span> <span class="nb">object</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">object</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;This function would update the data with the forecasted timestep.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""This function would update the data with the forecasted timestep."""</span>
     <span class="k">return</span> <span class="p">{}</span>
 
 
-<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
+<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">"__main__"</span><span class="p">:</span>
     <span class="n">_app</span> <span class="o">=</span> <span class="n">application</span><span class="p">()</span>
     <span class="n">_app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span>
-        <span class="n">output_file_path</span><span class="o">=</span><span class="s2">&quot;statemachine&quot;</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">&quot;png&quot;</span>
+        <span class="n">output_file_path</span><span class="o">=</span><span class="s2">"statemachine"</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">"png"</span>
     <span class="p">)</span>
     <span class="c1"># you could run things like this:</span>
-    <span class="c1"># last_action, result, state = _app.run(halt_after=[&quot;terminate&quot;])</span>
+    <span class="c1"># last_action, result, state = _app.run(halt_after=["terminate"])</span>
 
 </pre></div>
 </div>
diff --git a/content/docs/examples/deployment/aws/index.html b/content/docs/examples/deployment/aws/index.html
index 4c1075e0..fdf16d80 100644
--- a/content/docs/examples/deployment/aws/index.html
+++ b/content/docs/examples/deployment/aws/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/deployment/index.html b/content/docs/examples/deployment/index.html
index f8983acb..690a000b 100644
--- a/content/docs/examples/deployment/index.html
+++ b/content/docs/examples/deployment/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/deployment/infrastructure/index.html b/content/docs/examples/deployment/infrastructure/index.html
index 43b56d35..a30c32d4 100644
--- a/content/docs/examples/deployment/infrastructure/index.html
+++ b/content/docs/examples/deployment/infrastructure/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/deployment/monitoring/index.html b/content/docs/examples/deployment/monitoring/index.html
index e7b2bb52..1175b68c 100644
--- a/content/docs/examples/deployment/monitoring/index.html
+++ b/content/docs/examples/deployment/monitoring/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/deployment/web-server/index.html b/content/docs/examples/deployment/web-server/index.html
index 4cf04395..7bd23792 100644
--- a/content/docs/examples/deployment/web-server/index.html
+++ b/content/docs/examples/deployment/web-server/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/guardrails/creating_tests/index.html b/content/docs/examples/guardrails/creating_tests/index.html
index 7927622e..1a036283 100644
--- a/content/docs/examples/guardrails/creating_tests/index.html
+++ b/content/docs/examples/guardrails/creating_tests/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -447,9 +448,9 @@ See orange lines indicating what to pull from the UI in the image below.</p>
 <li><p>Adjust the test as needed, e.g. what you’re validating or asserting and how.</p></li>
 </ol>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>burr-test-case<span class="w"> </span>create<span class="w">  </span><span class="se">\</span>
-<span class="w">  </span>--project-name<span class="w"> </span><span class="s2">&quot;SOME_NAME&quot;</span><span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>--partition-key<span class="w"> </span><span class="s2">&quot;SOME_KEY&quot;</span><span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>--app-id<span class="w"> </span><span class="s2">&quot;SOME_ID&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--project-name<span class="w"> </span><span class="s2">"SOME_NAME"</span><span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--partition-key<span class="w"> </span><span class="s2">"SOME_KEY"</span><span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--app-id<span class="w"> </span><span class="s2">"SOME_ID"</span><span class="w"> </span><span class="se">\</span>
 <span class="w">  </span>--sequence-id<span class="w"> </span><span class="m">0</span><span class="w"> </span><span class="se">\</span>
 <span class="w">  </span>--target-file-name<span class="w"> </span>/tmp/test-case.json
 </pre></div>
diff --git a/content/docs/examples/guardrails/index.html b/content/docs/examples/guardrails/index.html
index b47ff352..746dc3b3 100644
--- a/content/docs/examples/guardrails/index.html
+++ b/content/docs/examples/guardrails/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/index.html b/content/docs/examples/index.html
index b8455158..5d438a61 100644
--- a/content/docs/examples/index.html
+++ b/content/docs/examples/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/examples/simple/choose-your-own-adventure/index.html b/content/docs/examples/simple/choose-your-own-adventure/index.html
index 8226d2b9..fcfb9ea2 100644
--- a/content/docs/examples/simple/choose-your-own-adventure/index.html
+++ b/content/docs/examples/simple/choose-your-own-adventure/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -453,18 +454,18 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># set your OpenAI API key to run the rest of the notebook</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
-<span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s2">&quot;OPENAI_API_KEY&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="o">...</span>
+<span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s2">"OPENAI_API_KEY"</span><span class="p">]</span> <span class="o">=</span> <span class="o">...</span>
 </pre></div>
 </div>
 </div>
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">RESTRICTIONS</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;You&#39;re a small corgi with short legs. You can&#39;t jump high,</span>
-<span class="s2">you can&#39;t run fast, you can&#39;t perform feats of athleticism in general</span>
-<span class="s2">to achieve any of your goals. You can&#39;t open doors, you can&#39;t use tools,</span>
-<span class="s2">you can&#39;t communicate with humans, you can&#39;t use your paws to manipulate</span>
-<span class="s2">objects, you can&#39;t use your mouth to communicate with humans&quot;&quot;&quot;</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">RESTRICTIONS</span> <span class="o">=</span> <span class="s2">"""You're a small corgi with short legs. You can't jump high,</span>
+<span class="s2">you can't run fast, you can't perform feats of athleticism in general</span>
+<span class="s2">to achieve any of your goals. You can't open doors, you can't use tools,</span>
+<span class="s2">you can't communicate with humans, you can't use your paws to manipulate</span>
+<span class="s2">objects, you can't use your mouth to communicate with humans"""</span>
 </pre></div>
 </div>
 </div>
@@ -474,43 +475,43 @@ s=d.getElementsByTagName('script')[0];
 <h2>Define actions<a class="headerlink" href="#define-actions" title="Link to this heading">¶</a></h2>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;challenges&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">])</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"challenges"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">start</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Load the first challenge as the current challenge&quot;&quot;&quot;</span>
-    <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;challenges&quot;</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
+<span class="w">    </span><span class="sd">"""Load the first challenge as the current challenge"""</span>
+    <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"challenges"</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">current_challenge</span><span class="o">=</span><span class="n">current_challenge</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;attempts&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"attempts"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">prompt_for_challenge</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Request user input to solve the current challenge&quot;&quot;&quot;</span>
-    <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">]</span>
-    <span class="n">user_response</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">current_challenge</span><span class="si">}</span><span class="s1">. What do you do?</span><span class="se">\n</span><span class="s1"> $ &#39;</span><span class="p">)</span>
+<span class="w">    </span><span class="sd">"""Request user input to solve the current challenge"""</span>
+    <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">]</span>
+    <span class="n">user_response</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="sa">f</span><span class="s1">'</span><span class="si">{</span><span class="n">current_challenge</span><span class="si">}</span><span class="s1">. What do you do?</span><span class="se">\n</span><span class="s1"> $ '</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">attempts</span><span class="o">=</span><span class="n">user_response</span><span class="p">)</span>
 
 
 <span class="nd">@action</span><span class="p">(</span>
-    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;attempts&quot;</span><span class="p">,</span> <span class="s2">&quot;current_challenge&quot;</span><span class="p">],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;challenge_solved&quot;</span><span class="p">,</span> <span class="s2">&quot;what_happened&quot;</span><span class="p">],</span>
+    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"attempts"</span><span class="p">,</span> <span class="s2">"current_challenge"</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"challenge_solved"</span><span class="p">,</span> <span class="s2">"what_happened"</span><span class="p">],</span>
 <span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">evaluate_attempt</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">response</span> <span class="o">=</span> <span class="n">OpenAI</span><span class="p">()</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4o-mini&quot;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4o-mini"</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[</span>
             <span class="p">{</span>
-                <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;system&quot;</span><span class="p">,</span>
-                <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;&quot;&quot;You are evaluating responses for</span>
+                <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"system"</span><span class="p">,</span>
+                <span class="s2">"content"</span><span class="p">:</span> <span class="sa">f</span><span class="s2">"""You are evaluating responses for</span>
 <span class="s2">             whether they constitute solutions to the provided challenge in a text</span>
 <span class="s2">             based game, whose protagonist is a dog subject to the following limitations:</span>
-<span class="s2">             </span><span class="si">{</span><span class="n">RESTRICTIONS</span><span class="si">}</span><span class="s2">. You respond ONLY with a json object containing two fields: &quot;solved&quot;, which is a</span>
-<span class="s2">             boolean indicating whether the challenge was solved by the attempt, and &quot;what_happened&quot;,</span>
+<span class="s2">             </span><span class="si">{</span><span class="n">RESTRICTIONS</span><span class="si">}</span><span class="s2">. You respond ONLY with a json object containing two fields: "solved", which is a</span>
+<span class="s2">             boolean indicating whether the challenge was solved by the attempt, and "what_happened",</span>
 <span class="s2">             which is a string containing a brief narrative, written in the second person and addressed</span>
-<span class="s2">             to the player, of what happened during the protagonist&#39;s attempt&quot;&quot;&quot;</span><span class="p">,</span>
+<span class="s2">             to the player, of what happened during the protagonist's attempt"""</span><span class="p">,</span>
             <span class="p">},</span>
             <span class="p">{</span>
-                <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span><span class="p">,</span>
-                <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;The current challenge is: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;current_challenge&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2"> &quot;</span>
-                <span class="sa">f</span><span class="s2">&quot;and the player&#39;s attempt is: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;attempts&#39;</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span>
+                <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span><span class="p">,</span>
+                <span class="s2">"content"</span><span class="p">:</span> <span class="sa">f</span><span class="s2">"The current challenge is: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'current_challenge'</span><span class="p">]</span><span class="si">}</span><span class="s2"> "</span>
+                <span class="sa">f</span><span class="s2">"and the player's attempt is: </span><span class="si">{</span><span class="n">state</span><span class="p">[</span><span class="s1">'attempts'</span><span class="p">][</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">,</span>
             <span class="p">},</span>
         <span class="p">],</span>
     <span class="p">)</span>
@@ -518,40 +519,40 @@ s=d.getElementsByTagName('script')[0];
     <span class="k">try</span><span class="p">:</span>
         <span class="n">json_result</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">content</span><span class="p">)</span>
     <span class="k">except</span> <span class="n">json</span><span class="o">.</span><span class="n">JSONDecodeError</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;bad json: &quot;</span><span class="p">,</span> <span class="n">content</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">"bad json: "</span><span class="p">,</span> <span class="n">content</span><span class="p">)</span>
         <span class="n">json_result</span> <span class="o">=</span> <span class="p">{</span>
-            <span class="s2">&quot;solved&quot;</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
-            <span class="s2">&quot;what_happened&quot;</span><span class="p">:</span> <span class="s2">&quot;Not sure, really. I&#39;m a dog. I can&#39;t read json. I can&#39;t read at all.&quot;</span><span class="p">,</span>
+            <span class="s2">"solved"</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
+            <span class="s2">"what_happened"</span><span class="p">:</span> <span class="s2">"Not sure, really. I'm a dog. I can't read json. I can't read at all."</span><span class="p">,</span>
         <span class="p">}</span>
 
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-        <span class="n">challenge_solved</span><span class="o">=</span><span class="n">json_result</span><span class="p">[</span><span class="s2">&quot;solved&quot;</span><span class="p">],</span>
-        <span class="n">what_happened</span><span class="o">=</span><span class="n">json_result</span><span class="p">[</span><span class="s2">&quot;what_happened&quot;</span><span class="p">],</span>
+        <span class="n">challenge_solved</span><span class="o">=</span><span class="n">json_result</span><span class="p">[</span><span class="s2">"solved"</span><span class="p">],</span>
+        <span class="n">what_happened</span><span class="o">=</span><span class="n">json_result</span><span class="p">[</span><span class="s2">"what_happened"</span><span class="p">],</span>
     <span class="p">)</span>
 
 
 <span class="nd">@action</span><span class="p">(</span>
-    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;challenge_solved&quot;</span><span class="p">,</span> <span class="s2">&quot;current_challenge&quot;</span><span class="p">,</span> <span class="s2">&quot;what_happened&quot;</span><span class="p">],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">,</span> <span class="s2">&quot;did_win&quot;</span><span class="p">],</span>
+    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"challenge_solved"</span><span class="p">,</span> <span class="s2">"current_challenge"</span><span class="p">,</span> <span class="s2">"what_happened"</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">,</span> <span class="s2">"did_win"</span><span class="p">],</span>
 <span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">maybe_progress</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;What happened:&quot;</span><span class="p">,</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;what_happened&quot;</span><span class="p">])</span>
-    <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;challenge_solved&quot;</span><span class="p">]:</span>
-        <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="n">challenges</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span>
-            <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;did_win&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">}</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">"What happened:"</span><span class="p">,</span> <span class="n">state</span><span class="p">[</span><span class="s2">"what_happened"</span><span class="p">])</span>
+    <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">"challenge_solved"</span><span class="p">]:</span>
+        <span class="k">if</span> <span class="n">state</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">]</span> <span class="o">==</span> <span class="n">challenges</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span>
+            <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"did_win"</span><span class="p">:</span> <span class="kc">True</span><span class="p">}</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="n">result</span> <span class="o">=</span> <span class="p">{</span>
-                <span class="s2">&quot;current_challenge&quot;</span><span class="p">:</span> <span class="n">challenges</span><span class="p">[</span><span class="n">challenges</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">])</span> <span class="o">+</span> <span class="mi">1</span><span class="p">]</span>
+                <span class="s2">"current_challenge"</span><span class="p">:</span> <span class="n">challenges</span><span class="p">[</span><span class="n">challenges</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">])</span> <span class="o">+</span> <span class="mi">1</span><span class="p">]</span>
             <span class="p">}</span>
     <span class="k">else</span><span class="p">:</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">]}</span>
+        <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"current_challenge"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">]}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;challenges&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"challenges"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">win</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># get summary of actions taken from openai</span>
-    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;you won&quot;</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">"you won"</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">state</span>
 </pre></div>
 </div>
@@ -560,9 +561,9 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">challenges</span> <span class="o">=</span> <span class="p">[</span>
-    <span class="s2">&quot;There is a dish of dog food on the floor. You want to eat it&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;There is a dish of dog food on a table. You want to eat it&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;There is a dish of dog food in a locked car. You want to eat it&quot;</span><span class="p">,</span>
+    <span class="s2">"There is a dish of dog food on the floor. You want to eat it"</span><span class="p">,</span>
+    <span class="s2">"There is a dish of dog food on a table. You want to eat it"</span><span class="p">,</span>
+    <span class="s2">"There is a dish of dog food in a locked car. You want to eat it"</span><span class="p">,</span>
 <span class="p">]</span>
 </pre></div>
 </div>
@@ -572,7 +573,7 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">build_application</span><span class="p">(</span>
     <span class="n">app_id</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">storage_dir</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;~/.burr&quot;</span><span class="p">,</span>
+    <span class="n">storage_dir</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="s2">"~/.burr"</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Application</span><span class="p">:</span>
     <span class="k">return</span> <span class="p">(</span>
         <span class="n">ApplicationBuilder</span><span class="p">()</span>
@@ -585,20 +586,20 @@ s=d.getElementsByTagName('script')[0];
             <span class="n">win</span><span class="o">=</span><span class="n">win</span><span class="p">,</span>
         <span class="p">)</span>
         <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-            <span class="p">(</span><span class="s2">&quot;start&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt_for_challenge&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;prompt_for_challenge&quot;</span><span class="p">,</span> <span class="s2">&quot;evaluate_attempt&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;evaluate_attempt&quot;</span><span class="p">,</span> <span class="s2">&quot;maybe_progress&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-            <span class="p">(</span><span class="s2">&quot;maybe_progress&quot;</span><span class="p">,</span> <span class="s2">&quot;win&quot;</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">did_win</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
-            <span class="p">(</span><span class="s2">&quot;maybe_progress&quot;</span><span class="p">,</span> <span class="s2">&quot;prompt_for_challenge&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"start"</span><span class="p">,</span> <span class="s2">"prompt_for_challenge"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"prompt_for_challenge"</span><span class="p">,</span> <span class="s2">"evaluate_attempt"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"evaluate_attempt"</span><span class="p">,</span> <span class="s2">"maybe_progress"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+            <span class="p">(</span><span class="s2">"maybe_progress"</span><span class="p">,</span> <span class="s2">"win"</span><span class="p">,</span> <span class="n">when</span><span class="p">(</span><span class="n">did_win</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span>
+            <span class="p">(</span><span class="s2">"maybe_progress"</span><span class="p">,</span> <span class="s2">"prompt_for_challenge"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
         <span class="p">)</span>
-        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;start&quot;</span><span class="p">)</span>
-        <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">&quot;demo_corgi_adventure&quot;</span><span class="p">,</span> <span class="n">params</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;storage_dir&quot;</span><span class="p">:</span> <span class="n">storage_dir</span><span class="p">})</span>
+        <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"start"</span><span class="p">)</span>
+        <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">"demo_corgi_adventure"</span><span class="p">,</span> <span class="n">params</span><span class="o">=</span><span class="p">{</span><span class="s2">"storage_dir"</span><span class="p">:</span> <span class="n">storage_dir</span><span class="p">})</span>
         <span class="o">.</span><span class="n">with_identifiers</span><span class="p">(</span><span class="n">app_id</span><span class="o">=</span><span class="n">app_id</span><span class="p">)</span>
         <span class="o">.</span><span class="n">build</span><span class="p">()</span>
     <span class="p">)</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">build_application</span><span class="p">()</span>
-<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">&quot;digraph&quot;</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="nb">format</span><s [...]
+<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">output_file_path</span><span class="o">=</span><span class="s2">"digraph"</span><span class="p">,</span> <span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">view</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="nb">format</span><span class= [...]
 </pre></div>
 </div>
 </div>
@@ -608,21 +609,21 @@ s=d.getElementsByTagName('script')[0];
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">state</span><span class="p">,</span> <span class="n">result</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;win&quot;</span><span class="p">])</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">action</span><span class="p">,</span> <span class="n">state</span><span class="p">,</span> <span class="n">result</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"win"</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
 <div class="cell_output docutils container">
 <div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>What happened: You opened your mouth and attempted to eat the food, but without the ability to manipulate the dish, you couldn’t reach the food. It remained untouched on the floor, taunting you with its delicious aroma.
-What happened: You tugged at the dish with your mouth, but your short legs can&#39;t provide enough strength to pull it any closer. The dish remains out of reach, and your belly rumbles in disappointment as you realize you can&#39;t manipulate it like you hoped.
-What happened: You approach the dish of dog food with eager anticipation, but as you try to lean over and take a bite, your short legs make it difficult to reach the food comfortably. You can&#39;t quite get your mouth to the dish, and after a few attempts, you realize you&#39;ll need a different plan to enjoy your meal.
+What happened: You tugged at the dish with your mouth, but your short legs can't provide enough strength to pull it any closer. The dish remains out of reach, and your belly rumbles in disappointment as you realize you can't manipulate it like you hoped.
+What happened: You approach the dish of dog food with eager anticipation, but as you try to lean over and take a bite, your short legs make it difficult to reach the food comfortably. You can't quite get your mouth to the dish, and after a few attempts, you realize you'll need a different plan to enjoy your meal.
 What happened: You try to bite the side of the dish to tip it over, but your short legs and limited strength make it impossible. The dish remains firmly on the floor, and the tantalizing smell of the dog food wafts up to you, teasing you further.
 </pre></div>
 </div>
 <div class="output traceback highlight-ipythontb notranslate"><div class="highlight"><pre><span></span><span class="gt">---------------------------------------------------------------------------</span>
 <span class="ne">KeyboardInterrupt</span><span class="g g-Whitespace">                         </span>Traceback (most recent call last)
 <span class="n">Cell</span> <span class="n">In</span><span class="p">[</span><span class="mi">15</span><span class="p">],</span> <span class="n">line</span> <span class="mi">1</span>
-<span class="ne">----&gt; </span><span class="mi">1</span> <span class="n">action</span><span class="p">,</span> <span class="n">state</span><span class="p">,</span> <span class="n">result</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;win&quot;</span><span class="p">])</span>
+<span class="ne">----&gt; </span><span class="mi">1</span> <span class="n">action</span><span class="p">,</span> <span class="n">state</span><span class="p">,</span> <span class="n">result</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"win"</span><span class="p">])</span>
 
 <span class="nn">File ~/dagworks/burr/burr/telemetry.py:276,</span> in <span class="ni">capture_function_usage.&lt;locals&gt;.wrapped_fn</span><span class="nt">(*args, **kwargs)</span>
 <span class="g g-Whitespace">    </span><span class="mi">273</span> <span class="nd">@functools</span><span class="o">.</span><span class="n">wraps</span><span class="p">(</span><span class="n">call_fn</span><span class="p">)</span>
@@ -663,7 +664,7 @@ What happened: You try to bite the side of the dish to tip it over, but your sho
 
 <span class="nn">File ~/dagworks/burr/burr/core/application.py:843,</span> in <span class="ni">Application.step</span><span class="nt">(self, inputs)</span>
 <span class="g g-Whitespace">    </span><span class="mi">840</span> <span class="c1"># we need to increment the sequence before we start computing</span>
-<span class="g g-Whitespace">    </span><span class="mi">841</span> <span class="c1"># that way if we&#39;re replaying from state, we don&#39;t get stuck</span>
+<span class="g g-Whitespace">    </span><span class="mi">841</span> <span class="c1"># that way if we're replaying from state, we don't get stuck</span>
 <span class="g g-Whitespace">    </span><span class="mi">842</span> <span class="bp">self</span><span class="o">.</span><span class="n">_increment_sequence_id</span><span class="p">()</span>
 <span class="ne">--&gt; </span><span class="mi">843</span> <span class="n">out</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_step</span><span class="p">(</span><span class="n">inputs</span><span class="o">=</span><span class="n">inputs</span><span class="p">,</span> <span class="n">_run_hooks</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 <span class="g g-Whitespace">    </span><span class="mi">844</span> <span class="k">return</span> <span class="n">out</span>
@@ -693,28 +694,28 @@ What happened: You try to bite the side of the dish to tip it over, but your sho
 <span class="ne">--&gt; </span><span class="mi">655</span>     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fn</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_bound_params</span><span class="p">,</span> <span class="o">**</span><span class="n">run_kwargs</span><span class="p">)</span>
 
 <span class="nn">Cell In[12], line 12,</span> in <span class="ni">prompt_for_challenge</span><span class="nt">(state)</span>
-<span class="g g-Whitespace">     </span><span class="mi">10</span><span class="w"> </span><span class="sd">&quot;&quot;&quot;Request user input to solve the current challenge&quot;&quot;&quot;</span>
-<span class="g g-Whitespace">     </span><span class="mi">11</span> <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;current_challenge&quot;</span><span class="p">]</span>
-<span class="ne">---&gt; </span><span class="mi">12</span> <span class="n">user_response</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">current_challenge</span><span class="si">}</span><span class="s1">. What do you do?</span><span class="se">\n</span><span class="s1"> $ &#39;</span><span class="p">)</span>
+<span class="g g-Whitespace">     </span><span class="mi">10</span><span class="w"> </span><span class="sd">"""Request user input to solve the current challenge"""</span>
+<span class="g g-Whitespace">     </span><span class="mi">11</span> <span class="n">current_challenge</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"current_challenge"</span><span class="p">]</span>
+<span class="ne">---&gt; </span><span class="mi">12</span> <span class="n">user_response</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="sa">f</span><span class="s1">'</span><span class="si">{</span><span class="n">current_challenge</span><span class="si">}</span><span class="s1">. What do you do?</span><span class="se">\n</span><span class="s1"> $ '</span><span class="p">)</span>
 <span class="g g-Whitespace">     </span><span class="mi">13</span> <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">attempts</span><span class="o">=</span><span class="n">user_response</span><span class="p">)</span>
 
 <span class="nn">File ~/.pyenv/versions/burr-py310/lib/python3.10/site-packages/ipykernel/kernelbase.py:1270,</span> in <span class="ni">Kernel.raw_input</span><span class="nt">(self, prompt)</span>
-<span class="g g-Whitespace">   </span><span class="mi">1268</span>     <span class="n">msg</span> <span class="o">=</span> <span class="s2">&quot;raw_input was called, but this frontend does not support input requests.&quot;</span>
+<span class="g g-Whitespace">   </span><span class="mi">1268</span>     <span class="n">msg</span> <span class="o">=</span> <span class="s2">"raw_input was called, but this frontend does not support input requests."</span>
 <span class="g g-Whitespace">   </span><span class="mi">1269</span>     <span class="k">raise</span> <span class="n">StdinNotImplementedError</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
 <span class="ne">-&gt; </span><span class="mi">1270</span> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_input_request</span><span class="p">(</span>
 <span class="g g-Whitespace">   </span><span class="mi">1271</span>     <span class="nb">str</span><span class="p">(</span><span class="n">prompt</span><span class="p">),</span>
-<span class="g g-Whitespace">   </span><span class="mi">1272</span>     <span class="bp">self</span><span class="o">.</span><span class="n">_parent_ident</span><span class="p">[</span><span class="s2">&quot;shell&quot;</span><span class="p">],</span>
-<span class="g g-Whitespace">   </span><span class="mi">1273</span>     <span class="bp">self</span><span class="o">.</span><span class="n">get_parent</span><span class="p">(</span><span class="s2">&quot;shell&quot;</span><span class="p">),</span>
+<span class="g g-Whitespace">   </span><span class="mi">1272</span>     <span class="bp">self</span><span class="o">.</span><span class="n">_parent_ident</span><span class="p">[</span><span class="s2">"shell"</span><span class="p">],</span>
+<span class="g g-Whitespace">   </span><span class="mi">1273</span>     <span class="bp">self</span><span class="o">.</span><span class="n">get_parent</span><span class="p">(</span><span class="s2">"shell"</span><span class="p">),</span>
 <span class="g g-Whitespace">   </span><span class="mi">1274</span>     <span class="n">password</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
 <span class="g g-Whitespace">   </span><span class="mi">1275</span> <span class="p">)</span>
 
 <span class="nn">File ~/.pyenv/versions/burr-py310/lib/python3.10/site-packages/ipykernel/kernelbase.py:1313,</span> in <span class="ni">Kernel._input_request</span><span class="nt">(self, prompt, ident, parent, password)</span>
 <span class="g g-Whitespace">   </span><span class="mi">1310</span> <span class="k">except</span> <span class="ne">KeyboardInterrupt</span><span class="p">:</span>
 <span class="g g-Whitespace">   </span><span class="mi">1311</span>     <span class="c1"># re-raise KeyboardInterrupt, to truncate traceback</span>
-<span class="g g-Whitespace">   </span><span class="mi">1312</span>     <span class="n">msg</span> <span class="o">=</span> <span class="s2">&quot;Interrupted by user&quot;</span>
+<span class="g g-Whitespace">   </span><span class="mi">1312</span>     <span class="n">msg</span> <span class="o">=</span> <span class="s2">"Interrupted by user"</span>
 <span class="ne">-&gt; </span><span class="mi">1313</span>     <span class="k">raise</span> <span class="ne">KeyboardInterrupt</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="kc">None</span>
 <span class="g g-Whitespace">   </span><span class="mi">1314</span> <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-<span class="g g-Whitespace">   </span><span class="mi">1315</span>     <span class="bp">self</span><span class="o">.</span><span class="n">log</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Invalid Message:&quot;</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="g g-Whitespace">   </span><span class="mi">1315</span>     <span class="bp">self</span><span class="o">.</span><span class="n">log</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">"Invalid Message:"</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 
 <span class="ne">KeyboardInterrupt</span>: Interrupted by user
 </pre></div>
diff --git a/content/docs/examples/simple/counter/index.html b/content/docs/examples/simple/counter/index.html
index 0e881a62..788a7dec 100644
--- a/content/docs/examples/simple/counter/index.html
+++ b/content/docs/examples/simple/counter/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -453,26 +454,26 @@ s=d.getElementsByTagName('script')[0];
 <p>We define the function <code class="docutils literal notranslate"><span class="pre">increment()</span></code> that has a <code class="docutils literal notranslate"><span class="pre">State</span></code> as input and outputs a new <code class="docutils literal notranslate"><span class="pre">State</span></code>. The decorator <code class="docutils literal notranslate"><span class="pre">&#64;action</span></code> specifies it’s a Burr action and it will need to read and write from the <cod [...]
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">])</span>
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">increment</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Increment the counter by 1&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">"""Increment the counter by 1"""</span>
     
     <span class="c1"># get the value from the `state`</span>
-    <span class="n">current_count</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">]</span>
+    <span class="n">current_count</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">]</span>
     <span class="n">current_count</span> <span class="o">+=</span> <span class="mi">1</span>
 
-    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Count: &quot;</span><span class="p">,</span> <span class="n">current_count</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">"Count: "</span><span class="p">,</span> <span class="n">current_count</span><span class="p">)</span>
 
     <span class="c1"># use `.update()` to create a new `State`</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">counter</span><span class="o">=</span><span class="n">current_count</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">exit_counter</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Print the current count and the current time&quot;&quot;&quot;</span>
-    <span class="n">current_count</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;counter&quot;</span><span class="p">]</span>
+<span class="w">    </span><span class="sd">"""Print the current count and the current time"""</span>
+    <span class="n">current_count</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">"counter"</span><span class="p">]</span>
 
-    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Finished counting to </span><span class="si">{</span><span class="n">current_count</span><span class="si">}</span><span class="s2"> at </span><span class="si">{</span><span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">()</span><span class="si">:</span><span class="s2">%H:%M:%S %Y-%m-%d [...]
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Finished counting to </span><span class="si">{</span><span class="n">current_count</span><span class="si">}</span><span class="s2"> at </span><span class="si">{</span><span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">()</span><span class="si">:</span><span class="s2">%H:%M:%S %Y-%m-%d</spa [...]
 
     <span class="k">return</span> <span class="n">state</span>
 </pre></div>
@@ -489,11 +490,11 @@ s=d.getElementsByTagName('script')[0];
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">increment</span><span class="p">,</span> <span class="n">exit_counter</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;increment&quot;</span><span class="p">,</span> <span class="s2">&quot;increment&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;counter &lt; 10&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;increment&quot;</span><span class="p">,</span> <span class="s2">&quot;exit_counter&quot;</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"increment"</span><span class="p">,</span> <span class="s2">"increment"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"counter &lt; 10"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"increment"</span><span class="p">,</span> <span class="s2">"exit_counter"</span><span class="p">),</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">counter</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;increment&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"increment"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 <span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">include_conditions</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -506,7 +507,7 @@ s=d.getElementsByTagName('script')[0];
 </div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
-<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">action_obj</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;exit_counter&quot;</span><span class= [...]
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">action_obj</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"exit_counter"</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
diff --git a/content/docs/examples/simple/cowsay/index.html b/content/docs/examples/simple/cowsay/index.html
index b3b9902a..25f39e92 100644
--- a/content/docs/examples/simple/cowsay/index.html
+++ b/content/docs/examples/simple/cowsay/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,14 +419,14 @@ s=d.getElementsByTagName('script')[0];
 <span class="c1"># distributed with this work for additional information</span>
 <span class="c1"># regarding copyright ownership.  The ASF licenses this file</span>
 <span class="c1"># to you under the Apache License, Version 2.0 (the</span>
-<span class="c1"># &quot;License&quot;); you may not use this file except in compliance</span>
+<span class="c1"># "License"); you may not use this file except in compliance</span>
 <span class="c1"># with the License.  You may obtain a copy of the License at</span>
 <span class="c1">#</span>
 <span class="c1">#   http://www.apache.org/licenses/LICENSE-2.0</span>
 <span class="c1">#</span>
 <span class="c1"># Unless required by applicable law or agreed to in writing,</span>
 <span class="c1"># software distributed under the License is distributed on an</span>
-<span class="c1"># &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
+<span class="c1"># "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span>
 <span class="c1"># KIND, either express or implied.  See the License for the</span>
 <span class="c1"># specific language governing permissions and limitations</span>
 <span class="c1"># under the License.</span>
@@ -454,9 +455,9 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># create some hooks!</span>
 <span class="k">class</span><span class="w"> </span><span class="nc">PrintWhatTheCowSaid</span><span class="p">(</span><span class="n">PostRunStepHook</span><span class="p">):</span>
-    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">&quot;State&quot;</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">&quot;Action&quot;</span><span class="p">,</span> <span class="o">**</span><span clas [...]
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="s2">&quot;cow_should_say&quot;</span> <span class="ow">and</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;cow_said&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;cow_said&quot;</span><span class="p">])</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">"State"</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">"Action"</span><span class="p">,</span> <span class="o">**</span><span class="n">future_kwargs< [...]
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="s2">"cow_should_say"</span> <span class="ow">and</span> <span class="n">state</span><span class="p">[</span><span class="s2">"cow_said"</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"cow_said"</span><span class="p">])</span>
 
 
 <span class="k">class</span><span class="w"> </span><span class="nc">CowCantSpeakFast</span><span class="p">(</span><span class="n">PostRunStepHook</span><span class="p">):</span>
@@ -464,8 +465,8 @@ s=d.getElementsByTagName('script')[0];
         <span class="nb">super</span><span class="p">(</span><span class="n">PostRunStepHook</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">sleep_time</span> <span class="o">=</span> <span class="n">sleep_time</span>
 
-    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">&quot;State&quot;</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">&quot;Action&quot;</span><span class="p">,</span> <span class="o">**</span><span clas [...]
-        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="s2">&quot;cow_should_say&quot;</span><span class="p">:</span>  <span class="c1"># no need to print if we&#39;re not saying anything</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">post_run_step</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="s2">"State"</span><span class="p">,</span> <span class="n">action</span><span class="p">:</span> <span class="s2">"Action"</span><span class="p">,</span> <span class="o">**</span><span class="n">future_kwargs< [...]
+        <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="s2">"cow_should_say"</span><span class="p">:</span>  <span class="c1"># no need to print if we're not saying anything</span>
             <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sleep_time</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -474,16 +475,16 @@ s=d.getElementsByTagName('script')[0];
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># instantiate actions</span>
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;cow_said&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"cow_said"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">cow_said</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">say_what</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span clas [...]
     <span class="n">said</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">say_what</span><span class="p">)</span> <span class="k">if</span> <span class="n">say_what</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="k">else</span> <span class="kc">None</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;cow_said&quot;</span><span class="p">:</span> <span class="n">cowsay</span><span class="o">.</span><span class="n">get_output_string</span><span class="p">(</span><span class="s2">&quot;cow&quot;</span><span class="p">,</span> <span class="n">said</span><span class="p">)</span> <span class="k">if</span> <span class="n">say_what</span> <span class="ow">is</span> <span class="ow">not</ [...]
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"cow_said"</span><span class="p">:</span> <span class="n">cowsay</span><span class="o">.</span><span class="n">get_output_string</span><span class="p">(</span><span class="s2">"cow"</span><span class="p">,</span> <span class="n">said</span><span class="p">)</span> <span class="k">if</span> <span class="n">say_what</span> <span class="ow">is</span> <span class="ow">not</span> <span class="k [...]
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"cow_should_speak"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">cow_should_speak</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p">]:</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">:</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">}</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">{</span><span class="s2">"cow_should_speak"</span><span class="p">:</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">}</span>
     <span class="k">return</span> <span class="n">result</span><span class="p">,</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="o">**</span><span class="n">result</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -502,17 +503,17 @@ s=d.getElementsByTagName('script')[0];
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
         <span class="n">say_nothing</span><span class="o">=</span><span class="n">cow_said</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">say_what</span><span class="o">=</span><span class="kc">None</span><span class="p">),</span>
         <span class="n">say_hello</span><span class="o">=</span><span class="n">cow_said</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span>
-            <span class="n">say_what</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;Hello world!&quot;</span><span class="p">,</span> <span class="s2">&quot;What&#39;s up?&quot;</span><span class="p">,</span> <span class="s2">&quot;Are you Aaron Burr, sir?&quot;</span><span class="p">]</span>
+            <span class="n">say_what</span><span class="o">=</span><span class="p">[</span><span class="s2">"Hello world!"</span><span class="p">,</span> <span class="s2">"What's up?"</span><span class="p">,</span> <span class="s2">"Are you Aaron Burr, sir?"</span><span class="p">]</span>
         <span class="p">),</span>
         <span class="n">cow_should_speak</span><span class="o">=</span><span class="n">cow_should_speak</span><span class="p">,</span>
     <span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">,</span> <span class="s2">&quot;say_hello&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;say_hello&quot;</span><span class="p">,</span> <span class="s2">&quot;cow_should_speak&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">,</span> <span class="s2">&quot;say_nothing&quot;</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">&quot;not cow_should_speak&quot;</span><span class="p">)),</span>
-        <span class="p">(</span><span class="s2">&quot;say_nothing&quot;</span><span class="p">,</span> <span class="s2">&quot;cow_should_speak&quot;</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"cow_should_speak"</span><span class="p">,</span> <span class="s2">"say_hello"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"cow_should_speak"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"say_hello"</span><span class="p">,</span> <span class="s2">"cow_should_speak"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"cow_should_speak"</span><span class="p">,</span> <span class="s2">"say_nothing"</span><span class="p">,</span> <span class="n">expr</span><span class="p">(</span><span class="s2">"not cow_should_speak"</span><span class="p">)),</span>
+        <span class="p">(</span><span class="s2">"say_nothing"</span><span class="p">,</span> <span class="s2">"cow_should_speak"</span><span class="p">,</span> <span class="n">default</span><span class="p">),</span>
     <span class="p">)</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;cow_should_speak&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"cow_should_speak"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="o">*</span><span class="n">hooks</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
@@ -551,7 +552,7 @@ s=d.getElementsByTagName('script')[0];
 </div>
 <div class="cell_output docutils container">
 <div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>  __________
-| What&#39;s up? |
+| What's up? |
   ==========
           \
            \
@@ -561,7 +562,7 @@ s=d.getElementsByTagName('script')[0];
                  ||----w |
                  ||     ||
   __________
-| What&#39;s up? |
+| What's up? |
   ==========
           \
            \
diff --git a/content/docs/examples/simple/index.html b/content/docs/examples/simple/index.html
index 2e3258e0..3c02ad00 100644
--- a/content/docs/examples/simple/index.html
+++ b/content/docs/examples/simple/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/genindex/index.html b/content/docs/genindex/index.html
index 590e3e3c..0ae25c8e 100644
--- a/content/docs/genindex/index.html
+++ b/content/docs/genindex/index.html
@@ -305,6 +305,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/getting_started/index.html b/content/docs/getting_started/index.html
index 91042f33..3065848e 100644
--- a/content/docs/getting_started/index.html
+++ b/content/docs/getting_started/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/getting_started/install/index.html b/content/docs/getting_started/install/index.html
index 23779d8d..70811ea1 100644
--- a/content/docs/getting_started/install/index.html
+++ b/content/docs/getting_started/install/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -416,7 +417,7 @@ s=d.getElementsByTagName('script')[0];
 <p>Burr itself requires no dependencies. Every <em>extra</em>/<em>plugin</em> is an additional install target.</p>
 <p>We recommend you start with installing the <code class="docutils literal notranslate"><span class="pre">start</span></code> target – this has dependencies necessary to track burr through the UI,
 along with a fully built server.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[start]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[start]"</span>
 </pre></div>
 </div>
 <p>This will give you tools to visualize, track, and interact with the UI. You can explore the UI (including some sample projects)
@@ -424,7 +425,7 @@ simply by running the command <code class="docutils literal notranslate"><span c
 <p>If you’re using poetry, you can’t install the <code class="docutils literal notranslate"><span class="pre">start</span></code> target directly, due to
 <a class="reference external" href="https://github.com/python-poetry/poetry/issues/3369">this issue</a>.
 Instead, please install manually using the following command:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>poetry<span class="w"> </span>add<span class="w"> </span>loguru<span class="w"> </span><span class="s2">&quot;apache-burr[tracking-client,tracking-server,streamlit,graphviz,hamilton]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>poetry<span class="w"> </span>add<span class="w"> </span>loguru<span class="w"> </span><span class="s2">"apache-burr[tracking-client,tracking-server,streamlit,graphviz,hamilton]"</span>
 </pre></div>
 </div>
 <p>This is just the kitchen sink for getting started – remember, burr is dependency-free/pure python!</p>
@@ -436,87 +437,87 @@ Instead, please install manually using the following command:</p>
 <p>This only installs the framework. Zero other dependencies. All other installs below all install the
 framework + some other dependencies. Note you can combine installing multiple optional dependencies with commas, e.g.
 <code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">&quot;apache-burr[cli,tracking]&quot;</span></code> installs both the CLI and tracking + UI dependencies.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[cli]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[cli]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies to run the burr CLI, i.e. <cite>burr –help</cite>.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[developer]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[developer]"</span>
 </pre></div>
 </div>
 <p>This installs all the dependencies for developing locally.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[documentation]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[documentation]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies to build the documentation.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[examples]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[examples]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for the examples.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[graphviz]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[graphviz]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies to visualize the graph.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[hamilton]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[hamilton]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for Hamilton.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[haystack]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[haystack]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for Haystack.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[learn]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[learn]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for the UI, CLI, and running demos. It is equivalent to <cite>start</cite> below.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[opentelemetry]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[opentelemetry]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for using OpenTelemetry with Burr.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[postgresql]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[postgresql]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for PostgreSQL.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[pydantic]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[pydantic]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for Pydantic.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[redis]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[redis]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for Redis.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[start]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[start]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for the UI, CLI, and running demos. It is equivalent to <cite>learn</cite> above.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[streamlit]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[streamlit]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for Streamlit.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tests]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tests]"</span>
 </pre></div>
 </div>
 <p>This installs the dependencies for running unit tests.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tracking]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tracking]"</span>
 </pre></div>
 </div>
 <p>This installs the client and server dependencies for tracking and running the UI from tracking that is on a filesystem.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tracking-client]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tracking-client]"</span>
 </pre></div>
 </div>
 <p>This installs the client dependencies for tracking to a filesystem.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tracking-client-s3]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tracking-client-s3]"</span>
 </pre></div>
 </div>
 <p>This installs the client dependencies for tracking to S3.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tracking-server-s3]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tracking-server-s3]"</span>
 </pre></div>
 </div>
 <p>This installs the server dependencies to run the UI and load tracking that was sent to S3.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[tracking-server]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[tracking-server]"</span>
 </pre></div>
 </div>
 <p>This installs the server dependencies for running the UI off a filesystem.</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[bedrock]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[bedrock]"</span>
 </pre></div>
 </div>
 <p>This installs <code class="docutils literal notranslate"><span class="pre">boto3</span></code> for the <a class="reference internal" href="../../reference/integrations/bedrock/#bedrock-integration"><span class="std std-ref">Amazon Bedrock integration</span></a> (<code class="docutils literal notranslate"><span class="pre">BedrockAction</span></code> / <code class="docutils literal notranslate"><span class="pre">BedrockStreamingAction</span></code>).</p>
diff --git a/content/docs/getting_started/simple-example/index.html b/content/docs/getting_started/simple-example/index.html
index f5bc7495..2dda4bea 100644
--- a/content/docs/getting_started/simple-example/index.html
+++ b/content/docs/getting_started/simple-example/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -450,24 +451,24 @@ computes a result and modifies state. They declare what they read and write.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Note: you can replace this with your favorite LLM Client</span>
 <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">human_input</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span>
     <span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
 
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">ai_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">content</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-3.5-turbo&quot;</span><span class="p">,</span>
-        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+        <span class="n">model</span><span class="o">=</span><span class="s2">"gpt-3.5-turbo"</span><span class="p">,</span>
+        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span>
     <span class="p">)</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">message</span><span class="o">.</span><span class="n">content</span>
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;assistant&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span>
     <span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">content</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
 </pre></div>
@@ -489,16 +490,16 @@ the intermediate result of the computation), to help with debugging. There are a
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
 </div>
 <p>We can visualize the application (note you need <code class="docutils literal notranslate"><span class="pre">burr[graphviz]</span></code> installed):</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="s2">&quot;./graph&quot;</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">&quot;png&quot;</span><span class="p">)</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="s2">"./graph"</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">"png"</span><span class="p">)</span>
 </pre></div>
 </div>
 <img alt="../../_images/chatbot.png" class="align-center" src="../../_images/chatbot.png" />
@@ -510,9 +511,9 @@ the intermediate result of the computation), to help with debugging. There are a
 <li><p>It utilizes a <a class="reference external" href="https://en.wikipedia.org/wiki/Builder_pattern#:~:text=The%20builder%20pattern%20is%20a,Gang%20of%20Four%20design%20patterns">builder pattern</a> – this is a bit old-school (comes from the java days), but is an easy/modular way to express your application</p></li>
 </ol>
 <p>Finally, we can run the application – it gives back multiple pieces of information but all we’ll use is the state.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="o">*</span><span class="n">_</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> <span class="n">inputs</span [...]
-<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;answer:&quot;</span><span class="p">,</span> <span class="n">app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
-<span class="nb">print</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">]),</span> <span class="s2">&quot;items in chat&quot;</span><span class="p">)</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="o">*</span><span class="n">_</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">],</span> <span class="n">inputs</span><span cla [...]
+<span class="nb">print</span><span class="p">(</span><span class="s2">"answer:"</span><span class="p">,</span> <span class="n">app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">]),</span> <span class="s2">"items in chat"</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>The result looks exactly as you’d expect!</p>
@@ -534,40 +535,40 @@ and his reputation was tarnished by suspicions of treason and conspiracy.
 
 <span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>  <span class="c1"># replace this if not using OpenAI</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">human_input</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">prompt</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span>
     <span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;chat_history&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"chat_history"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">ai_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="n">content</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-3.5-turbo&quot;</span><span class="p">,</span>
-        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">],</span>
+        <span class="n">model</span><span class="o">=</span><span class="s2">"gpt-3.5-turbo"</span><span class="p">,</span>
+        <span class="n">messages</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">],</span>
     <span class="p">)</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">message</span><span class="o">.</span><span class="n">content</span>
     <span class="n">chat_item</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
-        <span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;assistant&quot;</span>
+        <span class="s2">"content"</span><span class="p">:</span> <span class="n">content</span><span class="p">,</span>
+        <span class="s2">"role"</span><span class="p">:</span> <span class="s2">"assistant"</span>
     <span class="p">}</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">content</span><span class="p">)</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="n">chat_item</span><span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">human_input</span><span class="p">,</span> <span class="n">ai_response</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span>
-        <span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">,</span> <span class="s2">&quot;ai_response&quot;</span><span class="p">),</span>
-        <span class="p">(</span><span class="s2">&quot;ai_response&quot;</span><span class="p">,</span> <span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+        <span class="p">(</span><span class="s2">"human_input"</span><span class="p">,</span> <span class="s2">"ai_response"</span><span class="p">),</span>
+        <span class="p">(</span><span class="s2">"ai_response"</span><span class="p">,</span> <span class="s2">"human_input"</span><span class="p">)</span>
     <span class="p">)</span><span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;human_input&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"human_input"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 
-<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="s2">&quot;./graph&quot;</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">&quot;png&quot;</span><span class="p">)</span>
-<span class="o">*</span><span class="n">_</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;ai_response&quot;</span><span class="p">],</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot [...]
-<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;answer:&quot;</span><span class="p">,</span> <span class="n">app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
-<span class="nb">print</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;chat_history&quot;</span><span class="p">]),</span> <span class="s2">&quot;items in chat&quot;</span><span class="p">)</span>
+<span class="n">app</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="s2">"./graph"</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">"png"</span><span class="p">)</span>
+<span class="o">*</span><span class="n">_</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"ai_response"</span><span class="p">],</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class= [...]
+<span class="nb">print</span><span class="p">(</span><span class="s2">"answer:"</span><span class="p">,</span> <span class="n">app</span><span class="o">.</span><span class="n">state</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"chat_history"</span><span class="p">]),</span> <span class="s2">"items in chat"</span><span class="p">)</span>
 </pre></div>
 </div>
 </details><p>Finally, let’s open up the UI and see what it looks like (note, that if you have not installed <code class="docutils literal notranslate"><span class="pre">burr[learn]</span></code> now is a good time…).</p>
diff --git a/content/docs/getting_started/up-next/index.html b/content/docs/getting_started/up-next/index.html
index 573904b9..f32fd2bc 100644
--- a/content/docs/getting_started/up-next/index.html
+++ b/content/docs/getting_started/up-next/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/getting_started/why-burr/index.html b/content/docs/getting_started/why-burr/index.html
index 0e781dc2..4079da15 100644
--- a/content/docs/getting_started/why-burr/index.html
+++ b/content/docs/getting_started/why-burr/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/index.html b/content/docs/index.html
index 97335003..0ff3fac9 100644
--- a/content/docs/index.html
+++ b/content/docs/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/main/index.html b/content/docs/main/index.html
index 7347b2e6..e94ab052 100644
--- a/content/docs/main/index.html
+++ b/content/docs/main/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/objects.inv b/content/docs/objects.inv
index 8ebb2acd..833697bd 100644
Binary files a/content/docs/objects.inv and b/content/docs/objects.inv differ
diff --git a/content/docs/py-modindex/index.html b/content/docs/py-modindex/index.html
index f7639412..6eaa2e6e 100644
--- a/content/docs/py-modindex/index.html
+++ b/content/docs/py-modindex/index.html
@@ -305,6 +305,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/actions/index.html b/content/docs/reference/actions/index.html
index bb44ca38..f0563995 100644
--- a/content/docs/reference/actions/index.html
+++ b/content/docs/reference/actions/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -857,9 +858,9 @@ If this is None it will attempt to derive from the signature.</p></li>
 <dd><p>Binds an action to the given parameters. This is functionally equivalent to
 functools.partial, but is more explicit and is meant to be used in the API. This only works with
 the <a class="reference internal" href="#burr.core.action.action" title="burr.core.action.action"><code class="xref py py-meth docutils literal notranslate"><span class="pre">&#64;action</span></code></a>  functional API and not with the class-based API.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">([</span><span class="s2">&quot;x&quot;</span><span class="p">],</span> <span class="p">[</span><span class="s2">&quot;y&quot;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">([</span><span class="s2">"x"</span><span class="p">],</span> <span class="p">[</span><span class="s2">"y"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">z</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span><span class="p" [...]
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;y&quot;</span><span class="p">:</span> <span class="n">state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;x&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">z</span><span class="p">},</span> <span class="n">state</span>
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"y"</span><span class="p">:</span> <span class="n">state</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"x"</span><span class="p">)</span> <span class="o">+</span> <span class="n">z</span><span class="p">},</span> <span class="n">state</span>
 
 <span class="n">my_action</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">z</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
 </pre></div>
@@ -1030,10 +1031,10 @@ never instantiate this class directly, but you will use it in the API when it is
 by <a class="reference internal" href="../application/#burr.core.application.Application.stream_result" title="burr.core.application.Application.stream_result"><code class="xref py py-meth docutils literal notranslate"><span class="pre">stream_result</span></code></a>.
 For reference, here’s how you would use it:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action_we_just_ran</span><span class="p">,</span> <span class="n">streaming_result_container</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;getting streaming results for action=</span><span class="si">{</span><span class="n">action_we_just_ran</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"getting streaming results for action=</span><span class="si">{</span><span class="n">action_we_just_ran</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 
 <span class="k">for</span> <span class="n">result_component</span> <span class="ow">in</span> <span class="n">streaming_result_container</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">result_component</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span> <span class="c1"># this assumes you have a response key in your result</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">result_component</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span> <span class="c1"># this assumes you have a response key in your result</span>
 
 <span class="n">final_result</span><span class="p">,</span> <span class="n">final_state</span> <span class="o">=</span> <span class="n">streaming_result_container</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
 </pre></div>
@@ -1077,10 +1078,10 @@ never instantiate this class directly, but you will use it in the API when it is
 by <a class="reference internal" href="../application/#burr.core.application.Application.stream_result" title="burr.core.application.Application.stream_result"><code class="xref py py-meth docutils literal notranslate"><span class="pre">astream_result</span></code></a>.
 For reference, here’s how you would use it:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">action_we_just_ran</span><span class="p">,</span> <span class="n">streaming_result_container</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
-<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;getting streaming results for action=</span><span class="si">{</span><span class="n">action_we_just_ran</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"getting streaming results for action=</span><span class="si">{</span><span class="n">action_we_just_ran</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
 
 <span class="k">async</span> <span class="k">for</span> <span class="n">result_component</span> <span class="ow">in</span> <span class="n">streaming_result_container</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">result_component</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span> <span class="c1"># this assumes you have a response key in your result</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">result_component</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span> <span class="c1"># this assumes you have a response key in your result</span>
 
 <span class="n">final_result</span><span class="p">,</span> <span class="n">final_state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">streaming_result_container</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
 </pre></div>
@@ -1182,10 +1183,10 @@ they run in multiple passes (run -&gt; update)</p>
 <p>For instance, you could have:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">stream_run</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <spa [...]
     <span class="n">buffer</span> <span class="o">=</span> <span class="p">[]</span> <span class="c1"># you might want to be more efficient than simple strcat</span>
-    <span class="k">for</span> <span class="n">token</span> <span class="ow">in</span> <span class="n">query</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">]):</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span> <span class="p">:</span> <span class="n">token</span><span class="p">}</span>
+    <span class="k">for</span> <span class="n">token</span> <span class="ow">in</span> <span class="n">query</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">]):</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span> <span class="p">:</span> <span class="n">token</span><span class="p">}</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">token</span><span class="p">)</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span> <span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)}</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span> <span class="p">:</span> <span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)}</span>
 </pre></div>
 </div>
 <p>This would utilize a simple string buffer (implemented by a list) to store the results
diff --git a/content/docs/reference/application/index.html b/content/docs/reference/application/index.html
index ca52b152..3cc451ac 100644
--- a/content/docs/reference/application/index.html
+++ b/content/docs/reference/application/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -1103,13 +1104,13 @@ is thrown during streaming, or the stream is completed. Note that it is undefine
 <p>To see how this works, let’s take the following action (simplified as a single-node workflow) as an example:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">client</span> <span class="o">=</span> <span class="n">openai</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">()</span>
 
-<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">streaming_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</spa [...]
     <span class="n">response</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-            <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-            <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">prompt</span>
+            <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+            <span class="s1">'content'</span><span class="p">:</span> <span class="n">prompt</span>
             <span class="p">}],</span>
         <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
     <span class="p">)</span>
@@ -1118,23 +1119,23 @@ is thrown during streaming, or the stream is completed. Note that it is undefine
         <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
         <span class="c1"># yield partial results</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># indicate that we are not done by returning a `None` state!</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># indicate that we are not done by returning a `None` state!</span>
     <span class="c1"># make sure to join with the buffer!</span>
-    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
     <span class="c1"># yield the final result at the end + the state update</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>To use streaming_result, you pass in names of streaming actions (such as the one above) to the halt_after
 parameter:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">application</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p"> [...]
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span>< [...]
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</ [...]
 <span class="k">async</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span> <span class="c1"># one by one</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span> <span class="c1"># one by one</span>
 
 <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">streaming_result</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
-<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span> <span class="c1">#  all at once</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span> <span class="c1">#  all at once</span>
 </pre></div>
 </div>
 <p>Note that if you have multiple halt_after conditions, you can use the <code class="docutils literal notranslate"><span class="pre">.action</span></code> attribute to get the action that
@@ -1143,26 +1144,26 @@ was run.</p>
     <span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">,</span>
     <span class="n">error</span><span class="o">=</span><span class="n">error</span> <span class="c1"># another function that outputs an error, streaming</span>
 <span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p">()</span>
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s [...]
-<span class="n">color</span> <span class="o">=</span> <span class="s2">&quot;red&quot;</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;error&quot;</span> <span class="k">else</span> <span class="s2">&quot;green&quot;</span>
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prom [...]
+<span class="n">color</span> <span class="o">=</span> <span class="s2">"red"</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"error"</span> <span class="k">else</span> <span class="s2">"green"</span>
 <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
+    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
 </pre></div>
 </div>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">application</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">,</span>
     <span class="n">error</span><span class="o">=</span><span class="n">non_streaming_error</span> <span class="c1"># a non-streaming function that outputs an error</span>
 <span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p">()</span>
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s [...]
-<span class="n">color</span> <span class="o">=</span> <span class="s2">&quot;red&quot;</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;error&quot;</span> <span class="k">else</span> <span class="s2">&quot;green&quot;</span>
-<span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;streaming_response&quot;</span><span class="p">:</span> <span class="c1"># can also use the ``.streaming`` attribute of action</span>
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">application</span><span class="o">.</span><span class="n">astream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prom [...]
+<span class="n">color</span> <span class="o">=</span> <span class="s2">"red"</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"error"</span> <span class="k">else</span> <span class="s2">"green"</span>
+<span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"streaming_response"</span><span class="p">:</span> <span class="c1"># can also use the ``.streaming`` attribute of action</span>
     <span class="k">async</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
-         <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
+         <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
 <span class="k">else</span><span class="p">:</span>
     <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="k">await</span> <span class="n">output</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
-    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span>
 </pre></div>
 </div>
 </dd></dl>
@@ -1466,13 +1467,13 @@ halt_after condition.</p>
 hooks, callbacks, etc… so you can take the control flow and still have state updated afterwards. Hooks/state update will be called after an exception
 is thrown during streaming, or the stream is completed. Note that it is undefined behavior to attempt to execute another action while a stream is in progress.</p>
 <p>To see how this works, let’s take the following action (simplified as a single-node workflow) as an example:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@streaming_action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">streaming_response</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="kc">None</spa [...]
     <span class="n">response</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">chat</span><span class="o">.</span><span class="n">completions</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-        <span class="n">model</span><span class="o">=</span><span class="s1">&#39;gpt-3.5-turbo&#39;</span><span class="p">,</span>
+        <span class="n">model</span><span class="o">=</span><span class="s1">'gpt-3.5-turbo'</span><span class="p">,</span>
         <span class="n">messages</span><span class="o">=</span><span class="p">[{</span>
-            <span class="s1">&#39;role&#39;</span><span class="p">:</span> <span class="s1">&#39;user&#39;</span><span class="p">,</span>
-            <span class="s1">&#39;content&#39;</span><span class="p">:</span> <span class="n">prompt</span>
+            <span class="s1">'role'</span><span class="p">:</span> <span class="s1">'user'</span><span class="p">,</span>
+            <span class="s1">'content'</span><span class="p">:</span> <span class="n">prompt</span>
             <span class="p">}],</span>
         <span class="n">temperature</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
     <span class="p">)</span>
@@ -1481,19 +1482,19 @@ is thrown during streaming, or the stream is completed. Note that it is undefine
         <span class="n">delta</span> <span class="o">=</span> <span class="n">chunk</span><span class="o">.</span><span class="n">choices</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">delta</span><span class="o">.</span><span class="n">content</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">delta</span><span class="p">)</span>
         <span class="c1"># yield partial results</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># indicate that we are not done by returning a `None` state!</span>
-    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">delta</span><span class="p">},</span> <span class="kc">None</span> <span class="c1"># indicate that we are not done by returning a `None` state!</span>
+    <span class="n">full_response</span> <span class="o">=</span> <span class="s1">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span>
     <span class="c1"># return the final result</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span><span class="p">:</span> <span class="n">full_response</span><span class="p">},</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">full_response</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>To use streaming_result, you pass in names of streaming actions (such as the one above) to the halt_after
 parameter:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">application</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p"> [...]
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><s [...]
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</s [...]
 <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">])</span> <span class="c1"># one by one</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">])</span> <span class="c1"># one by one</span>
 
 <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">streaming_result</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
 <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="c1">#  all at once</span>
@@ -1505,26 +1506,26 @@ was run.</p>
     <span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">,</span>
     <span class="n">error</span><span class="o">=</span><span class="n">error</span> <span class="c1"># another function that outputs an error, streaming</span>
 <span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p">()</span>
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><s [...]
-<span class="n">color</span> <span class="o">=</span> <span class="s2">&quot;red&quot;</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;error&quot;</span> <span class="k">else</span> <span class="s2">&quot;green&quot;</span>
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</s [...]
+<span class="n">color</span> <span class="o">=</span> <span class="s2">"red"</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"error"</span> <span class="k">else</span> <span class="s2">"green"</span>
 <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">streaming_result</span><span class="p">:</span>
-    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
+    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
 </pre></div>
 </div>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">application</span> <span class="o">=</span> <span class="n">ApplicationBuilder</span><span class="p">()</span><span class="o">.</span><span class="n">with_actions</span><span class="p">(</span>
     <span class="n">streaming_response</span><span class="o">=</span><span class="n">streaming_response</span><span class="p">,</span>
     <span class="n">error</span><span class="o">=</span><span class="n">non_streaming_error</span> <span class="c1"># a non-streaming function that outputs an error</span>
 <span class="p">)</span><span class="o">...</span><span class="n">build</span><span class="p">()</span>
-<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ...&quot;</span>
-<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">&#39;streaming_response&#39;</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;prompt&quot;</span><s [...]
-<span class="n">color</span> <span class="o">=</span> <span class="s2">&quot;red&quot;</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;error&quot;</span> <span class="k">else</span> <span class="s2">&quot;green&quot;</span>
-<span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;streaming_response&quot;</span><span class="p">:</span> <span class="c1"># can also use the ``.streaming`` attribute of action</span>
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">"Count to 100, with a comma between each number and no newlines. E.g., 1, 2, 3, ..."</span>
+<span class="n">action</span><span class="p">,</span> <span class="n">streaming_result</span> <span class="o">=</span> <span class="n">application</span><span class="o">.</span><span class="n">stream_result</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="s1">'streaming_response'</span><span class="p">,</span> <span class="n">inputs</span><span class="o">=</span><span class="p">{</span><span class="s2">"prompt"</span><span class="p">:</s [...]
+<span class="n">color</span> <span class="o">=</span> <span class="s2">"red"</span> <span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"error"</span> <span class="k">else</span> <span class="s2">"green"</span>
+<span class="k">if</span> <span class="n">action</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">"streaming_response"</span><span class="p">:</span> <span class="c1"># can also use the ``.streaming`` attribute of action</span>
     <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">output</span><span class="p">:</span>
-         <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
+         <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span> <span class="c1"># assumes that error and streaming_response both have the same output shape</span>
 <span class="k">else</span><span class="p">:</span>
     <span class="n">result</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">output</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
-    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">&#39;response&#39;</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="nb">format</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s1">'response'</span><span class="p">],</span> <span class="n">color</span><span class="p">))</span>
 </pre></div>
 </div>
 </dd></dl>
diff --git a/content/docs/reference/conditions/index.html b/content/docs/reference/conditions/index.html
index 0a595fbf..6c54b13a 100644
--- a/content/docs/reference/conditions/index.html
+++ b/content/docs/reference/conditions/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -466,9 +467,9 @@ If you want a condition that defaults to true, use Condition.default or just def
 <dd><p>Combines two conditions with an AND operator. This will return a new condition
 that is the AND of the two conditions.</p>
 <p>To check if both foo is bar and baz is qux:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">)</span> <span class="o">&amp;</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(< [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">)</span> <span class="o">&amp;</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><spa [...]
 <span class="c1"># equivalent to</span>
-<span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">,</span> <span class="n">baz</span><span class="o">=</span><span class="s2">&quot;qux&quot;</span><span class="p">)</span>
+<span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">,</span> <span class="n">baz</span><span class="o">=</span><span class="s2">"qux"</span><span class="p">)</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
@@ -487,7 +488,7 @@ that is the AND of the two conditions.</p>
 <dd><p>Combines two conditions with an OR operator. This will return a new condition
 that is the OR of the two conditions.</p>
 <p>To check if either foo is bar or baz is qux:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">)</span> <span class="o">|</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</spa [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">condition</span> <span class="o">=</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">)</span> <span class="o">|</span> <span class="n">Condition</span><span class="o">.</span><span class="n">when</span><span class="p">(</span><span cl [...]
 </pre></div>
 </div>
 <dl class="field-list simple">
@@ -650,32 +651,32 @@ comprehensions and generator expressions, the walrus operator,
 <dd><p>Returns a condition that checks state values using optional operators.</p>
 <p>You can also refer to this as <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">burr.core</span> <span class="pre">import</span> <span class="pre">when</span></code> in the API.</p>
 <p>Basic equality (unchanged from original):</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">)</span>            <span class="c1"># state[&quot;foo&quot;] == &quot;bar&quot;</span>
-<span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">,</span> <span class="n">baz</span><span class="o">=</span><span class="s2">&quot;qux&quot;</span><span class="p">)</span> <span class="c1"># state[&quot;foo&quot;] == &quot;bar&quot; AND state[&quot;baz&quot;] == &quot;qux&quot;</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">)</span>            <span class="c1"># state["foo"] == "bar"</span>
+<span class="n">when</span><span class="p">(</span><span class="n">foo</span><span class="o">=</span><span class="s2">"bar"</span><span class="p">,</span> <span class="n">baz</span><span class="o">=</span><span class="s2">"qux"</span><span class="p">)</span> <span class="c1"># state["foo"] == "bar" AND state["baz"] == "qux"</span>
 </pre></div>
 </div>
 <p>Comparison operators via <code class="docutils literal notranslate"><span class="pre">__</span></code> suffix:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">age__gt</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state[&quot;age&quot;] &gt; 18</span>
-<span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>          <span class="c1"># state[&quot;age&quot;] &gt;= 18</span>
-<span class="n">when</span><span class="p">(</span><span class="n">age__lt</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state[&quot;age&quot;] &lt; 18</span>
-<span class="n">when</span><span class="p">(</span><span class="n">age__lte</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>          <span class="c1"># state[&quot;age&quot;] &lt;= 18</span>
-<span class="n">when</span><span class="p">(</span><span class="n">age__ne</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>            <span class="c1"># state[&quot;age&quot;] != 0</span>
-<span class="n">when</span><span class="p">(</span><span class="n">age__eq</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state[&quot;age&quot;] == 18  (explicit)</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">age__gt</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state["age"] &gt; 18</span>
+<span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>          <span class="c1"># state["age"] &gt;= 18</span>
+<span class="n">when</span><span class="p">(</span><span class="n">age__lt</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state["age"] &lt; 18</span>
+<span class="n">when</span><span class="p">(</span><span class="n">age__lte</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>          <span class="c1"># state["age"] &lt;= 18</span>
+<span class="n">when</span><span class="p">(</span><span class="n">age__ne</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>            <span class="c1"># state["age"] != 0</span>
+<span class="n">when</span><span class="p">(</span><span class="n">age__eq</span><span class="o">=</span><span class="mi">18</span><span class="p">)</span>           <span class="c1"># state["age"] == 18  (explicit)</span>
 </pre></div>
 </div>
 <p>Membership operators:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">status__in</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;a&quot;</span><span class="p">,</span> <span class="s2">&quot;b&quot;</span><span class="p">])</span>     <span class="c1"># state[&quot;status&quot;] in [&quot;a&quot;, &quot;b&quot;]</span>
-<span class="n">when</span><span class="p">(</span><span class="n">status__notin</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;x&quot;</span><span class="p">,</span> <span class="s2">&quot;y&quot;</span><span class="p">])</span>  <span class="c1"># state[&quot;status&quot;] not in [&quot;x&quot;, &quot;y&quot;]</span>
-<span class="n">when</span><span class="p">(</span><span class="n">tags__contains</span><span class="o">=</span><span class="s2">&quot;python&quot;</span><span class="p">)</span>   <span class="c1"># &quot;python&quot; in state[&quot;tags&quot;]</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">status__in</span><span class="o">=</span><span class="p">[</span><span class="s2">"a"</span><span class="p">,</span> <span class="s2">"b"</span><span class="p">])</span>     <span class="c1"># state["status"] in ["a", "b"]</span>
+<span class="n">when</span><span class="p">(</span><span class="n">status__notin</span><span class="o">=</span><span class="p">[</span><span class="s2">"x"</span><span class="p">,</span> <span class="s2">"y"</span><span class="p">])</span>  <span class="c1"># state["status"] not in ["x", "y"]</span>
+<span class="n">when</span><span class="p">(</span><span class="n">tags__contains</span><span class="o">=</span><span class="s2">"python"</span><span class="p">)</span>   <span class="c1"># "python" in state["tags"]</span>
 </pre></div>
 </div>
 <p>Identity operators:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">value__is</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>            <span class="c1"># state[&quot;value&quot;] is None</span>
-<span class="n">when</span><span class="p">(</span><span class="n">value__isnot</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>         <span class="c1"># state[&quot;value&quot;] is not None</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">value__is</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>            <span class="c1"># state["value"] is None</span>
+<span class="n">when</span><span class="p">(</span><span class="n">value__isnot</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>         <span class="c1"># state["value"] is not None</span>
 </pre></div>
 </div>
 <p>Multiple conditions are ANDed together:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">&quot;active&quot;</span><span class="p">)</span>  <span class="c1"># age &gt;= 18 AND status == &quot;active&quot;</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">when</span><span class="p">(</span><span class="n">age__gte</span><span class="o">=</span><span class="mi">18</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="s2">"active"</span><span class="p">)</span>  <span class="c1"># age &gt;= 18 AND status == "active"</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
diff --git a/content/docs/reference/index.html b/content/docs/reference/index.html
index cf9cbb6d..7ab3e383 100644
--- a/content/docs/reference/index.html
+++ b/content/docs/reference/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/bedrock/index.html b/content/docs/reference/integrations/bedrock/index.html
index 708d329b..731a8819 100644
--- a/content/docs/reference/integrations/bedrock/index.html
+++ b/content/docs/reference/integrations/bedrock/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -416,7 +417,7 @@ s=d.getElementsByTagName('script')[0];
 <p><a class="reference external" href="https://aws.amazon.com/bedrock/">Amazon Bedrock</a> models can be called through the
 Bedrock Runtime <strong>Converse</strong> and <strong>Converse Stream</strong> APIs using the actions below.</p>
 <p>Install the optional extra (pulls <code class="docutils literal notranslate"><span class="pre">boto3</span></code>):</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[bedrock]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[bedrock]"</span>
 </pre></div>
 </div>
 <section id="available-actions">
@@ -466,17 +467,17 @@ cross-account resource access. Restrict resources to specific model ARNs wheneve
 
 <span class="k">def</span><span class="w"> </span><span class="nf">map_state_to_prompt</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
     <span class="k">return</span> <span class="p">{</span>
-        <span class="s2">&quot;messages&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;role&quot;</span><span class="p">:</span> <span class="s2">&quot;user&quot;</span><span class="p">,</span> <span class="s2">&quot;content&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;text&quot;</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span  [...]
-        <span class="s2">&quot;system&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;text&quot;</span><span class="p">:</span> <span class="s2">&quot;You are a concise assistant.&quot;</span><span class="p">}],</span>
+        <span class="s2">"messages"</span><span class="p">:</span> <span class="p">[{</span><span class="s2">"role"</span><span class="p">:</span> <span class="s2">"user"</span><span class="p">,</span> <span class="s2">"content"</span><span class="p">:</span> <span class="p">[{</span><span class="s2">"text"</span><span class="p">:</span> <span class="n">state</span><span class="p">[</span><span class="s2">"question"</span><span class="p">]}]}],</span>
+        <span class="s2">"system"</span><span class="p">:</span> <span class="p">[{</span><span class="s2">"text"</span><span class="p">:</span> <span class="s2">"You are a concise assistant."</span><span class="p">}],</span>
     <span class="p">}</span>
 
 <span class="n">ask_model</span> <span class="o">=</span> <span class="n">BedrockAction</span><span class="p">(</span>
-    <span class="n">name</span><span class="o">=</span><span class="s2">&quot;ask_model&quot;</span><span class="p">,</span>
-    <span class="n">model_id</span><span class="o">=</span><span class="s2">&quot;anthropic.claude-3-haiku-20240307-v1:0&quot;</span><span class="p">,</span>
+    <span class="n">name</span><span class="o">=</span><span class="s2">"ask_model"</span><span class="p">,</span>
+    <span class="n">model_id</span><span class="o">=</span><span class="s2">"anthropic.claude-3-haiku-20240307-v1:0"</span><span class="p">,</span>
     <span class="n">input_mapper</span><span class="o">=</span><span class="n">map_state_to_prompt</span><span class="p">,</span>
-    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;question&quot;</span><span class="p">],</span>
-    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="s2">&quot;usage&quot;</span><span class="p">,</span> <span class="s2">&quot;stop_reason&quot;</span><span class="p">],</span>
-    <span class="n">region</span><span class="o">=</span><span class="s2">&quot;us-east-1&quot;</span><span class="p">,</span>
+    <span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"question"</span><span class="p">],</span>
+    <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">,</span> <span class="s2">"usage"</span><span class="p">,</span> <span class="s2">"stop_reason"</span><span class="p">],</span>
+    <span class="n">region</span><span class="o">=</span><span class="s2">"us-east-1"</span><span class="p">,</span>
 <span class="p">)</span>
 </pre></div>
 </div>
@@ -590,10 +591,10 @@ final response in <a class="reference internal" href="#burr.integrations.bedrock
 <p>For instance, you could have:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">stream_run</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <spa [...]
     <span class="n">buffer</span> <span class="o">=</span> <span class="p">[]</span> <span class="c1"># you might want to be more efficient than simple strcat</span>
-    <span class="k">for</span> <span class="n">token</span> <span class="ow">in</span> <span class="n">query</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">&#39;prompt&#39;</span><span class="p">]):</span>
-        <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span> <span class="p">:</span> <span class="n">token</span><span class="p">}</span>
+    <span class="k">for</span> <span class="n">token</span> <span class="ow">in</span> <span class="n">query</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s1">'prompt'</span><span class="p">]):</span>
+        <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span> <span class="p">:</span> <span class="n">token</span><span class="p">}</span>
         <span class="n">buffer</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">token</span><span class="p">)</span>
-    <span class="k">yield</span> <span class="p">{</span><span class="s1">&#39;response&#39;</span> <span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)}</span>
+    <span class="k">yield</span> <span class="p">{</span><span class="s1">'response'</span> <span class="p">:</span> <span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buffer</span><span class="p">)}</span>
 </pre></div>
 </div>
 <p>This would utilize a simple string buffer (implemented by a list) to store the results
diff --git a/content/docs/reference/integrations/hamilton/index.html b/content/docs/reference/integrations/hamilton/index.html
index 96c0e3c9..31babde9 100644
--- a/content/docs/reference/integrations/hamilton/index.html
+++ b/content/docs/reference/integrations/hamilton/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/haystack/index.html b/content/docs/reference/integrations/haystack/index.html
index 5a7eb58b..8eadf6fd 100644
--- a/content/docs/reference/integrations/haystack/index.html
+++ b/content/docs/reference/integrations/haystack/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/index.html b/content/docs/reference/integrations/index.html
index e1dace55..06607224 100644
--- a/content/docs/reference/integrations/index.html
+++ b/content/docs/reference/integrations/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/langchain/index.html b/content/docs/reference/integrations/langchain/index.html
index c7cbbc77..49ab6bba 100644
--- a/content/docs/reference/integrations/langchain/index.html
+++ b/content/docs/reference/integrations/langchain/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/langfuse/index.html b/content/docs/reference/integrations/langfuse/index.html
index 7d518c13..1ed03b11 100644
--- a/content/docs/reference/integrations/langfuse/index.html
+++ b/content/docs/reference/integrations/langfuse/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -418,7 +419,7 @@ tracing/observability capabilities. Burr integrates with it through the
 OpenTelemetry-native Langfuse Python SDK, building on the
 <a class="reference internal" href="../opentelemetry/#opentelintegrationref"><span class="std std-ref">opentelemetry integration</span></a>.</p>
 <p>Install the integration:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[langfuse]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[langfuse]"</span>
 </pre></div>
 </div>
 <p>Then add the bridge as a hook – credentials are read from the standard
@@ -430,11 +431,11 @@ environment variables:</p>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">graph</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prompt"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">LangfuseBridge</span><span class="p">())</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>  <span class="c1"># logs one trace to Langfuse</span>
+<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>  <span class="c1"># logs one trace to Langfuse</span>
 </pre></div>
 </div>
 <p>Each application execution call becomes a Langfuse trace, each step becomes a span
@@ -484,15 +485,15 @@ user - both can be overridden.</p>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">graph</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prompt"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">LangfuseBridge</span><span class="p">())</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>  <span class="c1"># logs one trace to Langfuse</span>
+<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">halt_after</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>  <span class="c1"># logs one trace to Langfuse</span>
 </pre></div>
 </div>
 <p>You can also pass credentials explicitly, or pass a pre-constructed client:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">LangfuseBridge</span><span class="p">(</span><span class="n">public_key</span><span class="o">=</span><span class="s2">&quot;pk-lf-...&quot;</span><span class="p">,</span> <span class="n">secret_key</span><span class="o">=</span><span class="s2">&quot;sk-lf-...&quot;</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="s2">&quot;...&quot;</span><spa [...]
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">LangfuseBridge</span><span class="p">(</span><span class="n">public_key</span><span class="o">=</span><span class="s2">"pk-lf-..."</span><span class="p">,</span> <span class="n">secret_key</span><span class="o">=</span><span class="s2">"sk-lf-..."</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="s2">"..."</span><span class="p">)</span>
 <span class="c1"># or, equivalently</span>
 <span class="n">LangfuseBridge</span><span class="p">(</span><span class="n">langfuse_client</span><span class="o">=</span><span class="n">my_langfuse_client</span><span class="p">)</span>
 </pre></div>
diff --git a/content/docs/reference/integrations/opentelemetry/index.html b/content/docs/reference/integrations/opentelemetry/index.html
index 865d137a..4117e0af 100644
--- a/content/docs/reference/integrations/opentelemetry/index.html
+++ b/content/docs/reference/integrations/opentelemetry/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -442,7 +443,7 @@ s=d.getElementsByTagName('script')[0];
 
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
-    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">&quot;prompt&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_entrypoint</span><span class="p">(</span><span class="s2">"prompt"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_state</span><span class="p">(</span><span class="n">chat_history</span><span class="o">=</span><span class="p">[])</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">graph</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_hooks</span><span class="p">(</span><span class="n">OpenTelemetryBridge</span><span class="p">())</span>
diff --git a/content/docs/reference/integrations/pydantic/index.html b/content/docs/reference/integrations/pydantic/index.html
index 12088b7b..378c18ef 100644
--- a/content/docs/reference/integrations/pydantic/index.html
+++ b/content/docs/reference/integrations/pydantic/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/ray/index.html b/content/docs/reference/integrations/ray/index.html
index dcda0d99..ea7402db 100644
--- a/content/docs/reference/integrations/ray/index.html
+++ b/content/docs/reference/integrations/ray/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/streamlit/index.html b/content/docs/reference/integrations/streamlit/index.html
index 38ae776d..7ba3b3c7 100644
--- a/content/docs/reference/integrations/streamlit/index.html
+++ b/content/docs/reference/integrations/streamlit/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/integrations/traceloop/index.html b/content/docs/reference/integrations/traceloop/index.html
index dc9cda9e..dc6626ae 100644
--- a/content/docs/reference/integrations/traceloop/index.html
+++ b/content/docs/reference/integrations/traceloop/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/lifecycle/index.html b/content/docs/reference/lifecycle/index.html
index 155bc917..019df182 100644
--- a/content/docs/reference/lifecycle/index.html
+++ b/content/docs/reference/lifecycle/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/parallelism/index.html b/content/docs/reference/parallelism/index.html
index 2f8eb34a..e8fa6021 100644
--- a/content/docs/reference/parallelism/index.html
+++ b/content/docs/reference/parallelism/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -498,18 +499,18 @@ your parallel action utilizes, then this is for you. If not, you’ll want to se
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">MultipleTaskExample</span><span class="p">(</span><span class="n">TaskBasedParallelAction</span><span class="p">):</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">tasks</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Generator</span><span class="p">[</span><span class="n">SubGraphTask</span><span class="p">,</span> <span class=" [...]
-        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]:</span>
+        <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"prompts"</span><span class="p">]:</span>
             <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+                <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
             <span class="p">]</span>
                 <span class="k">yield</span> <span class="n">SubGraphTask</span><span class="p">(</span>
                     <span class="n">action</span><span class="o">=</span><span class="n">action</span><span class="p">,</span> <span class="c1"># can be a RunnableGraph as well</span>
@@ -525,9 +526,9 @@ your parallel action utilizes, then this is for you. If not, you’ll want to se
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
             <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
                 <span class="p">{</span>
-                    <span class="s2">&quot;output&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;model&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;prompt&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+                    <span class="s2">"output"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">],</span>
+                    <span class="s2">"model"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"model"</span><span class="p">],</span>
+                    <span class="s2">"prompt"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
                 <span class="p">}</span>
             <span class="p">)</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
@@ -676,10 +677,10 @@ which allows you to specify the tasks individually. If you just want to vary act
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapActionsAndStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestModelsOverPrompts</span><span class="p">(</span><span class="n">MapActionsAndStates</span><span class="p">):</span>
 
@@ -687,17 +688,17 @@ which allows you to specify the tasks individually. If you just want to vary act
         <span class="c1"># make sure to add a name to the action</span>
         <span class="c1"># This is not necessary for subgraphs, as actions will already have names</span>
         <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">action</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span [...]
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
@@ -706,20 +707,20 @@ which allows you to specify the tasks individually. If you just want to vary act
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
             <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
                 <span class="p">{</span>
-                    <span class="s2">&quot;output&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;model&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;model&quot;</span><span class="p">],</span>
-                    <span class="s2">&quot;prompt&quot;</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span>
+                    <span class="s2">"output"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">],</span>
+                    <span class="s2">"model"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"model"</span><span class="p">],</span>
+                    <span class="s2">"prompt"</span> <span class="p">:</span> <span class="n">sub_state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span>
                 <span class="p">}</span>
             <span class="p">)</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompts"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 <dl class="py method">
@@ -913,41 +914,41 @@ action objects, or subdags implemented as <a class="reference internal" href="#b
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapActions</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">,</span> <span class="s2">&quot;model&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">,</span> <span class="s2">"model"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
     <span class="c1"># TODO -- implement _query_my_llm to call litellm or something</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class [...]
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">model</span><span class="o">=</span><span class="n">model [...]
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultipleModels</span><span class="p">(</span><span class="n">MapActions</span><span class="p">):</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">actions</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</spa [...]
         <span class="c1"># Make sure to add a name to the action if you use bind() with a function,</span>
         <span class="c1"># note that these can be different actions, functions, etc...</span>
-        <span class="c1"># in this case we&#39;re using `.bind()` to create multiple actions, but we can use some mix of</span>
+        <span class="c1"># in this case we're using `.bind()` to create multiple actions, but we can use some mix of</span>
         <span class="c1"># subgraphs, functions, action objects, etc...</span>
         <span class="k">for</span> <span class="n">action</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;gpt-4&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;gpt_4_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;o1&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;o1_answer&quot;</span><span class="p">),</span>
-            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">&quot;claude&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;claude_answer&quot;</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"gpt-4"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"gpt_4_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"o1"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"o1_answer"</span><span class="p">),</span>
+            <span class="n">query_llm</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="s2">"claude"</span><span class="p">)</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"claude_answer"</span><span class="p">),</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">action</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">state</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o">- [...]
-        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="s2">"What is the meaning of life?"</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">reduce</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">states</span><span class="p">:</span> <span class="n">Generator</span><span class="p">[</span><span class="n">State</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">State</span><spa [...]
         <span class="n">all_llm_outputs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
-            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]</span> <span class="c1"># we&#39;re just running this on a single prompt, for multiple actions</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompt"</span><span class="p">]</span> <span class="c1"># we're just running this on a single prompt, for multiple actions</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 <dl class="py method">
@@ -1052,41 +1053,41 @@ generator.</p>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.core.parallelism</span><span class="w"> </span><span class="kn">import</span> <span class="n">MapStates</span><span class="p">,</span> <span class="n">RunnableGraph</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Generator</span><span class="p">,</span> <span class="n">List</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">query_llm</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">]))</span>
+    <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">llm_output</span><span class="o">=</span><span class="n">_query_my_llm</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">]))</span>
 
 <span class="k">class</span><span class="w"> </span><span class="nc">TestMultiplePrompts</span><span class="p">(</span><span class="n">MapStates</span><span class="p">):</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">action</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span> <span class="o"> [...]
         <span class="c1"># make sure to add a name to the action</span>
         <span class="c1"># This is not necessary for subgraphs, as actions will already have names</span>
-        <span class="k">return</span> <span class="n">query_llm</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">&quot;query_llm&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">query_llm</span><span class="o">.</span><span class="n">with_name</span><span class="p">(</span><span class="s2">"query_llm"</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">inputs</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n"> [...]
-        <span class="c1"># You could easily have a list_prompts upstream action that writes to &quot;prompts&quot; in state</span>
+        <span class="c1"># You could easily have a list_prompts upstream action that writes to "prompts" in state</span>
         <span class="c1"># And loop through those</span>
         <span class="c1"># This hardcodes for simplicity</span>
         <span class="k">for</span> <span class="n">prompt</span> <span class="ow">in</span> <span class="p">[</span>
-            <span class="s2">&quot;What is the meaning of life?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the airspeed velocity of an unladen swallow?&quot;</span><span class="p">,</span>
-            <span class="s2">&quot;What is the best way to cook a steak?&quot;</span><span class="p">,</span>
+            <span class="s2">"What is the meaning of life?"</span><span class="p">,</span>
+            <span class="s2">"What is the airspeed velocity of an unladen swallow?"</span><span class="p">,</span>
+            <span class="s2">"What is the best way to cook a steak?"</span><span class="p">,</span>
         <span class="p">]:</span>
             <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">)</span>
 
     <span class="k">def</span><span class="w"> </span><span class="nf">reduce</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">states</span><span class="p">:</span> <span class="n">Generator</span><span class="p">[</span><span class="n">State</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span cla [...]
         <span class="n">all_llm_outputs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">sub_state</span> <span class="ow">in</span> <span class="n">states</span><span class="p">:</span>
-            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">&quot;llm_output&quot;</span><span class="p">])</span>
+            <span class="n">all_llm_outputs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sub_state</span><span class="p">[</span><span class="s2">"llm_output"</span><span class="p">])</span>
         <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">all_llm_outputs</span><span class="o">=</span><span class="n">all_llm_outputs</span><span class="p">)</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">reads</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;prompts&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"prompts"</span><span class="p">]</span>
 
     <span class="nd">@property</span>
     <span class="k">def</span><span class="w"> </span><span class="nf">writes</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="s2">&quot;all_llm_outputs&quot;</span><span class="p">]</span>
+        <span class="k">return</span> <span class="p">[</span><span class="s2">"all_llm_outputs"</span><span class="p">]</span>
 </pre></div>
 </div>
 <dl class="py method">
@@ -1167,7 +1168,7 @@ Each state will be an update to the input state.</p>
 into a set of states, each with a different value from the list.</p>
 <p>For example:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">states</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="n">ApplicationContext</span><span class="p">,</span> <span class="n">inputs</s [...]
-    <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;multiple_fields&quot;</span><span class="p">]:</span>
+    <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">state</span><span class="p">[</span><span class="s2">"multiple_fields"</span><span class="p">]:</span>
         <span class="k">yield</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">individual_field</span><span class="o">=</span><span class="n">item</span><span class="p">)</span>
 </pre></div>
 </div>
diff --git a/content/docs/reference/persister/index.html b/content/docs/reference/persister/index.html
index f026a805..67842ffc 100644
--- a/content/docs/reference/persister/index.html
+++ b/content/docs/reference/persister/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -1075,8 +1076,8 @@ before the action was applied.</p></li>
 </pre></div>
 </div>
 <p>Then you should be able to create the class like this:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="n">PostgreSQLPersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="s2">&quot;postgres&quot;</span><span class="p">,</span> <span class="s2">&quot;postgres&quot;</span><span class="p">,</span> <span class="s2">&quot;my_password&quot;</span><span class="p">,</span>
-                                   <span class="s2">&quot;localhost&quot;</span><span class="p">,</span> <span class="mi">54320</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;</span><span class="p">)</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="n">PostgreSQLPersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="s2">"postgres"</span><span class="p">,</span> <span class="s2">"postgres"</span><span class="p">,</span> <span class="s2">"my_password"</span><span class="p">,</span>
+                                   <span class="s2">"localhost"</span><span class="p">,</span> <span class="mi">54320</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span><span class="p">)</span>
 </pre></div>
 </div>
 <dl class="py method">
@@ -1398,18 +1399,18 @@ so this is an attempt to fix that in a backwards compatible way.</p>
 <span class="sig-paren">)</span><a class="headerlink" href="#burr.integrations.persisters.b_pymongo.MongoDBBasePersister" title="Link to this definition">¶</a></dt>
 <dd><p>A class used to represent a MongoDB Persister.</p>
 <p>Example usage:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">persister</span> <span class="o">=</span> <span class="n">MongoDBBasePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">uri</span><span class="o">=</span><span class="s1">&#39;mongodb://user:pass@localhost:27017&#39;</span><span class="p">,</span>
-                                             <span class="n">db_name</span><span class="o">=</span><span class="s1">&#39;mydatabase&#39;</span><span class="p">,</span>
-                                             <span class="n">collection_name</span><span class="o">=</span><span class="s1">&#39;mystates&#39;</span><span class="p">)</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">persister</span> <span class="o">=</span> <span class="n">MongoDBBasePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">uri</span><span class="o">=</span><span class="s1">'mongodb://user:pass@localhost:27017'</span><span class="p">,</span>
+                                             <span class="n">db_name</span><span class="o">=</span><span class="s1">'mydatabase'</span><span class="p">,</span>
+                                             <span class="n">collection_name</span><span class="o">=</span><span class="s1">'mystates'</span><span class="p">)</span>
 <span class="n">persister</span><span class="o">.</span><span class="n">save</span><span class="p">(</span>
-    <span class="n">partition_key</span><span class="o">=</span><span class="s1">&#39;example_partition&#39;</span><span class="p">,</span>
-    <span class="n">app_id</span><span class="o">=</span><span class="s1">&#39;example_app&#39;</span><span class="p">,</span>
+    <span class="n">partition_key</span><span class="o">=</span><span class="s1">'example_partition'</span><span class="p">,</span>
+    <span class="n">app_id</span><span class="o">=</span><span class="s1">'example_app'</span><span class="p">,</span>
     <span class="n">sequence_id</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
-    <span class="n">position</span><span class="o">=</span><span class="s1">&#39;example_position&#39;</span><span class="p">,</span>
-    <span class="n">state</span><span class="o">=</span><span class="n">state</span><span class="o">.</span><span class="n">State</span><span class="p">({</span><span class="s1">&#39;key&#39;</span><span class="p">:</span> <span class="s1">&#39;value&#39;</span><span class="p">}),</span>
-    <span class="n">status</span><span class="o">=</span><span class="s1">&#39;completed&#39;</span>
+    <span class="n">position</span><span class="o">=</span><span class="s1">'example_position'</span><span class="p">,</span>
+    <span class="n">state</span><span class="o">=</span><span class="n">state</span><span class="o">.</span><span class="n">State</span><span class="p">({</span><span class="s1">'key'</span><span class="p">:</span> <span class="s1">'value'</span><span class="p">}),</span>
+    <span class="n">status</span><span class="o">=</span><span class="s1">'completed'</span>
 <span class="p">)</span>
-<span class="n">loaded_state</span> <span class="o">=</span> <span class="n">persister</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">partition_key</span><span class="o">=</span><span class="s1">&#39;example_partition&#39;</span><span class="p">,</span> <span class="n">app_id</span><span class="o">=</span><span class="s1">&#39;example_app&#39;</span><span class="p">,</span> <span class="n">sequence_id</span><span class="o">=</span><span c [...]
+<span class="n">loaded_state</span> <span class="o">=</span> <span class="n">persister</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">partition_key</span><span class="o">=</span><span class="s1">'example_partition'</span><span class="p">,</span> <span class="n">app_id</span><span class="o">=</span><span class="s1">'example_app'</span><span class="p">,</span> <span class="n">sequence_id</span><span class="o">=</span><span class="mi">1</spa [...]
 <span class="nb">print</span><span class="p">(</span><span class="n">loaded_state</span><span class="p">)</span>
 </pre></div>
 </div>
@@ -1658,9 +1659,9 @@ connect_kwargs: dict,</p>
 <span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">_AsyncPersisterContextManager</span></span></span><a class="headerlink" href="#burr.integrations.persisters.b_aiosqlite.AsyncSQLitePersister.from_values" title="Link to this definition">¶</a></dt>
 <dd><p>Creates a new instance of the AsyncSQLitePersister from passed in values.</p>
 <p>Can be used with <code class="docutils literal notranslate"><span class="pre">await</span></code> or as an async context manager:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">persister</span> <span class="o">=</span> <span class="k">await</span> <span class="n">AsyncSQLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;test.db&quot;</span><span class="p">)</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">persister</span> <span class="o">=</span> <span class="k">await</span> <span class="n">AsyncSQLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">"test.db"</span><span class="p">)</span>
 <span class="c1"># or</span>
-<span class="k">async</span> <span class="k">with</span> <span class="n">AsyncSQLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">&quot;test.db&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">persister</span><span class="p">:</span>
+<span class="k">async</span> <span class="k">with</span> <span class="n">AsyncSQLitePersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="n">db_path</span><span class="o">=</span><span class="s2">"test.db"</span><span class="p">)</span> <span class="k">as</span> <span class="n">persister</span><span class="p">:</span>
     <span class="o">...</span>
 </pre></div>
 </div>
@@ -1817,8 +1818,8 @@ explaining why a new implementation, performance review and comparison to aiopg
 </pre></div>
 </div>
 <p>Then you should be able to create the class like this:</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="k">await</span> <span class="n">AsyncPostgreSQLPersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="s2">&quot;postgres&quot;</span><span class="p">,</span> <span class="s2">&quot;postgres&quot;</span><span class="p">,</span> <span class="s2">&quot;my_password&quot;</span><span class="p"> [...]
-                                   <span class="s2">&quot;localhost&quot;</span><span class="p">,</span> <span class="mi">54320</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">&quot;burr_state&quot;</span><span class="p">)</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="k">await</span> <span class="n">AsyncPostgreSQLPersister</span><span class="o">.</span><span class="n">from_values</span><span class="p">(</span><span class="s2">"postgres"</span><span class="p">,</span> <span class="s2">"postgres"</span><span class="p">,</span> <span class="s2">"my_password"</span><span class="p">,</span>
+                                   <span class="s2">"localhost"</span><span class="p">,</span> <span class="mi">54320</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="s2">"burr_state"</span><span class="p">)</span>
 </pre></div>
 </div>
 <dl class="py method">
diff --git a/content/docs/reference/serde/index.html b/content/docs/reference/serde/index.html
index 12a7cb08..ae672b3d 100644
--- a/content/docs/reference/serde/index.html
+++ b/content/docs/reference/serde/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -428,11 +429,11 @@ but based on a string key value.</p>
 <p>Example usage:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.core</span><span class="w"> </span><span class="kn">import</span> <span class="n">serde</span>
 
-<span class="nd">@serde</span><span class="o">.</span><span class="n">deserializer</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;pickle&quot;</span><span class="p">)</span>
+<span class="nd">@serde</span><span class="o">.</span><span class="n">deserializer</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">"pickle"</span><span class="p">)</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">deserialize_pickle</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">pickle_kwargs</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</ [...]
     <span class="k">if</span> <span class="n">pickle_kwargs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
         <span class="n">pickle_kwargs</span> <span class="o">=</span> <span class="p">{}</span>
-    <span class="k">return</span> <span class="n">pickle</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">&quot;value&quot;</span><span class="p">],</span> <span class="o">**</span><span class="n">pickle_kwargs</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">pickle</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">"value"</span><span class="p">],</span> <span class="o">**</span><span class="n">pickle_kwargs</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>What this does is register the function <cite>deserialize_pickle</cite> with the key “pickle”.
diff --git a/content/docs/reference/state/index.html b/content/docs/reference/state/index.html
index 91805729..871068cf 100644
--- a/content/docs/reference/state/index.html
+++ b/content/docs/reference/state/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -444,8 +445,8 @@ s=d.getElementsByTagName('script')[0];
 must correspond to a list-like object, or an error will be raised.</p>
 <p>This is an upsert operation, meaning that if the key does not
 exist, a new list will be created with the value in it.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">&quot;a&quot;</span><span class="p">:</span> <span class="p">[</span><span class="mi">1</span><span class="p">]})</span>
-<span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>  <span class="c1"># State({&quot;a&quot;: [1, 2]})</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">"a"</span><span class="p">:</span> <span class="p">[</span><span class="mi">1</span><span class="p">]})</span>
+<span class="n">state</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>  <span class="c1"># State({"a": [1, 2]})</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
@@ -483,8 +484,8 @@ exist, a new list will be created with the value in it.</p>
 must correspond to a list-like object, or an error will be raised.</p>
 <p>This is an upsert operation, meaning that if the key does not
 exist, a new list will be created and extended with the values.</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">&quot;a&quot;</span><span class="p">:</span> <span class="p">[</span><span class="mi">1</span><span class="p">]})</span>
-<span class="n">state</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">])</span>  <span class="c1"># State({&quot;a&quot;: [1, 2, 3]})</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">"a"</span><span class="p">:</span> <span class="p">[</span><span class="mi">1</span><span class="p">]})</span>
+<span class="n">state</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">])</span>  <span class="c1"># State({"a": [1, 2, 3]})</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
@@ -560,8 +561,8 @@ with those in other.</p>
 <dd><p>Updates the state with a set of key-value pairs
 Does an upsert operation (if the keys exist their value will be overwritten,
 otherwise they will be created)</p>
-<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">&quot;a&quot;</span><span class="p">:</span> <span class="mi">1</span><span class="p">})</span>
-<span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">b</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>  <span class="c1"># State({&quot;a&quot;: 2, &quot;b&quot;: 3})</span>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">State</span><span class="p">({</span><span class="s2">"a"</span><span class="p">:</span> <span class="mi">1</span><span class="p">})</span>
+<span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">b</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>  <span class="c1"># State({"a": 2, "b": 3})</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
@@ -621,13 +622,13 @@ Note: this registration is global for any state field with the same name.</p>
 tracking / persistence.</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">my_field_serializer</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="n">MyType</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
     <span class="n">serde_value</span> <span class="o">=</span> <span class="n">_do_something_to_serialize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">serde_value</span><span class="p">}</span>
+    <span class="k">return</span> <span class="p">{</span><span class="s2">"value"</span><span class="p">:</span> <span class="n">serde_value</span><span class="p">}</span>
 
 <span class="k">def</span><span class="w"> </span><span class="nf">my_field_deserializer</span><span class="p">(</span><span class="n">value</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">MyType</span><span class="p">:</span>
-    <span class="n">serde_value</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="s2">&quot;value&quot;</span><span class="p">]</span>
+    <span class="n">serde_value</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="s2">"value"</span><span class="p">]</span>
     <span class="k">return</span> <span class="n">_do_something_to_deserialize</span><span class="p">(</span><span class="n">serde_value</span><span class="p">)</span>
 
-<span class="n">register_field_serde</span><span class="p">(</span><span class="s2">&quot;my_field&quot;</span><span class="p">,</span> <span class="n">my_field_serializer</span><span class="p">,</span> <span class="n">my_field_deserializer</span><span class="p">)</span>
+<span class="n">register_field_serde</span><span class="p">(</span><span class="s2">"my_field"</span><span class="p">,</span> <span class="n">my_field_serializer</span><span class="p">,</span> <span class="n">my_field_deserializer</span><span class="p">)</span>
 </pre></div>
 </div>
 <dl class="field-list simple">
diff --git a/content/docs/reference/tracking/index.html b/content/docs/reference/tracking/index.html
index f13ee6ef..a6461fad 100644
--- a/content/docs/reference/tracking/index.html
+++ b/content/docs/reference/tracking/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/typing/index.html b/content/docs/reference/typing/index.html
index 17247053..d0c4ab22 100644
--- a/content/docs/reference/typing/index.html
+++ b/content/docs/reference/typing/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/reference/visibility/index.html b/content/docs/reference/visibility/index.html
index 473c8d6f..dcfe274a 100644
--- a/content/docs/reference/visibility/index.html
+++ b/content/docs/reference/visibility/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -438,7 +439,7 @@ parameter.</p>
 <blockquote>
 <div><div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="o">...</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="o">...</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span [...]
-    <span class="n">context_manager</span><span class="p">:</span> <span class="n">ActionSpanTracer</span> <span class="o">=</span> <span class="n">__tracer</span><span class="p">(</span><span class="s2">&quot;my_span_name&quot;</span><span class="p">)</span>
+    <span class="n">context_manager</span><span class="p">:</span> <span class="n">ActionSpanTracer</span> <span class="o">=</span> <span class="n">__tracer</span><span class="p">(</span><span class="s2">"my_span_name"</span><span class="p">)</span>
     <span class="k">with</span> <span class="n">context_manager</span><span class="p">:</span>
         <span class="o">...</span>
 </pre></div>
@@ -457,7 +458,7 @@ us to reset this based on state. This can handle both synchronous and asynchrono
 it gives you a callable that, when called with a span name, returns an <cite>ActionSpanTracer</cite></p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="o">...</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="o">...</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">my_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">,</span> <span class="n">__tracer</span><span class="p">:</span> <span class="n">TracerFactory</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">State</span [...]
-    <span class="n">context_manager</span><span class="p">:</span> <span class="n">ActionSpanTracer</span> <span class="o">=</span> <span class="n">__tracer</span><span class="p">(</span><span class="s2">&quot;my_span_name&quot;</span><span class="p">)</span>
+    <span class="n">context_manager</span><span class="p">:</span> <span class="n">ActionSpanTracer</span> <span class="o">=</span> <span class="n">__tracer</span><span class="p">(</span><span class="s2">"my_span_name"</span><span class="p">)</span>
     <span class="k">with</span> <span class="n">context_manager</span><span class="p">:</span>
         <span class="o">...</span>
 </pre></div>
@@ -583,11 +584,11 @@ input_filterlist to exclude it.</p>
 <span class="nd">@trace</span><span class="p">()</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">generate_text</span><span class="p">(</span><span class="n">prompt</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
     <span class="n">result</span> <span class="o">=</span> <span class="n">call_llm</span><span class="p">(</span><span class="n">prompt</span><span class="p">)</span>
-    <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;&lt;p&gt;</span><span class="si">{</span><span class="n">result</span><span class="si">}</span><span class="s2">&lt;/p&gt;&quot;</span>
+    <span class="k">return</span> <span class="sa">f</span><span class="s2">"&lt;p&gt;</span><span class="si">{</span><span class="n">result</span><span class="si">}</span><span class="s2">&lt;/p&gt;"</span>
 
-<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;response&quot;</span><span class="p">])</span>
+<span class="nd">@action</span><span class="p">(</span><span class="n">reads</span><span class="o">=</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">],</span> <span class="n">writes</span><span class="o">=</span><span class="p">[</span><span class="s2">"response"</span><span class="p">])</span>
 <span class="k">def</span><span class="w"> </span><span class="nf">prompt_action</span><span class="p">(</span><span class="n">state</span><span class="p">:</span> <span class="n">State</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">State</span><span class="p">:</span>
-    <span class="n">response</span> <span class="o">=</span> <span class="n">generate_text</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">&quot;prompt&quot;</span><span class="p">])</span>
+    <span class="n">response</span> <span class="o">=</span> <span class="n">generate_text</span><span class="p">(</span><span class="n">state</span><span class="p">[</span><span class="s2">"prompt"</span><span class="p">])</span>
     <span class="k">return</span> <span class="n">state</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">response</span><span class="o">=</span><span class="n">response</span><span class="p">)</span>
 </pre></div>
 </div>
diff --git a/content/docs/search/index.html b/content/docs/search/index.html
index 2fc1bf05..e402b2a5 100644
--- a/content/docs/search/index.html
+++ b/content/docs/search/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/searchindex.js b/content/docs/searchindex.js
index 5acf2338..beb9d9d5 100644
--- a/content/docs/searchindex.js
+++ b/content/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"1. Agent application is modeled as State + Actions \u2013> Graph":[[30,"agent-application-is-modeled-as-state-actions-graph"]],"1. Make your methods async":[[6,"make-your-methods-async"]],"2. Build application \u2013> built in checkpointing & tracking":[[30,"build-application-built-in-checkpointing-tracking"]],"2. Implement the is_async method":[[6,"implement-the-is-async-method"]],"3. Comes with a UI":[[30,"comes-with-a-ui"]],"3. Use async persisters with  [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"1. Agent application is modeled as State + Actions \u2013> Graph":[[31,"agent-application-is-modeled-as-state-actions-graph"]],"1. Make your methods async":[[7,"make-your-methods-async"]],"2. Build application \u2013> built in checkpointing & tracking":[[31,"build-application-built-in-checkpointing-tracking"]],"2. Implement the is_async method":[[7,"implement-the-is-async-method"]],"3. Comes with a UI":[[31,"comes-with-a-ui"]],"3. Use async persisters with  [...]
\ No newline at end of file
diff --git a/content/docs/sitemap.xml b/content/docs/sitemap.xml
index 67bf2405..7012cc96 100644
--- a/content/docs/sitemap.xml
+++ b/content/docs/sitemap.xml
@@ -1,2 +1,2 @@
 <?xml version='1.0' encoding='utf-8'?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://burr.apache.org/docs/asf/</loc></url><url><loc>https://burr.apache.org/docs/concepts/actions/</loc></url><url><loc>https://burr.apache.org/docs/concepts/additional-visibility/</loc></url><url><loc>https://burr.apache.org/docs/concepts/hooks/</loc></url><url><loc>https://burr.apache.org/docs/concepts/</loc></url><url><loc>https://burr.apache.org/docs/concepts/overview/</loc></url><url><loc>https://burr.apache.or [...]
\ No newline at end of file
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://burr.apache.org/docs/asf/</loc></url><url><loc>https://burr.apache.org/docs/concepts/actions/</loc></url><url><loc>https://burr.apache.org/docs/concepts/additional-visibility/</loc></url><url><loc>https://burr.apache.org/docs/concepts/hooks/</loc></url><url><loc>https://burr.apache.org/docs/concepts/human-in-the-loop/</loc></url><url><loc>https://burr.apache.org/docs/concepts/</loc></url><url><loc>https://burr. [...]
\ No newline at end of file
diff --git a/content/docs/ui/deployment/index.html b/content/docs/ui/deployment/index.html
index ca7b765d..4417f07c 100644
--- a/content/docs/ui/deployment/index.html
+++ b/content/docs/ui/deployment/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -422,7 +423,7 @@ production stack for ongoing observability.</p>
 <span class="kn">from</span><span class="w"> </span><span class="nn">burr.tracking.server.run</span><span class="w"> </span><span class="kn">import</span> <span class="n">mount_burr_ui</span>
 
 <span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">()</span>
-<span class="n">mount_burr_ui</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="s2">&quot;/burr&quot;</span><span class="p">)</span>
+<span class="n">mount_burr_ui</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="s2">"/burr"</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>The tracking UI will then be available at <code class="docutils literal notranslate"><span class="pre">/burr</span></code> on your existing server.</p>
diff --git a/content/docs/ui/getting-started/index.html b/content/docs/ui/getting-started/index.html
index 7fdca210..12b03673 100644
--- a/content/docs/ui/getting-started/index.html
+++ b/content/docs/ui/getting-started/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -416,7 +417,7 @@ s=d.getElementsByTagName('script')[0];
 <section id="quick-start">
 <h2>Quick Start<a class="headerlink" href="#quick-start" title="Link to this heading">¶</a></h2>
 <p>Install Burr with the UI extras and launch the server:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">&quot;apache-burr[start]&quot;</span>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"apache-burr[start]"</span>
 burr
 </pre></div>
 </div>
@@ -432,7 +433,7 @@ will automatically appear in the UI:</p>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_actions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
     <span class="o">.</span><span class="n">with_transitions</span><span class="p">(</span><span class="o">...</span><span class="p">)</span>
-    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="s2">&quot;local&quot;</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">&quot;my-project&quot;</span><span class="p">)</span>
+    <span class="o">.</span><span class="n">with_tracker</span><span class="p">(</span><span class="s2">"local"</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="s2">"my-project"</span><span class="p">)</span>
     <span class="o">.</span><span class="n">build</span><span class="p">()</span>
 <span class="p">)</span>
 </pre></div>
@@ -446,7 +447,7 @@ its application runs, and the step-by-step trace.</p>
 can reload state from any past run for debugging:</p>
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">burr.tracking</span><span class="w"> </span><span class="kn">import</span> <span class="n">LocalTrackingClient</span>
 
-<span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">&quot;my-project&quot;</span><span class="p">)</span>
+<span class="n">tracker</span> <span class="o">=</span> <span class="n">LocalTrackingClient</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="s2">"my-project"</span><span class="p">)</span>
 <span class="n">app</span> <span class="o">=</span> <span class="p">(</span>
     <span class="n">ApplicationBuilder</span><span class="p">()</span>
     <span class="o">.</span><span class="n">with_graph</span><span class="p">(</span><span class="n">base_graph</span><span class="p">)</span>
@@ -454,8 +455,8 @@ can reload state from any past run for debugging:</p>
         <span class="n">tracker</span><span class="p">,</span>
         <span class="n">resume_at_next_action</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
         <span class="n">default_state</span><span class="o">=</span><span class="p">{},</span>
-        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">&quot;my-entrypoint&quot;</span><span class="p">,</span>
-        <span class="n">fork_from_app_id</span><span class="o">=</span><span class="s2">&quot;&lt;prior-app-id&gt;&quot;</span><span class="p">,</span>
+        <span class="n">default_entrypoint</span><span class="o">=</span><span class="s2">"my-entrypoint"</span><span class="p">,</span>
+        <span class="n">fork_from_app_id</span><span class="o">=</span><span class="s2">"&lt;prior-app-id&gt;"</span><span class="p">,</span>
         <span class="n">fork_from_sequence_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
         <span class="n">fork_from_partition_key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
     <span class="p">)</span>
diff --git a/content/docs/ui/index.html b/content/docs/ui/index.html
index d2e83b74..d24c2728 100644
--- a/content/docs/ui/index.html
+++ b/content/docs/ui/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
diff --git a/content/docs/ui/notebook/index.html b/content/docs/ui/notebook/index.html
index 7d78f9f8..24a18533 100644
--- a/content/docs/ui/notebook/index.html
+++ b/content/docs/ui/notebook/index.html
@@ -307,6 +307,7 @@ s=d.getElementsByTagName('script')[0];
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/actions/">Actions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state/">State</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/state-machine/">Applications</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../concepts/human-in-the-loop/">Human in the Loop</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/transitions/">Transitions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/tracking/">Tracking Burr</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../../concepts/s3-tracking-aws/">S3 Tracking on AWS (Concepts)</a></li>
@@ -420,7 +421,7 @@ s=d.getElementsByTagName('script')[0];
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Load the extension and print the URL</span>
 <span class="o">%</span><span class="n">load_ext</span> <span class="n">burr</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">notebook</span>
 <span class="o">%</span><span class="n">burr_ui</span>
-<span class="c1"># → &quot;Burr UI: http://127.0.0.1:7241&quot;</span>
+<span class="c1"># → "Burr UI: http://127.0.0.1:7241"</span>
 </pre></div>
 </div>
 <p>The magic starts the tracking server on port <code class="docutils literal notranslate"><span class="pre">7241</span></code> if it isn’t already running and
diff --git a/content/downloads.html b/content/downloads.html
index 38792868..d12cee13 100644
--- a/content/downloads.html
+++ b/content/downloads.html
@@ -1,3 +1,3 @@
-<!DOCTYPE html><!--_3dbZnoqfuFnQ7Y83vzdP--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="preload" as="image" href="/burr_logo.svg"/><link rel="stylesheet" href="/_next/static/css/675dbd99ea0a9d95.css" data-precedence="next"/><link rel="preload" as="script" fe [...]
+<!DOCTYPE html><!--GifovmhjX2KCAlIUlQVfd--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="preload" as="image" href="/burr_logo.svg"/><link rel="stylesheet" href="/_next/static/css/675dbd99ea0a9d95.css" data-precedence="next"/><link rel="preload" as="script" fe [...]
 gpg --import KEYS</code></pre><h3 class="mt-6 mb-2 font-semibold">2. Verify the signature</h3><pre class="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var(--bg)] p-4 text-sm font-mono"><code>gpg --verify apache-burr-0.42.0-incubating-src.tar.gz.asc \
-            apache-burr-0.42.0-incubating-src.tar.gz</code></pre><p class="mt-3 text-sm text-[var(--muted)]">Look for &quot;Good signature from ...&quot; in the output. A warning that the key is not certified by a trusted signature is expected unless you&#x27;ve set up a web of trust — what matters is that the fingerprint matches one in KEYS.</p><h3 class="mt-6 mb-2 font-semibold">3. Verify the checksum</h3><pre class="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var [...]
\ No newline at end of file
+            apache-burr-0.42.0-incubating-src.tar.gz</code></pre><p class="mt-3 text-sm text-[var(--muted)]">Look for &quot;Good signature from ...&quot; in the output. A warning that the key is not certified by a trusted signature is expected unless you&#x27;ve set up a web of trust — what matters is that the fingerprint matches one in KEYS.</p><h3 class="mt-6 mb-2 font-semibold">3. Verify the checksum</h3><pre class="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var [...]
\ No newline at end of file
diff --git a/content/downloads.txt b/content/downloads.txt
index e43d1c0b..8480f58c 100644
--- a/content/downloads.txt
+++ b/content/downloads.txt
@@ -6,7 +6,7 @@
 e:I[57150,[],""]
 :HL["/_next/static/media/22a5144ee8d83bca-s.p.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
 :HL["/_next/static/css/675dbd99ea0a9d95.css","style"]
-0:{"P":null,"b":"-3dbZnoqfuFnQ7Y83vzdP","p":"","c":["","downloads"],"i":false,"f":[[["",{"children":["downloads",{"children":["__PAGE__",{}]}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/675dbd99ea0a9d95.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","suppressHydrationWarning":true,"className":"font-sans __variable_246ccd","children":[["$","head",n [...]
+0:{"P":null,"b":"GifovmhjX2KCAlIUlQVfd","p":"","c":["","downloads"],"i":false,"f":[[["",{"children":["downloads",{"children":["__PAGE__",{}]}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/675dbd99ea0a9d95.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","suppressHydrationWarning":true,"className":"font-sans __variable_246ccd","children":[["$","head",n [...]
 1a:I[24431,[],"OutletBoundary"]
 1c:I[15278,[],"AsyncMetadataOutlet"]
 1e:I[24431,[],"ViewportBoundary"]
diff --git a/content/index.html b/content/index.html
index 7bbd504e..bda8684a 100644
--- a/content/index.html
+++ b/content/index.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><!--_3dbZnoqfuFnQ7Y83vzdP--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="preload" as="image" href="/burr_logo.svg"/><link rel="preload" as="image" href="https://www.google.com/s2/favicons?domain=peanutrobotics.com&amp;sz=64"/><link rel="preloa [...]
+<!DOCTYPE html><!--GifovmhjX2KCAlIUlQVfd--><html lang="en" class="font-sans __variable_246ccd"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" href="/_next/static/media/22a5144ee8d83bca-s.p.woff2" as="font" crossorigin="" type="font/woff2"/><link rel="preload" as="image" href="/burr_logo.svg"/><link rel="preload" as="image" href="https://www.google.com/s2/favicons?domain=peanutrobotics.com&amp;sz=64"/><link rel="preloa [...]
 
 @action(reads=[&quot;messages&quot;], writes=[&quot;messages&quot;])
 def chat(state: State, llm_client) -&gt; State:
@@ -40,4 +40,4 @@ app.run(halt_after=[&quot;chat&quot;], inputs={&quot;llm_client&quot;: client})<
           ) border-box"><div class="bg-background absolute inset-px z-20 rounded-[inherit] overflow-hidden"></div><div class="pointer-events-none absolute inset-px z-30 rounded-[inherit] overflow-hidden opacity-0 transition-opacity duration-300 group-hover:opacity-100" style="opacity:0.12;background:radial-gradient(200px circle at -200px -200px,
                 #262626,
                 transparent 100%
-              )"></div><div class="relative z-40 h-full"><div class="flex flex-col items-center gap-3 p-6 min-h-[160px]"><div class="inline-flex items-center justify-center rounded-xl p-3 bg-[var(--card-border)]/30"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-twitter h-6 w-6"><path d="M22 4s-.7 2.1-2 3.4c1.6 10-9.4 17.3-18 11.6 2.2. [...]
\ No newline at end of file
+              )"></div><div class="relative z-40 h-full"><div class="flex flex-col items-center gap-3 p-6 min-h-[160px]"><div class="inline-flex items-center justify-center rounded-xl p-3 bg-[var(--card-border)]/30"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-twitter h-6 w-6"><path d="M22 4s-.7 2.1-2 3.4c1.6 10-9.4 17.3-18 11.6 2.2. [...]
\ No newline at end of file
diff --git a/content/index.txt b/content/index.txt
index 395efc25..ac011040 100644
--- a/content/index.txt
+++ b/content/index.txt
@@ -12,7 +12,7 @@ b:I[23859,["8734","static/chunks/8734-f0efcfa0d7c14bb2.js","8974","static/chunks
 11:I[57150,[],""]
 :HL["/_next/static/media/22a5144ee8d83bca-s.p.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
 :HL["/_next/static/css/675dbd99ea0a9d95.css","style"]
-0:{"P":null,"b":"-3dbZnoqfuFnQ7Y83vzdP","p":"","c":["",""],"i":false,"f":[[["",{"children":["__PAGE__",{}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/675dbd99ea0a9d95.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","suppressHydrationWarning":true,"className":"font-sans __variable_246ccd","children":[["$","head",null,{"children":[["$","link",null,{" [...]
+0:{"P":null,"b":"GifovmhjX2KCAlIUlQVfd","p":"","c":["",""],"i":false,"f":[[["",{"children":["__PAGE__",{}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/675dbd99ea0a9d95.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","suppressHydrationWarning":true,"className":"font-sans __variable_246ccd","children":[["$","head",null,{"children":[["$","link",null,{" [...]
 12:I[24431,[],"OutletBoundary"]
 14:I[15278,[],"AsyncMetadataOutlet"]
 16:I[24431,[],"ViewportBoundary"]