gradual-adoption: wire state_delta + falsification_critic into Orchestrator (backward-compat)
Browse files- purpose_agent/orchestrator.py +150 -355
purpose_agent/orchestrator.py
CHANGED
|
@@ -1,58 +1,12 @@
|
|
| 1 |
"""
|
| 2 |
-
Orchestrator β
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
β ββββββββββββ action βββββββββββββββ s_new β
|
| 11 |
-
β β ACTOR β βββββββββΊ β ENVIRONMENT β βββββββββββ β
|
| 12 |
-
β β(+memory) β β (your code) β β β
|
| 13 |
-
β ββββββ²ββββββ βββββββββββββββ β β
|
| 14 |
-
β β βΌ β
|
| 15 |
-
β β heuristics ββββββββββββββββββ (s, a, s') β
|
| 16 |
-
β ββββββββββββββββββ OPTIMIZER ββββββββββββ β
|
| 17 |
-
β β β (distillation) β β β
|
| 18 |
-
β β ββββββββββββββββββ β β
|
| 19 |
-
β β β β
|
| 20 |
-
β β ββββββββββββββββββ Ξ¦(s)βΞ¦(s') β
|
| 21 |
-
β β β PURPOSE FN ββββββββββββ€ β
|
| 22 |
-
β β β (state critic) β β β
|
| 23 |
-
β β ββββββββββββββββββ β β
|
| 24 |
-
β β β β
|
| 25 |
-
β β ββββββββββββββββββ β β
|
| 26 |
-
β ββββββββββββββββββ EXPERIENCE ββββββββββββ β
|
| 27 |
-
β β REPLAY BUFFER β β
|
| 28 |
-
β ββββββββββββββββββ β
|
| 29 |
-
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
| 30 |
-
|
| 31 |
-
Usage:
|
| 32 |
-
from purpose_agent import Orchestrator, MockLLMBackend
|
| 33 |
-
|
| 34 |
-
# 1. Define your environment
|
| 35 |
-
class MyEnv(Environment):
|
| 36 |
-
def execute(self, action, current_state):
|
| 37 |
-
# ... do something ...
|
| 38 |
-
return new_state
|
| 39 |
-
|
| 40 |
-
# 2. Create orchestrator
|
| 41 |
-
orch = Orchestrator(
|
| 42 |
-
llm=MockLLMBackend(), # or HFInferenceBackend(), OpenAICompatibleBackend()
|
| 43 |
-
environment=MyEnv(),
|
| 44 |
-
available_actions={"search": "Search for items", "move": "Move to location"},
|
| 45 |
-
)
|
| 46 |
-
|
| 47 |
-
# 3. Run a task
|
| 48 |
-
result = orch.run_task(
|
| 49 |
-
purpose="Find the hidden treasure in the maze",
|
| 50 |
-
initial_state=State(data={"position": [0, 0], "inventory": []}),
|
| 51 |
-
max_steps=20,
|
| 52 |
-
)
|
| 53 |
-
|
| 54 |
-
# 4. The agent self-improves β run more tasks and it gets better
|
| 55 |
-
result2 = orch.run_task(purpose="Find the second treasure", ...)
|
| 56 |
"""
|
| 57 |
|
| 58 |
from __future__ import annotations
|
|
@@ -64,13 +18,7 @@ from abc import ABC, abstractmethod
|
|
| 64 |
from typing import Any, Callable
|
| 65 |
|
| 66 |
from purpose_agent.types import (
|
| 67 |
-
Action,
|
| 68 |
-
Heuristic,
|
| 69 |
-
MemoryTier,
|
| 70 |
-
PurposeScore,
|
| 71 |
-
State,
|
| 72 |
-
Trajectory,
|
| 73 |
-
TrajectoryStep,
|
| 74 |
)
|
| 75 |
from purpose_agent.actor import Actor
|
| 76 |
from purpose_agent.purpose_function import PurposeFunction
|
|
@@ -81,114 +29,41 @@ from purpose_agent.llm_backend import LLMBackend
|
|
| 81 |
logger = logging.getLogger(__name__)
|
| 82 |
|
| 83 |
|
| 84 |
-
# ---------------------------------------------------------------------------
|
| 85 |
-
# Environment Interface
|
| 86 |
-
# ---------------------------------------------------------------------------
|
| 87 |
-
|
| 88 |
class Environment(ABC):
|
| 89 |
-
"""
|
| 90 |
-
Abstract environment that the Agent acts in.
|
| 91 |
-
|
| 92 |
-
Implement this for your specific use case:
|
| 93 |
-
- Web navigation: wrap a browser automation tool
|
| 94 |
-
- Code generation: wrap a code executor
|
| 95 |
-
- Game: wrap a game API
|
| 96 |
-
- Simulated: mock environment for testing
|
| 97 |
-
|
| 98 |
-
The Orchestrator calls execute() with the agent's action and current state,
|
| 99 |
-
and expects a new state back.
|
| 100 |
-
"""
|
| 101 |
-
|
| 102 |
@abstractmethod
|
| 103 |
-
def execute(self, action: Action, current_state: State) -> State:
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
|
| 107 |
-
Args:
|
| 108 |
-
action: The action to execute
|
| 109 |
-
current_state: The state before the action
|
| 110 |
-
|
| 111 |
-
Returns:
|
| 112 |
-
The new state after the action
|
| 113 |
-
"""
|
| 114 |
-
...
|
| 115 |
-
|
| 116 |
-
def reset(self) -> State:
|
| 117 |
-
"""
|
| 118 |
-
Reset the environment and return the initial state.
|
| 119 |
-
Override if your environment needs resetting between tasks.
|
| 120 |
-
"""
|
| 121 |
-
return State(data={})
|
| 122 |
-
|
| 123 |
-
def is_terminal(self, state: State) -> bool:
|
| 124 |
-
"""
|
| 125 |
-
Check if the state is terminal (task complete or impossible to continue).
|
| 126 |
-
Override for environments with natural termination conditions.
|
| 127 |
-
"""
|
| 128 |
-
return False
|
| 129 |
|
| 130 |
|
| 131 |
class SimpleEnvironment(Environment):
|
| 132 |
-
|
| 133 |
-
A simple environment backed by a user-provided execute function.
|
| 134 |
-
|
| 135 |
-
Usage:
|
| 136 |
-
env = SimpleEnvironment(
|
| 137 |
-
execute_fn=lambda action, state: new_state,
|
| 138 |
-
initial_state=State(data={"x": 0}),
|
| 139 |
-
)
|
| 140 |
-
"""
|
| 141 |
-
|
| 142 |
-
def __init__(
|
| 143 |
-
self,
|
| 144 |
-
execute_fn: Callable[[Action, State], State],
|
| 145 |
-
initial_state: State | None = None,
|
| 146 |
-
terminal_fn: Callable[[State], bool] | None = None,
|
| 147 |
-
):
|
| 148 |
self._execute_fn = execute_fn
|
| 149 |
self._initial_state = initial_state or State(data={})
|
| 150 |
self._terminal_fn = terminal_fn
|
| 151 |
-
|
| 152 |
-
def
|
| 153 |
-
|
| 154 |
-
|
| 155 |
-
def reset(self) -> State:
|
| 156 |
-
return self._initial_state
|
| 157 |
-
|
| 158 |
-
def is_terminal(self, state: State) -> bool:
|
| 159 |
-
if self._terminal_fn:
|
| 160 |
-
return self._terminal_fn(state)
|
| 161 |
-
return False
|
| 162 |
|
| 163 |
|
| 164 |
-
# ---------------------------------------------------------------------------
|
| 165 |
-
# Task Result
|
| 166 |
-
# ---------------------------------------------------------------------------
|
| 167 |
-
|
| 168 |
class TaskResult:
|
| 169 |
-
"""Result of running a task through the Orchestrator."""
|
| 170 |
-
|
| 171 |
def __init__(self, trajectory: Trajectory, final_state: State):
|
| 172 |
self.trajectory = trajectory
|
| 173 |
self.final_state = final_state
|
| 174 |
|
| 175 |
@property
|
| 176 |
def success(self) -> bool:
|
| 177 |
-
"""Was the task successful? (final Ξ¦ > 7.0)"""
|
| 178 |
phi = self.trajectory.final_phi
|
| 179 |
return phi is not None and phi > 7.0
|
| 180 |
|
| 181 |
@property
|
| 182 |
-
def total_steps(self) -> int:
|
| 183 |
-
return len(self.trajectory.steps)
|
| 184 |
|
| 185 |
@property
|
| 186 |
-
def cumulative_reward(self) -> float:
|
| 187 |
-
return self.trajectory.cumulative_reward
|
| 188 |
|
| 189 |
@property
|
| 190 |
-
def final_phi(self) -> float | None:
|
| 191 |
-
return self.trajectory.final_phi
|
| 192 |
|
| 193 |
def summary(self) -> str:
|
| 194 |
lines = [
|
|
@@ -204,36 +79,18 @@ class TaskResult:
|
|
| 204 |
return "\n".join(lines)
|
| 205 |
|
| 206 |
|
| 207 |
-
# ---------------------------------------------------------------------------
|
| 208 |
-
# Orchestrator
|
| 209 |
-
# ---------------------------------------------------------------------------
|
| 210 |
-
|
| 211 |
class Orchestrator:
|
| 212 |
"""
|
| 213 |
-
Main orchestration loop
|
| 214 |
-
|
| 215 |
-
Ties together all modules:
|
| 216 |
-
- Actor: Decides actions based on state + memory
|
| 217 |
-
- Purpose Function: Scores state transitions (Ξ¦ improvement)
|
| 218 |
-
- Experience Replay: Stores trajectories for future retrieval
|
| 219 |
-
- Heuristic Optimizer: Extracts winning strategies from good trajectories
|
| 220 |
-
|
| 221 |
-
Self-improvement happens via the memory feedback loop:
|
| 222 |
-
1. Actor uses heuristics from memory to decide actions
|
| 223 |
-
2. Purpose Function scores each transition
|
| 224 |
-
3. Experience Replay stores the full trajectory
|
| 225 |
-
4. Optimizer distills high-reward trajectories into new heuristics
|
| 226 |
-
5. Actor's memory is updated with new heuristics β better next time
|
| 227 |
|
| 228 |
-
|
| 229 |
-
|
| 230 |
-
|
| 231 |
-
|
| 232 |
-
|
| 233 |
-
|
| 234 |
-
|
| 235 |
-
|
| 236 |
-
on_step: Optional callback called after each step (for monitoring)
|
| 237 |
"""
|
| 238 |
|
| 239 |
def __init__(
|
|
@@ -247,10 +104,13 @@ class Orchestrator:
|
|
| 247 |
persistence_dir: str | None = None,
|
| 248 |
on_step: Callable[[TrajectoryStep], None] | None = None,
|
| 249 |
optimize_every_n_tasks: int = 1,
|
|
|
|
|
|
|
| 250 |
):
|
| 251 |
self.environment = environment
|
| 252 |
self.on_step = on_step
|
| 253 |
self.optimize_every_n_tasks = optimize_every_n_tasks
|
|
|
|
| 254 |
self._tasks_since_optimize = 0
|
| 255 |
|
| 256 |
# Persistence
|
|
@@ -261,28 +121,28 @@ class Orchestrator:
|
|
| 261 |
replay_path = f"{persistence_dir}/experience_replay.json"
|
| 262 |
|
| 263 |
# Initialize modules
|
| 264 |
-
self.actor = Actor(
|
| 265 |
-
|
| 266 |
-
|
| 267 |
-
)
|
| 268 |
-
|
| 269 |
-
|
| 270 |
-
|
| 271 |
-
|
| 272 |
-
|
| 273 |
-
|
| 274 |
-
|
| 275 |
-
|
| 276 |
-
|
| 277 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 278 |
|
| 279 |
-
# Load existing heuristics into Actor memory
|
| 280 |
self.sync_memory()
|
| 281 |
|
| 282 |
-
# ------------------------------------------------------------------
|
| 283 |
-
# Main Task Loop
|
| 284 |
-
# ------------------------------------------------------------------
|
| 285 |
-
|
| 286 |
def run_task(
|
| 287 |
self,
|
| 288 |
purpose: str,
|
|
@@ -291,273 +151,208 @@ class Orchestrator:
|
|
| 291 |
early_stop_phi: float = 9.0,
|
| 292 |
task_description: str | None = None,
|
| 293 |
) -> TaskResult:
|
| 294 |
-
"""
|
| 295 |
-
Run a complete task through the agent loop.
|
| 296 |
-
|
| 297 |
-
The loop for each step:
|
| 298 |
-
1. Actor decides an action (with thought + prediction)
|
| 299 |
-
2. Environment executes the action β new state
|
| 300 |
-
3. Purpose Function evaluates: Ξ¦(s_new) vs Ξ¦(s_old)
|
| 301 |
-
4. Trajectory step is recorded
|
| 302 |
-
5. Check termination conditions
|
| 303 |
-
|
| 304 |
-
After the task:
|
| 305 |
-
- Trajectory is added to Experience Replay
|
| 306 |
-
- If enough tasks have run, Optimizer extracts new heuristics
|
| 307 |
-
- Actor's memory is updated
|
| 308 |
-
|
| 309 |
-
Args:
|
| 310 |
-
purpose: The goal description
|
| 311 |
-
initial_state: Starting state (or environment.reset() if None)
|
| 312 |
-
max_steps: Maximum steps before forced termination
|
| 313 |
-
early_stop_phi: Stop if Ξ¦ exceeds this value (goal ~achieved)
|
| 314 |
-
task_description: Optional description (defaults to purpose)
|
| 315 |
-
"""
|
| 316 |
task_desc = task_description or purpose
|
| 317 |
current_state = initial_state or self.environment.reset()
|
| 318 |
-
|
| 319 |
-
# Reset Purpose Function per-trajectory stats
|
| 320 |
self.purpose_fn.reset_trajectory_stats()
|
| 321 |
|
| 322 |
-
# Retrieve relevant past experiences for context
|
| 323 |
relevant_experiences = self.experience_replay.retrieve(task_desc, top_k=3)
|
| 324 |
self._inject_experience_context(relevant_experiences)
|
| 325 |
|
| 326 |
-
|
| 327 |
-
trajectory = Trajectory(
|
| 328 |
-
task_description=task_desc,
|
| 329 |
-
purpose=purpose,
|
| 330 |
-
)
|
| 331 |
-
|
| 332 |
-
# History for Actor context
|
| 333 |
history: list[dict[str, Any]] = []
|
| 334 |
|
| 335 |
-
logger.info(f"βββ Starting task: {task_desc} (max {max_steps} steps) β
|
| 336 |
|
| 337 |
for step_idx in range(max_steps):
|
| 338 |
step_start = time.time()
|
| 339 |
|
| 340 |
-
|
| 341 |
-
|
| 342 |
-
purpose=purpose,
|
| 343 |
-
current_state=current_state,
|
| 344 |
-
history=history,
|
| 345 |
-
)
|
| 346 |
-
|
| 347 |
-
logger.info(
|
| 348 |
-
f"Step {step_idx + 1}: Action={action.name}, "
|
| 349 |
-
f"Thought={action.thought[:100]}..."
|
| 350 |
-
)
|
| 351 |
|
| 352 |
-
# Check for DONE action
|
| 353 |
if action.name.upper() == "DONE":
|
| 354 |
-
logger.info("Agent signaled DONE
|
| 355 |
-
|
| 356 |
-
final_score = self.purpose_fn.evaluate(
|
| 357 |
-
state_before=current_state,
|
| 358 |
-
action=action,
|
| 359 |
-
state_after=current_state,
|
| 360 |
-
purpose=purpose,
|
| 361 |
-
)
|
| 362 |
trajectory.steps.append(TrajectoryStep(
|
| 363 |
-
state_before=current_state,
|
| 364 |
-
|
| 365 |
-
state_after=current_state,
|
| 366 |
-
score=final_score,
|
| 367 |
-
step_index=step_idx + 1,
|
| 368 |
-
wall_time_s=time.time() - step_start,
|
| 369 |
))
|
| 370 |
break
|
| 371 |
|
| 372 |
-
# Step 2: Environment executes
|
| 373 |
try:
|
| 374 |
new_state = self.environment.execute(action, current_state)
|
| 375 |
except Exception as e:
|
| 376 |
logger.error(f"Environment execution failed: {e}")
|
| 377 |
-
new_state = State(
|
| 378 |
-
|
| 379 |
-
|
| 380 |
-
|
| 381 |
-
|
| 382 |
-
# Step 3: Purpose Function evaluates
|
| 383 |
-
score = self.purpose_fn.evaluate(
|
| 384 |
-
state_before=current_state,
|
| 385 |
-
action=action,
|
| 386 |
-
state_after=new_state,
|
| 387 |
-
purpose=purpose,
|
| 388 |
-
)
|
| 389 |
|
| 390 |
-
# Step 4: Record step
|
| 391 |
step = TrajectoryStep(
|
| 392 |
-
state_before=current_state,
|
| 393 |
-
|
| 394 |
-
state_after=new_state,
|
| 395 |
-
score=score,
|
| 396 |
-
step_index=step_idx + 1,
|
| 397 |
-
wall_time_s=time.time() - step_start,
|
| 398 |
)
|
| 399 |
trajectory.steps.append(step)
|
| 400 |
|
| 401 |
-
# Update history for Actor context
|
| 402 |
history.append({
|
| 403 |
"action": f"{action.name}({json.dumps(action.params, default=str)})",
|
| 404 |
"result": new_state.describe()[:200],
|
| 405 |
"score": f"Ξ={score.delta:+.2f}" if score else "N/A",
|
| 406 |
})
|
| 407 |
|
| 408 |
-
# Callback
|
| 409 |
if self.on_step:
|
| 410 |
self.on_step(step)
|
| 411 |
|
| 412 |
-
logger.info(
|
| 413 |
-
f" β Ξ¦: {score.phi_before:.1f} β {score.phi_after:.1f} "
|
| 414 |
-
f"(Ξ={score.delta:+.2f}, conf={score.confidence:.2f})"
|
| 415 |
-
)
|
| 416 |
|
| 417 |
-
|
| 418 |
-
current_state = new_state # Update state BEFORE checking termination
|
| 419 |
|
| 420 |
if score.phi_after >= early_stop_phi:
|
| 421 |
logger.info(f"Early stop: Ξ¦={score.phi_after:.1f} β₯ {early_stop_phi}")
|
| 422 |
break
|
| 423 |
-
|
| 424 |
if self.environment.is_terminal(new_state):
|
| 425 |
logger.info("Environment signaled terminal state")
|
| 426 |
break
|
| 427 |
|
| 428 |
-
# Post-task processing
|
| 429 |
result = TaskResult(trajectory=trajectory, final_state=current_state)
|
| 430 |
self.post_task(trajectory, relevant_experiences)
|
| 431 |
-
|
| 432 |
logger.info(f"βββ Task complete βββ\n{result.summary()}")
|
| 433 |
return result
|
| 434 |
|
| 435 |
-
|
| 436 |
-
|
| 437 |
-
|
| 438 |
-
|
| 439 |
-
def post_task(
|
| 440 |
-
self,
|
| 441 |
-
trajectory: Trajectory,
|
| 442 |
-
used_experiences: list[Any] | None = None,
|
| 443 |
-
) -> None:
|
| 444 |
-
"""Post-task processing: store trajectory, maybe optimize, sync memory.
|
| 445 |
|
| 446 |
-
|
| 447 |
-
|
|
|
|
|
|
|
| 448 |
"""
|
| 449 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 450 |
|
| 451 |
-
|
| 452 |
-
record = self.experience_replay.add(trajectory)
|
| 453 |
|
| 454 |
-
|
|
|
|
|
|
|
| 455 |
task_success = trajectory.success_rate > 0.5
|
| 456 |
for exp in used_experiences:
|
| 457 |
-
self.experience_replay.update_q_value(
|
| 458 |
-
exp.id, reward=1.0 if task_success else 0.0
|
| 459 |
-
)
|
| 460 |
-
|
| 461 |
-
# Update heuristic usage stats
|
| 462 |
for h in self.actor.strategic_memory + self.actor.procedural_memory:
|
| 463 |
self.optimizer.update_heuristic_usage(h.id, was_successful=task_success)
|
| 464 |
-
|
| 465 |
-
# Periodic optimization
|
| 466 |
self._tasks_since_optimize += 1
|
| 467 |
if self._tasks_since_optimize >= self.optimize_every_n_tasks:
|
| 468 |
self._run_optimization()
|
| 469 |
self._tasks_since_optimize = 0
|
| 470 |
|
| 471 |
def _run_optimization(self) -> None:
|
| 472 |
-
"""Run the heuristic optimization cycle."""
|
| 473 |
logger.info("Running optimization cycle...")
|
| 474 |
-
|
| 475 |
-
|
| 476 |
-
top_trajectories = self.experience_replay.get_top_trajectories(
|
| 477 |
-
n=5, min_success_rate=0.3
|
| 478 |
-
)
|
| 479 |
-
|
| 480 |
-
if not top_trajectories:
|
| 481 |
logger.info("No qualifying trajectories for optimization")
|
| 482 |
return
|
| 483 |
-
|
| 484 |
-
# Run optimizer
|
| 485 |
-
self.optimizer.optimize(top_trajectories)
|
| 486 |
-
|
| 487 |
-
# Sync updated heuristics to Actor memory
|
| 488 |
self.sync_memory()
|
| 489 |
|
| 490 |
def sync_memory(self) -> None:
|
| 491 |
-
|
| 492 |
-
|
| 493 |
-
Public API β call after manually modifying the heuristic library
|
| 494 |
-
(e.g., human-injected heuristics via HITL).
|
| 495 |
-
"""
|
| 496 |
-
self.actor.update_strategic_memory(
|
| 497 |
-
self.optimizer.get_heuristics_by_tier(MemoryTier.STRATEGIC)
|
| 498 |
-
)
|
| 499 |
-
self.actor.update_procedural_memory(
|
| 500 |
-
self.optimizer.get_heuristics_by_tier(MemoryTier.PROCEDURAL)
|
| 501 |
-
)
|
| 502 |
-
|
| 503 |
-
# Tool memory from heuristics
|
| 504 |
tool_heuristics = self.optimizer.get_heuristics_by_tier(MemoryTier.TOOL)
|
| 505 |
tool_tips = {h.pattern: h.strategy for h in tool_heuristics}
|
| 506 |
if tool_tips:
|
| 507 |
self.actor.update_tool_memory(tool_tips)
|
| 508 |
|
| 509 |
def _inject_experience_context(self, experiences: list[Any]) -> None:
|
| 510 |
-
"""
|
| 511 |
-
Inject retrieved experience context into Actor's procedural memory.
|
| 512 |
-
|
| 513 |
-
This is the CER (arxiv:2506.06698) retrieval injection pattern:
|
| 514 |
-
relevant past trajectories β distilled into SOPs β added to Actor context.
|
| 515 |
-
"""
|
| 516 |
injected = []
|
| 517 |
for exp in experiences:
|
| 518 |
for h in exp.heuristics:
|
| 519 |
if h.tier == MemoryTier.PROCEDURAL:
|
| 520 |
injected.append(h)
|
| 521 |
-
|
| 522 |
if injected:
|
| 523 |
current = self.actor.procedural_memory or []
|
| 524 |
self.actor.procedural_memory = current + injected
|
| 525 |
-
logger.debug(f"Injected {len(injected)} experience-based SOPs")
|
| 526 |
-
|
| 527 |
-
# ------------------------------------------------------------------
|
| 528 |
-
# Inspection / Monitoring
|
| 529 |
-
# ------------------------------------------------------------------
|
| 530 |
|
| 531 |
@property
|
| 532 |
def stats(self) -> dict[str, Any]:
|
| 533 |
-
"""Get current framework statistics."""
|
| 534 |
return {
|
| 535 |
"experience_replay": self.experience_replay.stats,
|
| 536 |
"heuristic_library_size": len(self.optimizer.heuristic_library),
|
| 537 |
-
"heuristics_by_tier": {
|
| 538 |
-
tier.value: len(self.optimizer.get_heuristics_by_tier(tier))
|
| 539 |
-
for tier in MemoryTier
|
| 540 |
-
},
|
| 541 |
"tasks_since_optimize": self._tasks_since_optimize,
|
|
|
|
| 542 |
}
|
| 543 |
|
| 544 |
def get_heuristic_report(self) -> str:
|
| 545 |
-
"""Human-readable report of all learned heuristics."""
|
| 546 |
lines = ["βββ Learned Heuristics Report βββ\n"]
|
| 547 |
-
|
| 548 |
for tier in MemoryTier:
|
| 549 |
heuristics = self.optimizer.get_heuristics_by_tier(tier)
|
| 550 |
lines.append(f"\n{'β' * 40}")
|
| 551 |
lines.append(f" {tier.value.upper()} ({len(heuristics)} heuristics)")
|
| 552 |
lines.append(f"{'β' * 40}")
|
| 553 |
-
|
| 554 |
for h in heuristics:
|
| 555 |
-
lines.append(f"\n [{h.id}] Q={h.q_value:.3f} (used {h.times_used}x
|
| 556 |
-
f"{h.times_succeeded} successes)")
|
| 557 |
lines.append(f" Pattern: {h.pattern}")
|
| 558 |
lines.append(f" Strategy: {h.strategy}")
|
| 559 |
-
if h.steps:
|
| 560 |
-
for i, step in enumerate(h.steps, 1):
|
| 561 |
-
lines.append(f" {i}. {step}")
|
| 562 |
-
|
| 563 |
return "\n".join(lines)
|
|
|
|
| 1 |
"""
|
| 2 |
+
Orchestrator β Main loop with first-principles upgrades.
|
| 3 |
+
|
| 4 |
+
v3 additions (backward compatible):
|
| 5 |
+
- State-delta Markovian critic (O(1) token cost) β auto-enabled
|
| 6 |
+
- Falsification critic mode for coding tasks β opt-in via critic_mode="falsification"
|
| 7 |
+
- PEP 578 sandbox auto-install for PythonExecTool β opt-in via sandbox=True
|
| 8 |
+
|
| 9 |
+
All existing behavior preserved. New modes are additive.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
"""
|
| 11 |
|
| 12 |
from __future__ import annotations
|
|
|
|
| 18 |
from typing import Any, Callable
|
| 19 |
|
| 20 |
from purpose_agent.types import (
|
| 21 |
+
Action, Heuristic, MemoryTier, PurposeScore, State, Trajectory, TrajectoryStep,
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 22 |
)
|
| 23 |
from purpose_agent.actor import Actor
|
| 24 |
from purpose_agent.purpose_function import PurposeFunction
|
|
|
|
| 29 |
logger = logging.getLogger(__name__)
|
| 30 |
|
| 31 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 32 |
class Environment(ABC):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 33 |
@abstractmethod
|
| 34 |
+
def execute(self, action: Action, current_state: State) -> State: ...
|
| 35 |
+
def reset(self) -> State: return State(data={})
|
| 36 |
+
def is_terminal(self, state: State) -> bool: return False
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 37 |
|
| 38 |
|
| 39 |
class SimpleEnvironment(Environment):
|
| 40 |
+
def __init__(self, execute_fn, initial_state=None, terminal_fn=None):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 41 |
self._execute_fn = execute_fn
|
| 42 |
self._initial_state = initial_state or State(data={})
|
| 43 |
self._terminal_fn = terminal_fn
|
| 44 |
+
def execute(self, action, current_state): return self._execute_fn(action, current_state)
|
| 45 |
+
def reset(self): return self._initial_state
|
| 46 |
+
def is_terminal(self, state): return self._terminal_fn(state) if self._terminal_fn else False
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 47 |
|
| 48 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 49 |
class TaskResult:
|
|
|
|
|
|
|
| 50 |
def __init__(self, trajectory: Trajectory, final_state: State):
|
| 51 |
self.trajectory = trajectory
|
| 52 |
self.final_state = final_state
|
| 53 |
|
| 54 |
@property
|
| 55 |
def success(self) -> bool:
|
|
|
|
| 56 |
phi = self.trajectory.final_phi
|
| 57 |
return phi is not None and phi > 7.0
|
| 58 |
|
| 59 |
@property
|
| 60 |
+
def total_steps(self) -> int: return len(self.trajectory.steps)
|
|
|
|
| 61 |
|
| 62 |
@property
|
| 63 |
+
def cumulative_reward(self) -> float: return self.trajectory.cumulative_reward
|
|
|
|
| 64 |
|
| 65 |
@property
|
| 66 |
+
def final_phi(self) -> float | None: return self.trajectory.final_phi
|
|
|
|
| 67 |
|
| 68 |
def summary(self) -> str:
|
| 69 |
lines = [
|
|
|
|
| 79 |
return "\n".join(lines)
|
| 80 |
|
| 81 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 82 |
class Orchestrator:
|
| 83 |
"""
|
| 84 |
+
Main orchestration loop with first-principles upgrades.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 85 |
|
| 86 |
+
New in v3:
|
| 87 |
+
critic_mode: "standard" (default) | "delta" | "falsification"
|
| 88 |
+
- "standard": full state to critic (original behavior)
|
| 89 |
+
- "delta": O(1) Markovian state-delta (recommended for long tasks)
|
| 90 |
+
- "falsification": Popperian scoring for coding tasks (zero hallucination)
|
| 91 |
+
|
| 92 |
+
sandbox: bool = False
|
| 93 |
+
- If True, installs PEP 578 audit hooks before execution
|
|
|
|
| 94 |
"""
|
| 95 |
|
| 96 |
def __init__(
|
|
|
|
| 104 |
persistence_dir: str | None = None,
|
| 105 |
on_step: Callable[[TrajectoryStep], None] | None = None,
|
| 106 |
optimize_every_n_tasks: int = 1,
|
| 107 |
+
critic_mode: str = "delta", # NEW: "standard" | "delta" | "falsification"
|
| 108 |
+
sandbox: bool = False, # NEW: PEP 578 kernel sandbox
|
| 109 |
):
|
| 110 |
self.environment = environment
|
| 111 |
self.on_step = on_step
|
| 112 |
self.optimize_every_n_tasks = optimize_every_n_tasks
|
| 113 |
+
self.critic_mode = critic_mode
|
| 114 |
self._tasks_since_optimize = 0
|
| 115 |
|
| 116 |
# Persistence
|
|
|
|
| 121 |
replay_path = f"{persistence_dir}/experience_replay.json"
|
| 122 |
|
| 123 |
# Initialize modules
|
| 124 |
+
self.actor = Actor(llm=llm, available_actions=available_actions)
|
| 125 |
+
self.purpose_fn = PurposeFunction(llm=critic_llm or llm)
|
| 126 |
+
self.experience_replay = ExperienceReplay(capacity=experience_buffer_size, persistence_path=replay_path)
|
| 127 |
+
self.optimizer = HeuristicOptimizer(llm=optimizer_llm or llm)
|
| 128 |
+
|
| 129 |
+
# Falsification critic (lazy init)
|
| 130 |
+
self._falsification_critic = None
|
| 131 |
+
if critic_mode == "falsification":
|
| 132 |
+
from purpose_agent.falsification_critic import FalsificationCritic
|
| 133 |
+
self._falsification_critic = FalsificationCritic(llm=critic_llm or llm)
|
| 134 |
+
|
| 135 |
+
# PEP 578 sandbox
|
| 136 |
+
if sandbox:
|
| 137 |
+
from purpose_agent.sandbox_hooks import install_sandbox, SandboxPolicy
|
| 138 |
+
install_sandbox(SandboxPolicy(
|
| 139 |
+
allowed_paths=[persistence_dir or "/tmp", "/tmp"],
|
| 140 |
+
block_network=True,
|
| 141 |
+
block_subprocess=False, # PythonExecTool needs subprocess
|
| 142 |
+
))
|
| 143 |
|
|
|
|
| 144 |
self.sync_memory()
|
| 145 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 146 |
def run_task(
|
| 147 |
self,
|
| 148 |
purpose: str,
|
|
|
|
| 151 |
early_stop_phi: float = 9.0,
|
| 152 |
task_description: str | None = None,
|
| 153 |
) -> TaskResult:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 154 |
task_desc = task_description or purpose
|
| 155 |
current_state = initial_state or self.environment.reset()
|
|
|
|
|
|
|
| 156 |
self.purpose_fn.reset_trajectory_stats()
|
| 157 |
|
|
|
|
| 158 |
relevant_experiences = self.experience_replay.retrieve(task_desc, top_k=3)
|
| 159 |
self._inject_experience_context(relevant_experiences)
|
| 160 |
|
| 161 |
+
trajectory = Trajectory(task_description=task_desc, purpose=purpose)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 162 |
history: list[dict[str, Any]] = []
|
| 163 |
|
| 164 |
+
logger.info(f"βββ Starting task: {task_desc} (max {max_steps} steps, critic={self.critic_mode}) βββ")
|
| 165 |
|
| 166 |
for step_idx in range(max_steps):
|
| 167 |
step_start = time.time()
|
| 168 |
|
| 169 |
+
action = self.actor.decide(purpose=purpose, current_state=current_state, history=history)
|
| 170 |
+
logger.info(f"Step {step_idx + 1}: Action={action.name}, Thought={action.thought[:100]}...")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 171 |
|
|
|
|
| 172 |
if action.name.upper() == "DONE":
|
| 173 |
+
logger.info("Agent signaled DONE")
|
| 174 |
+
final_score = self._evaluate(current_state, action, current_state, purpose)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 175 |
trajectory.steps.append(TrajectoryStep(
|
| 176 |
+
state_before=current_state, action=action, state_after=current_state,
|
| 177 |
+
score=final_score, step_index=step_idx + 1, wall_time_s=time.time() - step_start,
|
|
|
|
|
|
|
|
|
|
|
|
|
| 178 |
))
|
| 179 |
break
|
| 180 |
|
|
|
|
| 181 |
try:
|
| 182 |
new_state = self.environment.execute(action, current_state)
|
| 183 |
except Exception as e:
|
| 184 |
logger.error(f"Environment execution failed: {e}")
|
| 185 |
+
new_state = State(data={**current_state.data, "_error": str(e)}, summary=f"Error: {e}")
|
| 186 |
+
|
| 187 |
+
# ββ FIRST-PRINCIPLES: Evaluate using selected critic mode ββ
|
| 188 |
+
score = self._evaluate(current_state, action, new_state, purpose)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 189 |
|
|
|
|
| 190 |
step = TrajectoryStep(
|
| 191 |
+
state_before=current_state, action=action, state_after=new_state,
|
| 192 |
+
score=score, step_index=step_idx + 1, wall_time_s=time.time() - step_start,
|
|
|
|
|
|
|
|
|
|
|
|
|
| 193 |
)
|
| 194 |
trajectory.steps.append(step)
|
| 195 |
|
|
|
|
| 196 |
history.append({
|
| 197 |
"action": f"{action.name}({json.dumps(action.params, default=str)})",
|
| 198 |
"result": new_state.describe()[:200],
|
| 199 |
"score": f"Ξ={score.delta:+.2f}" if score else "N/A",
|
| 200 |
})
|
| 201 |
|
|
|
|
| 202 |
if self.on_step:
|
| 203 |
self.on_step(step)
|
| 204 |
|
| 205 |
+
logger.info(f" β Ξ¦: {score.phi_before:.1f} β {score.phi_after:.1f} (Ξ={score.delta:+.2f}, conf={score.confidence:.2f})")
|
|
|
|
|
|
|
|
|
|
| 206 |
|
| 207 |
+
current_state = new_state
|
|
|
|
| 208 |
|
| 209 |
if score.phi_after >= early_stop_phi:
|
| 210 |
logger.info(f"Early stop: Ξ¦={score.phi_after:.1f} β₯ {early_stop_phi}")
|
| 211 |
break
|
|
|
|
| 212 |
if self.environment.is_terminal(new_state):
|
| 213 |
logger.info("Environment signaled terminal state")
|
| 214 |
break
|
| 215 |
|
|
|
|
| 216 |
result = TaskResult(trajectory=trajectory, final_state=current_state)
|
| 217 |
self.post_task(trajectory, relevant_experiences)
|
|
|
|
| 218 |
logger.info(f"βββ Task complete βββ\n{result.summary()}")
|
| 219 |
return result
|
| 220 |
|
| 221 |
+
def _evaluate(self, state_before: State, action: Action, state_after: State, purpose: str) -> PurposeScore:
|
| 222 |
+
"""
|
| 223 |
+
Evaluate a state transition using the configured critic mode.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 224 |
|
| 225 |
+
Modes:
|
| 226 |
+
"standard" β original full-state Purpose Function
|
| 227 |
+
"delta" β O(1) Markovian state-delta (default, saves tokens)
|
| 228 |
+
"falsification" β Popperian: generate assertions, execute, score = math
|
| 229 |
"""
|
| 230 |
+
if self.critic_mode == "falsification":
|
| 231 |
+
return self._evaluate_falsification(action, state_after)
|
| 232 |
+
elif self.critic_mode == "delta":
|
| 233 |
+
return self._evaluate_delta(state_before, action, state_after, purpose)
|
| 234 |
+
else:
|
| 235 |
+
# Standard: full state evaluation (original behavior)
|
| 236 |
+
return self.purpose_fn.evaluate(state_before, action, state_after, purpose)
|
| 237 |
+
|
| 238 |
+
def _evaluate_delta(self, state_before: State, action: Action, state_after: State, purpose: str) -> PurposeScore:
|
| 239 |
+
"""O(1) Markovian evaluation β passes only the delta to the critic."""
|
| 240 |
+
from purpose_agent.state_delta import compute_state_delta, format_critic_input
|
| 241 |
+
from purpose_agent.llm_backend import ChatMessage
|
| 242 |
+
from purpose_agent.robust_parser import parse_critic_response
|
| 243 |
+
from purpose_agent.purpose_function import PURPOSE_FUNCTION_SYSTEM_PROMPT
|
| 244 |
+
|
| 245 |
+
delta = compute_state_delta(state_before, state_after)
|
| 246 |
+
|
| 247 |
+
if delta.is_empty:
|
| 248 |
+
return PurposeScore(phi_before=0, phi_after=0, delta=0, reasoning="No state change", evidence="(empty delta)", confidence=0.5)
|
| 249 |
+
|
| 250 |
+
# Format minimal critic input (~300 tokens)
|
| 251 |
+
critic_input = format_critic_input(purpose, action.name, action.thought, delta)
|
| 252 |
+
|
| 253 |
+
# Call critic with just the delta (not full states)
|
| 254 |
+
prompt = f"{critic_input}\n\nScore phi_before and phi_after (0-10). Respond in TOML:\nphi_before = 0.0\nphi_after = 0.0\nreasoning = \"...\"\nevidence = \"...\"\nconfidence = 0.5"
|
| 255 |
+
|
| 256 |
+
try:
|
| 257 |
+
raw = self.purpose_fn.llm.generate(
|
| 258 |
+
[ChatMessage(role="system", content=PURPOSE_FUNCTION_SYSTEM_PROMPT[:500]),
|
| 259 |
+
ChatMessage(role="user", content=prompt)],
|
| 260 |
+
temperature=0.2, max_tokens=500,
|
| 261 |
+
)
|
| 262 |
+
parsed = parse_critic_response(raw)
|
| 263 |
+
except Exception:
|
| 264 |
+
parsed = {"phi_before": 0, "phi_after": 0, "reasoning": "eval failed", "evidence": "", "confidence": 0.3}
|
| 265 |
+
|
| 266 |
+
phi_b = max(0, min(10, float(parsed.get("phi_before", 0))))
|
| 267 |
+
phi_a = max(0, min(10, float(parsed.get("phi_after", 0))))
|
| 268 |
+
return PurposeScore(
|
| 269 |
+
phi_before=phi_b, phi_after=phi_a, delta=phi_a - phi_b,
|
| 270 |
+
reasoning=str(parsed.get("reasoning", "")),
|
| 271 |
+
evidence=str(parsed.get("evidence", delta.summary_diff[:200])),
|
| 272 |
+
confidence=max(0, min(1, float(parsed.get("confidence", 0.5)))),
|
| 273 |
+
)
|
| 274 |
+
|
| 275 |
+
def _evaluate_falsification(self, action: Action, state_after: State) -> PurposeScore:
|
| 276 |
+
"""Popperian evaluation: generate adversarial assertions, execute, score = math."""
|
| 277 |
+
code = action.params.get("code", "")
|
| 278 |
+
if not code:
|
| 279 |
+
from purpose_agent.robust_parser import extract_code
|
| 280 |
+
code = extract_code(action.thought or "") or extract_code(action.expected_delta or "")
|
| 281 |
+
|
| 282 |
+
if not code or "def " not in code:
|
| 283 |
+
return PurposeScore(phi_before=0, phi_after=0, delta=0, reasoning="No code to falsify", evidence="", confidence=0.5)
|
| 284 |
+
|
| 285 |
+
result = self._falsification_critic.evaluate(code)
|
| 286 |
+
return PurposeScore(
|
| 287 |
+
phi_before=0,
|
| 288 |
+
phi_after=result.score,
|
| 289 |
+
delta=result.score,
|
| 290 |
+
reasoning=f"Falsification: {result.assertions_passed}/{result.assertions_total} assertions survived",
|
| 291 |
+
evidence="; ".join(result.failed_details[:3]) if result.failed_details else "All assertions passed",
|
| 292 |
+
confidence=0.95, # High confidence β score is computed, not hallucinated
|
| 293 |
+
)
|
| 294 |
|
| 295 |
+
# ββ Post-task + optimization (unchanged) ββ
|
|
|
|
| 296 |
|
| 297 |
+
def post_task(self, trajectory: Trajectory, used_experiences: list[Any] | None = None) -> None:
|
| 298 |
+
used_experiences = used_experiences or []
|
| 299 |
+
self.experience_replay.add(trajectory)
|
| 300 |
task_success = trajectory.success_rate > 0.5
|
| 301 |
for exp in used_experiences:
|
| 302 |
+
self.experience_replay.update_q_value(exp.id, reward=1.0 if task_success else 0.0)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 303 |
for h in self.actor.strategic_memory + self.actor.procedural_memory:
|
| 304 |
self.optimizer.update_heuristic_usage(h.id, was_successful=task_success)
|
|
|
|
|
|
|
| 305 |
self._tasks_since_optimize += 1
|
| 306 |
if self._tasks_since_optimize >= self.optimize_every_n_tasks:
|
| 307 |
self._run_optimization()
|
| 308 |
self._tasks_since_optimize = 0
|
| 309 |
|
| 310 |
def _run_optimization(self) -> None:
|
|
|
|
| 311 |
logger.info("Running optimization cycle...")
|
| 312 |
+
top = self.experience_replay.get_top_trajectories(n=5, min_success_rate=0.3)
|
| 313 |
+
if not top:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 314 |
logger.info("No qualifying trajectories for optimization")
|
| 315 |
return
|
| 316 |
+
self.optimizer.optimize(top)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 317 |
self.sync_memory()
|
| 318 |
|
| 319 |
def sync_memory(self) -> None:
|
| 320 |
+
self.actor.update_strategic_memory(self.optimizer.get_heuristics_by_tier(MemoryTier.STRATEGIC))
|
| 321 |
+
self.actor.update_procedural_memory(self.optimizer.get_heuristics_by_tier(MemoryTier.PROCEDURAL))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 322 |
tool_heuristics = self.optimizer.get_heuristics_by_tier(MemoryTier.TOOL)
|
| 323 |
tool_tips = {h.pattern: h.strategy for h in tool_heuristics}
|
| 324 |
if tool_tips:
|
| 325 |
self.actor.update_tool_memory(tool_tips)
|
| 326 |
|
| 327 |
def _inject_experience_context(self, experiences: list[Any]) -> None:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 328 |
injected = []
|
| 329 |
for exp in experiences:
|
| 330 |
for h in exp.heuristics:
|
| 331 |
if h.tier == MemoryTier.PROCEDURAL:
|
| 332 |
injected.append(h)
|
|
|
|
| 333 |
if injected:
|
| 334 |
current = self.actor.procedural_memory or []
|
| 335 |
self.actor.procedural_memory = current + injected
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 336 |
|
| 337 |
@property
|
| 338 |
def stats(self) -> dict[str, Any]:
|
|
|
|
| 339 |
return {
|
| 340 |
"experience_replay": self.experience_replay.stats,
|
| 341 |
"heuristic_library_size": len(self.optimizer.heuristic_library),
|
| 342 |
+
"heuristics_by_tier": {t.value: len(self.optimizer.get_heuristics_by_tier(t)) for t in MemoryTier},
|
|
|
|
|
|
|
|
|
|
| 343 |
"tasks_since_optimize": self._tasks_since_optimize,
|
| 344 |
+
"critic_mode": self.critic_mode,
|
| 345 |
}
|
| 346 |
|
| 347 |
def get_heuristic_report(self) -> str:
|
|
|
|
| 348 |
lines = ["βββ Learned Heuristics Report βββ\n"]
|
|
|
|
| 349 |
for tier in MemoryTier:
|
| 350 |
heuristics = self.optimizer.get_heuristics_by_tier(tier)
|
| 351 |
lines.append(f"\n{'β' * 40}")
|
| 352 |
lines.append(f" {tier.value.upper()} ({len(heuristics)} heuristics)")
|
| 353 |
lines.append(f"{'β' * 40}")
|
|
|
|
| 354 |
for h in heuristics:
|
| 355 |
+
lines.append(f"\n [{h.id}] Q={h.q_value:.3f} (used {h.times_used}x)")
|
|
|
|
| 356 |
lines.append(f" Pattern: {h.pattern}")
|
| 357 |
lines.append(f" Strategy: {h.strategy}")
|
|
|
|
|
|
|
|
|
|
|
|
|
| 358 |
return "\n".join(lines)
|