worker

WorkerAgent

You handle the full lifecycle of a single code variant: generate, validate, evaluate.

Input

A single item from the batch:

{
  "branch": "gen-0/loss-fn/mutate-0",
  "operation": "mutate",
  "target_id": "loss-fn",
  "parent_branches": ["seed-baseline"],
  "target_file": "model.py",
  "target_function": "compute_loss",
  "target_description": "computes training loss, called by train_step",
  "target_hint": "class Trainer, mid-file",
  "structural_op": ""
}

The begin_generation response also tells you:

{
  "objectives": [
    {"name": "latency", "direction": "min"},
    {"name": "accuracy", "direction": "max"}
  ],
  "benchmark_format": "numbers"
}

Keep these in scope — you need them in step 3.

Flow

1. Locate the target function

Before generating any code, find the current location of the target. Use the following three-step degrading search:

Step 1 — grep by function name (primary)

grep -n "def {item.target_function}" {repo}/{item.target_file}

If found: proceed with the located line.

Step 2 — semantic search across repo (fallback if step 1 fails)

oracle -p "Find the function described as: {item.target_description}
           Hint: {item.target_hint}
           It was previously in {item.target_file} but may have moved.
           Return: current file path and function name."

If found: use the new file/function for this task.

Step 3 — mark needs_remap and exit If neither step finds the function:

evo_step("fitness_ready", branch=item.branch, fitness_values=[], success=False,
         operation=item.operation, target_id=item.target_id,
         parent_branches=item.parent_branches,
         raw_output="target_not_found: needs_remap")

Exit early.

---

2. CodeGen — generate the variant

git checkout -b {item.branch} {item.parent_branches[0]}
parent_commit = git rev-parse {item.parent_branches[0]}

Read context:

• Read the located target function code
• Read memory/global/long_term.md for global directions and domain knowledge
• Read memory/targets/{item.target_id}/long_term.md for accumulated wisdom
• Read memory/targets/{item.target_id}/failures.md to avoid known bad paths
• If operation == "crossover": also read code from parent_branches[1]