fluxloop-cli 0.2.22__tar.gz → 0.2.24__tar.gz

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fluxloop-cli
-Version: 0.2.22
+Version: 0.2.24
 Summary: FluxLoop CLI for running agent simulations
 Author-email: FluxLoop Team <team@fluxloop.dev>
 License: Apache-2.0
@@ -26,6 +26,7 @@ Requires-Dist: httpx>=0.24.0
 Requires-Dist: rich>=13.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: fluxloop>=0.1.0
+Requires-Dist: ruamel.yaml>=0.17.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -83,6 +84,8 @@ The legacy `setting.yaml` is still supported, but new projects created with
 
 These flags override the values in `configs/simulation.yaml` (`multi_turn` block). When enabled, the runner consults the supervisor after every turn to decide whether to continue and to synthesize the next realistic user message.
 
+**Scripted Playback Mode**: For deterministic multi-turn scenarios, switch `supervisor.provider` to `mock` and populate `supervisor.metadata.scripted_questions` with a list of user messages. FluxLoop will replay them sequentially and terminate when the script ends—ideal for regression testing and demos.
+
 Run `fluxloop --help` or `fluxloop <command> --help` for more detail.
 
 ## Quick Setup Script

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/README.md

@@ -43,6 +43,8 @@ The legacy `setting.yaml` is still supported, but new projects created with
 
 These flags override the values in `configs/simulation.yaml` (`multi_turn` block). When enabled, the runner consults the supervisor after every turn to decide whether to continue and to synthesize the next realistic user message.
 
+**Scripted Playback Mode**: For deterministic multi-turn scenarios, switch `supervisor.provider` to `mock` and populate `supervisor.metadata.scripted_questions` with a list of user messages. FluxLoop will replay them sequentially and terminate when the script ends—ideal for regression testing and demos.
+
 Run `fluxloop --help` or `fluxloop <command> --help` for more detail.
 
 ## Quick Setup Script

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli/__init__.py

@@ -2,7 +2,7 @@
 FluxLoop CLI - Command-line interface for running agent simulations.
 """
 
-__version__ = "0.2.22"
+__version__ = "0.2.24"
 
 from .main import app
 

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli/commands/record.py

@@ -8,6 +8,7 @@ from typing import Dict, Optional
 import typer
 from rich.console import Console
 from rich.table import Table
+from ruamel.yaml import YAML, CommentedMap
 
 from ..constants import DEFAULT_ROOT_DIR_NAME
 from ..project_paths import (
@@ -20,6 +21,9 @@ from ..config_schema import CONFIG_SECTION_FILENAMES
 
 app = typer.Typer()
 console = Console()
+_yaml = YAML()
+_yaml.indent(mapping=2, sequence=4, offset=2)
+_yaml.preserve_quotes = True
 
 
 def _load_env(env_path: Path) -> Dict[str, str]:
@@ -44,22 +48,25 @@ def _update_simulation(recording_enabled: bool, project: Optional[str], root: Pa
     except KeyError:
         return
 
-    data: Dict[str, object] = {}
     if simulation_path.exists():
-        import yaml
+        with simulation_path.open("r", encoding="utf-8") as handle:
+            loaded = _yaml.load(handle) or CommentedMap()
+    else:
+        loaded = CommentedMap()
 
-        data = yaml.safe_load(simulation_path.read_text()) or {}
+    if not isinstance(loaded, CommentedMap):
+        loaded = CommentedMap(loaded)
 
-    replay = data.setdefault("replay_args", {})
-    replay["enabled"] = recording_enabled
+    replay = loaded.get("replay_args")
+    if not isinstance(replay, CommentedMap):
+        replay = CommentedMap(replay or {})
+        loaded["replay_args"] = replay
 
-    import yaml
+    replay["enabled"] = recording_enabled
 
     simulation_path.parent.mkdir(parents=True, exist_ok=True)
-    simulation_path.write_text(
-        yaml.dump(data, sort_keys=False, default_flow_style=False),
-        encoding="utf-8",
-    )
+    with simulation_path.open("w", encoding="utf-8") as handle:
+        _yaml.dump(loaded, handle)
 
 
 @app.command()

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli/conversation_supervisor.py

@@ -119,7 +119,7 @@ class ConversationSupervisor:
 
         provider = (self.config.provider or "openai").lower()
         if provider == "mock":
-            return self._mock_decision()
+            return self._mock_decision(conversation_state)
         if provider == "openai":
             response_text = await self._call_openai(prompt)
         else:
@@ -127,10 +127,45 @@ class ConversationSupervisor:
 
         return self._parse_decision(response_text)
 
-    def _mock_decision(self) -> SupervisorDecision:
-        """Deterministic supervisor used for tests or offline runs."""
+    def _mock_decision(self, conversation_state: Dict[str, Any]) -> SupervisorDecision:
+        """Deterministic supervisor used for tests, scripted runs, or offline modes."""
 
         metadata = self.config.metadata or {}
+
+        scripted_questions = metadata.get("scripted_questions")
+        if isinstance(scripted_questions, list):
+            context = conversation_state.setdefault("context", {})
+            index = int(context.get("mock_script_index", 0))
+            script_length = len(scripted_questions)
+
+            if index < script_length:
+                next_message = scripted_questions[index]
+                context["mock_script_index"] = index + 1
+                return SupervisorDecision(
+                    decision="continue",
+                    next_user_message=str(next_message),
+                    raw_response={
+                        "mock": True,
+                        "scripted": True,
+                        "script_index": index,
+                        "script_length": script_length,
+                    },
+                )
+
+            reason = metadata.get("mock_reason", "script_complete")
+            closing = metadata.get("mock_closing")
+            return SupervisorDecision(
+                decision="terminate",
+                termination_reason=reason,
+                closing_user_message=closing,
+                raw_response={
+                    "mock": True,
+                    "scripted": True,
+                    "script_complete": True,
+                    "script_length": script_length,
+                },
+            )
+
         default_decision = metadata.get("mock_decision", "terminate")
         decision: SupervisorDecisionType = (
             default_decision if default_decision in {"continue", "terminate"} else "terminate"
@@ -181,8 +216,9 @@ class ConversationSupervisor:
         payload = {
             "model": self.config.model,
             "messages": messages,
-            "temperature": self.config.temperature,
         }
+        if self.config.temperature is not None:
+            payload["temperature"] = self.config.temperature
 
         async with httpx.AsyncClient(timeout=60) as client:
             response = await client.post(

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli/templates.py

@@ -35,6 +35,8 @@ def create_project_config(project_name: str) -> str:
         metadata:
           team: development
           environment: local
+          service_context: ""
+          # Describe the overall service scenario (used by multi-turn supervisor)
           # Add any custom fields used by dashboards or automation tools.
         """
     ).strip() + "\n"
