fastworkflow 2.17.5__py3-none-any.whl → 2.17.6__py3-none-any.whl

fastworkflow/chat_session.py

@@ -467,15 +467,28 @@ class ChatSession:
             self
         )
 
+        # Get available commands for current context and pass to agent.
+        # The CommandsSystemPreludeAdapter will inject these commands into the system 
+        # message, keeping them out of the trajectory to avoid token bloat while still 
+        # providing context-specific command info.
+        from fastworkflow.workflow_agent import _what_can_i_do
+        available_commands = _what_can_i_do(self)
+
         lm = dspy_utils.get_lm("LLM_AGENT", "LITELLM_API_KEY_AGENT")
         from dspy.utils.exceptions import AdapterParseError
+        from fastworkflow.utils.chat_adapter import CommandsSystemPreludeAdapter
+        
+        # Use CommandsSystemPreludeAdapter specifically for workflow agent calls
+        agent_adapter = CommandsSystemPreludeAdapter()
+        
         # Retry logic for AdapterParseError
         max_retries = 2
         for attempt in range(max_retries):
             try:
-                with dspy.context(lm=lm, adapter=dspy.ChatAdapter()):
+                with dspy.context(lm=lm, adapter=agent_adapter):
                     agent_result = self._workflow_tool_agent(
-                        user_query=command_info_and_refined_message_with_todolist
+                        user_query=command_info_and_refined_message_with_todolist,
+                        available_commands=available_commands
                     )
                 break  # Success, exit retry loop
             except AdapterParseError as _:

fastworkflow/utils/chat_adapter.py

@@ -0,0 +1,99 @@
+"""
+ChatAdapter wrapper for injecting context-specific available commands into system messages.
+
+Design Overview:
+---------------
+This module implements a ChatAdapter wrapper that dynamically injects workflow command information
+into the system message at runtime, avoiding the need to rebuild ReAct agent modules per context.
+
+Key Benefits:
+- Single shared agent: No per-context module caching required
+- Dynamic updates: Commands refresh per call based on current workflow context
+- Token efficiency: Commands appear in system (not repeated in trajectory/history)
+- Zero rebuild cost: Signature and modules remain stable across context changes
+
+Usage:
+------
+The adapter is used specifically for workflow agent calls via dspy.context():
+
+    from fastworkflow.utils.chat_adapter import CommandsSystemPreludeAdapter
+    
+    agent_adapter = CommandsSystemPreludeAdapter()
+    available_commands = _what_can_i_do(chat_session)
+    
+    with dspy.context(lm=lm, adapter=agent_adapter):
+        agent_result = agent(
+            user_query="...",
+            available_commands=available_commands
+        )
+
+The adapter intercepts the format call and prepends commands to the system message,
+keeping them out of the trajectory to prevent token bloat across iterations.
+This scoped approach ensures the adapter only affects workflow agent calls, not other
+DSPy operations in the system.
+"""
+import dspy
+
+
+class CommandsSystemPreludeAdapter(dspy.ChatAdapter):
+    """
+    Wraps a base DSPy ChatAdapter to inject available commands into the system message.
+    
+    This adapter intercepts the render process and prepends a "Available commands" section
+    to the system message when `available_commands` is present in inputs. This ensures
+    commands are visible to the model at each step without being added to the trajectory
+    or conversation history.
+    
+    Args:
+        base: The underlying ChatAdapter to wrap. Defaults to dspy.ChatAdapter() if None.
+        title: The header text for the commands section. Defaults to "Available commands".
+    
+    Example:
+        >>> import dspy
+        >>> from fastworkflow.utils.chat_adapter import CommandsSystemPreludeAdapter
+        >>> dspy.settings.adapter = CommandsSystemPreludeAdapter()
+    """
+    
+    def __init__(self, base: dspy.ChatAdapter | None = None, title: str = "Available commands"):
+        super().__init__()
+        self.base = base or dspy.ChatAdapter()
+        self.title = title
+    
+    def format(self, signature, demos, inputs):
+        """
+        Format the inputs for the model, injecting available_commands into system message.
+        
+        This method wraps the base adapter's format method and modifies the result
+        to include available commands in the system message if present in inputs.
+        
+        Args:
+            signature: The DSPy signature defining the task
+            demos: List of demonstration examples
+            inputs: Dictionary of input values, may include 'available_commands'
+            
+        Returns:
+            Formatted messages with commands injected into system message
+        """
+        # Call the base adapter's format method
+        formatted = self.base.format(signature, demos, inputs)
+        
+        # Check if available_commands is in inputs
+        cmds = inputs.get("available_commands")
+        if not cmds:
+            return formatted
+        
+        # Inject commands into the system message
+        prelude = f"{self.title}:\n{cmds}".strip()
+        
+        # Formatted output is a list of messages, first may be system
+        # Find and modify the system message, or prepend one
+        if formatted and formatted[0].get("role") == "system":
+            # Prepend to existing system message
+            existing_content = formatted[0].get("content", "")
+            formatted[0]["content"] = f"{prelude}\n\n{existing_content}".strip()
+        else:
+            # No system message exists, prepend one
+            formatted.insert(0, {"role": "system", "content": prelude})
+        
+        return formatted
+

fastworkflow/utils/react.py

@@ -67,13 +67,17 @@ class fastWorkflowReAct(Module):
             args={},
         )
 
-        for idx, tool in enumerate(tools.values()):
-            instr.append(f"({idx + 1}) {tool}")
+        instr.extend(f"({idx + 1}) {tool}" for idx, tool in enumerate(tools.values()))
         instr.append("When providing `next_tool_args`, the value inside the field must be in JSON format")
 
+        # Build the ReAct signature with trajectory and available_commands inputs.
+        # available_commands is injected into system message by CommandsSystemPreludeAdapter
+        # (see fastworkflow/utils/chat_adapter.py) and is NOT included in the trajectory
+        # formatting to avoid token bloat across iterations.
         react_signature = (
             dspy.Signature({**signature.input_fields}, "\n".join(instr))
             .append("trajectory", dspy.InputField(), type_=str)
+            .append("available_commands", dspy.InputField(), type_=str)
             .append("next_thought", dspy.OutputField(), type_=str)
             .append("next_tool_name", dspy.OutputField(), type_=Literal[tuple(tools.keys())])
             .append("next_tool_args", dspy.OutputField(), type_=dict[str, Any])
@@ -82,7 +86,7 @@ class fastWorkflowReAct(Module):
         fallback_signature = dspy.Signature(
             {**signature.input_fields, **signature.output_fields},
             signature.instructions,
-        ).append("trajectory", dspy.InputField(), type_=str)
+        ).append("trajectory", dspy.InputField(), type_=str).append("available_commands", dspy.InputField(), type_=str)
 
         self.tools = tools
         self.react = dspy.Predict(react_signature)