@@ -140,19 +142,23 @@ def create_simulation_config(project_name: str) -> str:
           override_param_path: data.content
 
         multi_turn:
-          enabled: false              # Enable to drive conversations via supervisor LLM
+          enabled: false              # Enable to drive conversations via supervisor
           max_turns: 8                # Safety cap on total turns per conversation
           auto_approve_tools: true    # Automatically approve tool calls when supported
           persona_override: null      # Force a specific persona id (optional)
           supervisor:
-            provider: openai
+            provider: openai          # openai (LLM generated) | mock (scripted playback)
             model: gpt-5-mini
-            temperature: 0.2
             system_prompt: |
               You supervise an AI assistant supporting customers.
               Review the entire transcript and decide whether to continue.
               When continuing, craft the next user message consistent with the persona.
               When terminating, explain the reason and provide any closing notes.
+            metadata:
+              scripted_questions: []  # Array of user utterances for sequential playback (e.g., ["First question", "Second question", ...])
+              mock_decision: terminate        # Fallback when no scripted questions remain
+              mock_reason: script_complete    # Termination reason for scripted runs
+              mock_closing: "Thanks for the help. I have no further questions."
 
         output_directory: experiments
         save_traces: true

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fluxloop-cli
-Version: 0.2.22
+Version: 0.2.24
 Summary: FluxLoop CLI for running agent simulations
 Author-email: FluxLoop Team <team@fluxloop.dev>
 License: Apache-2.0
@@ -26,6 +26,7 @@ Requires-Dist: httpx>=0.24.0
 Requires-Dist: rich>=13.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: fluxloop>=0.1.0
+Requires-Dist: ruamel.yaml>=0.17.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -83,6 +84,8 @@ The legacy `setting.yaml` is still supported, but new projects created with
 
 These flags override the values in `configs/simulation.yaml` (`multi_turn` block). When enabled, the runner consults the supervisor after every turn to decide whether to continue and to synthesize the next realistic user message.
 
+**Scripted Playback Mode**: For deterministic multi-turn scenarios, switch `supervisor.provider` to `mock` and populate `supervisor.metadata.scripted_questions` with a list of user messages. FluxLoop will replay them sequentially and terminate when the script ends—ideal for regression testing and demos.
+
 Run `fluxloop --help` or `fluxloop <command> --help` for more detail.
 
 ## Quick Setup Script

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/fluxloop_cli.egg-info/requires.txt

@@ -5,6 +5,7 @@ httpx>=0.24.0
 rich>=13.0
 python-dotenv>=1.0.0
 fluxloop>=0.1.0
+ruamel.yaml>=0.17.0
 
 [anthropic]
 anthropic>=0.7.0

{fluxloop_cli-0.2.22 → fluxloop_cli-0.2.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fluxloop-cli"
-version = "0.2.22"
+version = "0.2.24"
 description = "FluxLoop CLI for running agent simulations"
 authors = [
     {name = "FluxLoop Team", email = "team@fluxloop.dev"}
@@ -32,6 +32,7 @@ dependencies = [
     "rich>=13.0",
     "python-dotenv>=1.0.0",
     "fluxloop>=0.1.0",
+    "ruamel.yaml>=0.17.0",
 ]
 
 [project.optional-dependencies]