{fastworkflow-2.17.5.dist-info → fastworkflow-2.17.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.17.5
+Version: 2.17.6
 Summary: A framework for rapidly building large-scale, deterministic, interactive workflows with a fault-tolerant, conversational UX
 License: Apache-2.0
 Keywords: fastworkflow,ai,workflow,llm,openai

{fastworkflow-2.17.5.dist-info → fastworkflow-2.17.6.dist-info}/RECORD

@@ -35,7 +35,7 @@ fastworkflow/build/navigator_stub_generator.py,sha256=_DSvHC6r1xWQiFHtUgPhI51nQf
 fastworkflow/build/pydantic_model_generator.py,sha256=oNyoANyUWBpHG-fE3tGL911RNvDzQXjxAm0ssvuXUH4,1854
 fastworkflow/build/utterance_generator.py,sha256=UrtkF0wyAZ1hiFitHX0g8w7Wh-D0leLCrP1aUACSfHo,299
 fastworkflow/cache_matching.py,sha256=OoB--1tO6-O4BKCuCrUbB0CkUr76J62K4VAf6MShi-w,7984
-fastworkflow/chat_session.py,sha256=mduwtY27MV5YcabUbaFDXyRalVVNLUpp7ZFNiOV9ewc,31627
+fastworkflow/chat_session.py,sha256=u3aQauea5vYmt98_ADTkWzkF_WsJaaiA8AX6OlGeyf8,32332
 fastworkflow/cli.py,sha256=n-PFDC0EOkq1zIK1Ip44at-VcaP9cW9aSxZ2IVj3VoE,23796
 fastworkflow/command_context_model.py,sha256=bQadDB_IH2lc0br46IT07Iej_j2KrAMderiVKqU7gno,15914
 fastworkflow/command_directory.py,sha256=aJ6UQCwevfF11KbcQB2Qz6mQ7Kj91pZtvHmQY6JFnao,29030
@@ -158,6 +158,7 @@ fastworkflow/train/__main__.py,sha256=AeGja42d0QhslQkxvDVigIluxxL7DYLdQPXYFOKQ7Q
 fastworkflow/train/generate_synthetic.py,sha256=sTDk-E5ewkS4o-0LJeofiEv4uXGpqdGcFRYKY_Yf36Y,5322
 fastworkflow/user_message_queues.py,sha256=svbuFxQ16q6Tz6urPWfD4IEsOTMxtS1Kc1PP8EE8AWg,1422
 fastworkflow/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastworkflow/utils/chat_adapter.py,sha256=ujJaq0eGT1EvgDXUOZFVMuLrwhOzawi0LXsengN1DdM,4062
 fastworkflow/utils/command_dependency_graph.py,sha256=7YmAnVXcaLsPVeC3SvM4pGdUsCUxWM4H2qXrtGwQpAI,13512
 fastworkflow/utils/context_utils.py,sha256=mjYVzNJCmimNMmBdOKfzFeDSws_oAADAwcfz_N6sR7M,749
 fastworkflow/utils/dspy_cache_utils.py,sha256=OP2IsWPMGCdhjC-4iRqggWgTEfvPxFN_78tV1_C6uHY,3725
@@ -170,14 +171,14 @@ fastworkflow/utils/logging.py,sha256=2SA-04fg7Lx_vGf980tfCOGDQxBvU9X6Vbhv47rbdaw
 fastworkflow/utils/parameterize_func_decorator.py,sha256=V6YJnishWRCdwiBQW6P17hmGGrga0Empk-AN5Gm7iMk,633
 fastworkflow/utils/pydantic_model_2_dspy_signature_class.py,sha256=w1pvl8rJq48ulFwaAtBgfXYn_SBIDBgq1aLMUg1zJn8,12875
 fastworkflow/utils/python_utils.py,sha256=D0JBdzkwKoyK7XvZcnIxOgsS8CRGdvuW-zcO45_pfOA,8252
-fastworkflow/utils/react.py,sha256=HubwmM4H9UzLaLaeIkJseKCNMjyrOXvMZz-8sw4ycCE,11224
+fastworkflow/utils/react.py,sha256=2nsmtwFZJ9QkZqNxDt94a1cpuFSZplTTYeH-Z2dEX5s,11668
 fastworkflow/utils/signatures.py,sha256=QOLX3j-AJkRWIkDhogbhxQo8MIt668xIKwd4SWiS2LY,31734
 fastworkflow/utils/startup_progress.py,sha256=9icSdnpFAxzIq0sUliGpNaH0Efvrt5lDtGfURV5BD98,3539
 fastworkflow/workflow.py,sha256=37gn7e3ct-gdGw43zS6Ab_ADoJJBO4eJW2PywfUpjEg,18825
 fastworkflow/workflow_agent.py,sha256=-RXoHXH-vrEh6AWC6iYAwwR9CvaRynYuu-KrzOPCJbg,16348
 fastworkflow/workflow_inheritance_model.py,sha256=Pp-qSrQISgPfPjJVUfW84pc7HLmL2evuq0UVIYR51K0,7974
-fastworkflow-2.17.5.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-fastworkflow-2.17.5.dist-info/METADATA,sha256=ZQS_0wRF3-QBbTIhRwwHzpTgeDHzz2gxBogyK0JLX7Q,30634
-fastworkflow-2.17.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-fastworkflow-2.17.5.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
-fastworkflow-2.17.5.dist-info/RECORD,,
+fastworkflow-2.17.6.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+fastworkflow-2.17.6.dist-info/METADATA,sha256=u9UC1o2IBRPhTWO6a8fHxkRz1swR19md9xeIrc6gmwQ,30634
+fastworkflow-2.17.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+fastworkflow-2.17.6.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
+fastworkflow-2.17.6.dist-info/RECORD,,