1"""Trial planner and executor for single-handoff experiments (Tracks A and B; one process; laptop).23A *condition* is a method + parameters + question-access regime. A *trial* is (condition, model pair, document, question).4Question-blind messages/caches are built once per (condition, document) and reused across that document's questions —5this is the reuse scenario, and the build cost is recorded on every trial as `doc_build_ms` with `reuse_count` = number of6questions that shared it. The runner is resumable: successful trial keys are skipped; failures are kept and retried once.7"""8from __future__ import annotations9import json, time, traceback, yaml, sys, os10from pathlib import Path11import numpy as np12import mlx.core as mx1314from .util import ROOT, read_json, write_json, sha256_json, sha256_text, utc_now, Timer, read_jsonl15from .records import new_record, write_record, trial_key16from .data.prepare import load_doc, load_key17from .scoring import score_synthetic, score_public18from .data.exec_tasks import run_hidden_tests19from .prompts import SYSTEM_RECEIVER, SYSTEM_RECEIVER_NOMSG, receiver_user_text, receiver_question_only20from .backends.mlx_backend import MLXModel, deep_copy_cache, memory_snapshot, reset_peak21from .cache.sparse import quantize_cache, cache_tensor_bytes, to_sparse_all22from .cache.selection import select_cache23from .cache.serialize import build_manifest, serialize_cache, deserialize_cache, codec_compress, codec_decompress24from .methods import text as TM2526FIDELITY = {"C0": "n/a", "C2": "custom", "C3": "custom", "A0": "custom", "A1": "custom", "A2": "custom", "A3": "custom", "A4": "custom", "A5": "custom", "A6": "custom", "A7": "custom",27 "A8": "official", "B0": "custom", "B1": "custom", "B2": "custom", "B2b": "inspired", "B3": "inspired", "B4": "custom",28 "B5": "faithful_reimplementation", "B6": "faithful_reimplementation", "B9": "custom"}2930import platform as _pf31HARDWARE_ID = {"MacBookPro-de-simon-pierre-2.local": "laptop-m5max-48g", "MacStudnpierre2": "m3u96a-m3ultra-96g", "m3u96b": "m3u96b-m3ultra-96g"}.get(_pf.node().split(".")[0] if _pf.node().startswith("MacStud") or _pf.node().startswith("m3u") else _pf.node(), _pf.node())3233def _load_models(cfg):34 mcfg = yaml.safe_load(open(ROOT / "configs/models.yaml"))["models"]35 cache = {}36 def get(alias):37 if alias not in cache:38 cache[alias] = MLXModel(mcfg[alias]["repo"])39 return cache[alias]40 return get, mcfg4142def _select_items(cfg):43 man = read_json(ROOT / "data/manifests/splits.json")44 items = [it for it in man["items"] if it["split"] in cfg["splits"] and it["family"] in cfg["families"]]45 if cfg.get("lengths"):46 items = [it for it in items if it.get("target_tokens") is None or it["target_tokens"] in cfg["lengths"]]47 lim = cfg.get("limit_docs_per_family")48 if lim:49 out = []50 for fam in cfg["families"]:51 out += [it for it in items if it["family"] == fam][:lim]52 items = out53 return items5455def _cond_id(c: dict) -> str:56 parts = [c["method"]]57 for k in sorted(c):58 if k not in ("method", "access", "note", "families", "max_questions"):59 parts.append(f"{k}={c[k]}")60 if "access" in c:61 parts.append(c["access"])62 return "|".join(parts)6364def plan(config_path: str, output: str) -> int:65 cfg = yaml.safe_load(open(config_path))66 items = _select_items(cfg)67 rows = []68 pairs = cfg["model_pairs"]69 for it in items:70 doc = load_doc(it["document_id"], it["family"])71 nq0 = len(doc["questions"]) if not cfg.get("max_questions_per_doc") else min(len(doc["questions"]), cfg["max_questions_per_doc"])72 for pair in pairs:73 for c in cfg["conditions"]:74 if c.get("families") and it["family"] not in c["families"]:75 continue76 nq = min(nq0, c["max_questions"]) if c.get("max_questions") else nq077 for seed in cfg.get("seeds", [0]):78 rows.append({"experiment_id": cfg["experiment_id"], "condition": _cond_id(c), "method": c["method"], "access": c.get("access", "none"),79 "sender": pair["sender"], "receiver": pair["receiver"], "family": it["family"], "document_id": it["document_id"],80 "split": it["split"], "target_tokens": it.get("target_tokens"), "n_questions": nq, "seed": seed, "expected_trials": nq})81 import csv82 Path(output).parent.mkdir(parents=True, exist_ok=True)83 with open(output, "w", newline="") as f:84 w = csv.DictWriter(f, fieldnames=list(rows[0].keys())); w.writeheader(); w.writerows(rows)85 tot = sum(r["expected_trials"] for r in rows)86 print(f"plan: {len(items)} documents, {len(cfg['conditions'])} conditions, {len(pairs)} model pairs -> {len(rows)} doc-conditions, {tot} trials -> {output}")87 return 08889# --------------------------------------------------------------------------------------------------------------------90class DocContext:91 """Per-document receiver state: tokenized prefix and dense cache (built lazily once)."""92 def __init__(self, receiver: MLXModel, doc_text: str, family: str):93 self.receiver = receiver; self.doc_text = doc_text; self.family = family94 self._dense = None; self.build_ms = None; self.prefix_ids = None; self.full_ids_fn = None95 self.msg_cache = {}96 self.sys = SYSTEM_RECEIVER97 def prefix_tokens(self):98 """Receiver prefix = chat tokens up to (and including) the document and the blank line before 'Question:'.99 Computed as the longest common token prefix between the prefix text and a full prompt with a canonical question."""100 if self.prefix_ids is None:101 pre_txt = self.receiver.tokenizer.apply_chat_template([{"role": "system", "content": self.sys}, {"role": "user", "content": "Document:\n" + self.doc_text + "\n\n"}], add_generation_prompt=False, tokenize=False)102 pre = self.receiver.encode(pre_txt)103 full = self.receiver.chat_prompt_tokens([{"role": "system", "content": self.sys}, {"role": "user", "content": receiver_user_text("Document", self.doc_text, "What is stated?", self.family)}])104 n = 0105 while n < min(len(pre), len(full)) and pre[n] == full[n]:106 n += 1107 self.prefix_ids = full[:n]108 return self.prefix_ids109 def split_ids(self, question: str):110 """Full chat tokens for (doc, question); returns (prefix_ids, query_ids) with prefix a true token prefix."""111 full = self.receiver.chat_prompt_tokens([{"role": "system", "content": self.sys}, {"role": "user", "content": receiver_user_text("Document", self.doc_text, question, self.family)}])112 pre = self.prefix_tokens()113 if full[:len(pre)] != pre:114 raise RuntimeError("prefix_boundary: question tokenization altered the document prefix")115 return pre, full[len(pre):]116 def dense_cache(self, prefix_ids):117 if self._dense is None or self._dense_len != len(prefix_ids):118 reset_peak()119 c, t = self.receiver.prefill(prefix_ids)120 self._dense = c; self._dense_len = len(prefix_ids); self.build_ms = t["prefill_ms"]; self.build_peak = int(mx.get_peak_memory())121 return self._dense122123def _score(family: str, pred: str, qkey: dict, key: dict) -> dict:124 if family == "exec":125 r = run_hidden_tests(pred, key["hidden_tests"])126 return {"correct": r["correct"], "pass_rate": r["pass_rate"], "error": r.get("error")}127 if family.startswith("public_"):128 return score_public(pred, [qkey["answer"]] + list(qkey.get("aliases", [])))129 return score_synthetic(pred, qkey)130131def run(config_path: str, resume: bool = False, limit: int | None = None, dry_run: bool = False) -> int:132 cfg = yaml.safe_load(open(config_path))133 res = yaml.safe_load(open(ROOT / "configs/resources.yaml"))134 protocol_hash = cfg.get("protocol_hash") or "unfrozen"135 config_hash = sha256_json(cfg)136 out_path = ROOT / "runs/raw" / f"{cfg['experiment_id']}.jsonl"137 done = set()138 if resume and out_path.exists():139 for r in read_jsonl(out_path):140 if r["status"] == "success":141 done.add(r["trial_id"])142 items = _select_items(cfg)143 get_model, mcfg = _load_models(cfg)144 gen_cfg = cfg.get("generation", {})145 gen_max = gen_cfg.get("max_tokens", 48)146 n_done = n_run = n_fail = 0147 log_path = ROOT / "runs/logs" / f"{cfg['experiment_id']}.log"148 log_path.parent.mkdir(parents=True, exist_ok=True)149 def log(msg):150 line = f"{utc_now()} {msg}"151 print(line, flush=True)152 with open(log_path, "a") as f: f.write(line + "\n")153 log(f"run start experiment={cfg['experiment_id']} config_hash={config_hash[:12]} protocol={protocol_hash[:12]} items={len(items)} resume={resume} already_done={len(done)}")154 if dry_run:155 return plan(config_path, str(ROOT / "protocol" / f"{cfg['experiment_id']}_dryrun.csv"))156 t_start = time.time()157 for it in items:158 fam = it["family"]; doc = load_doc(it["document_id"], fam); key = load_key(it["document_id"], fam)159 qs = doc["questions"][: cfg.get("max_questions_per_doc") or None]160 gen_max = gen_cfg.get("per_family", {}).get(fam, gen_cfg.get("max_tokens", 48))161 qkeys = {q["question_id"]: q for q in key["questions"]}162 for pair in cfg["model_pairs"]:163 receiver = get_model(pair["receiver"]); sender = get_model(pair["sender"])164 dc = DocContext(receiver, doc["text"], fam)165 for cond in cfg["conditions"]:166 if cond.get("families") and fam not in cond["families"]:167 continue168 cid = _cond_id(cond); method = cond["method"]; access = cond.get("access", "none")169 if method.startswith("B") or method.startswith("C"):170 access = cond.get("access", "blind")171 for seed in cfg.get("seeds", [0]):172 # trials for this (doc, cond, pair, seed)173 pending = []174 for q in qs[: cond.get("max_questions") or None]:175 tk = trial_key(cfg.get("trial_key_experiment_id", cfg["experiment_id"]), it["document_id"], q["question_id"], method, {k: v for k, v in cond.items() if k not in ("method", "families", "max_questions")},176 pair["sender"], pair["receiver"], access, protocol_hash, seed)177 if tk in done:178 n_done += 1; continue179 pending.append((q, tk))180 if not pending:181 continue182 if limit is not None and n_run >= limit:183 log(f"limit {limit} reached"); return 0184 # ---- build the question-blind message / cache once per document (reuse scenario)185 shared = None; shared_err = None186 if access in ("blind", "none"):187 try:188 shared = _build_message(method, cond, doc["text"], None, sender, receiver, dc, seed)189 except Exception as e:190 shared_err = e191 log(f"BUILD FAIL {cid} {it['document_id']}: {type(e).__name__}: {str(e)[:200]}")192 for q, tk in pending:193 rec = _run_one(cfg, cond, cid, method, access, pair, it, doc, q, qkeys.get(q["question_id"]), key, sender, receiver, dc, seed, tk, shared, shared_err, gen_max, protocol_hash, config_hash, len(pending))194 write_record(rec, out_path)195 n_run += 1196 if rec["status"] != "success": n_fail += 1197 sc = rec["task_scores"] or {}198 log(f"{cid:>40s} {it['document_id']:>28s} {q['question_id']:>14s} {rec['status']:>10s} corr={sc.get('correct', sc.get('f1'))} bytes={rec['serialized_payload_bytes']} ms={rec['total_wall_ms'] and round(rec['total_wall_ms'])} ans={json.dumps((rec['prediction_artifact'] or '')[:60])}")199 if limit is not None and n_run >= limit:200 log(f"limit {limit} reached"); return 0201 mx.clear_cache()202 log(f"run end: ran={n_run} skipped_done={n_done} failed={n_fail} elapsed_s={round(time.time()-t_start)}")203 return 0204205def _build_message(method, cond, doc_text, question, sender, receiver, dc: DocContext, seed):206 """Returns dict with message (Track A) or cache payload info (Track B); encode timings included."""207 t = Timer(); t.start("encode")208 out = {"method": method}209 if method == "A0":210 out["msg"] = TM.a0_no_message()211 elif method == "A1":212 out["msg"] = TM.a1_full(doc_text)213 elif method == "A2":214 out["msg"] = TM.a2_truncate(doc_text, cond["budget_tokens"], receiver.tokenizer)215 elif method == "A3":216 out["msg"] = TM.a3_extractive(doc_text, cond["budget_tokens"], receiver.tokenizer, question)217 elif method == "A4":218 out["msg"] = TM.a4_summary(doc_text, cond["budget_tokens"], sender, question)219 elif method == "A5":220 out["msg"] = TM.a5_structured(doc_text, cond["budget_tokens"], sender, question)221 if hasattr(dc, "msg_cache"): dc.msg_cache[("A5", cond["budget_tokens"], question)] = out["msg"]222 elif method == "A6":223 key5 = ("A5", cond["budget_tokens"], question)224 ev = dc.msg_cache.get(key5) if hasattr(dc, "msg_cache") else None225 out["msg"] = TM.a6_references(doc_text, cond["budget_tokens"], sender, question, evidence_msg=ev)226 out["reused_a5"] = ev is not None227 elif method == "A7":228 out["msg"] = TM.a7_codec(doc_text, cond.get("codec", "zstd"))229 elif method == "A8":230 out["msg"] = TM.a8_llmlingua(doc_text, cond["budget_tokens"], receiver.tokenizer, question, device=cond.get("device", "mps"))231 elif method.startswith("C"):232 # Track C: cross-checkpoint transfer. Sender cache built on the receiver's exact prefix token ids (shared tokenizer).233 from .mapper import LinearKVMapper, identity_transfer_negative_control234 pre = dc.prefix_tokens()235 assert sender.info.tokenizer_hash == receiver.info.tokenizer_hash, "C methods need a shared tokenizer"236 t.start("sender_prefill"); s_cache, tp = sender.prefill(pre); t.stop("sender_prefill")237 t.start("compress")238 if method == "C0":239 lm = [int(round(lr * (sender.info.num_layers - 1) / (receiver.info.num_layers - 1))) for lr in range(receiver.info.num_layers)]240 c = identity_transfer_negative_control(s_cache, receiver.info, lm); info = {"negative_control": True}241 else:242 mp = LinearKVMapper.load(ROOT / cond["mapper"], sender.info, receiver.info)243 c = mp.apply(s_cache); info = {"mapper": cond["mapper"]}244 if method == "C3":245 window = dc.split_ids(question)[1] if question is not None else receiver.encode("\n\nSummarize the key facts, identifiers, amounts, dates and statuses of this document.")246 c, sel = select_cache(receiver, c, cond.get("policy", "attention"), cond["keep_frac"], window_token_ids=window, seed=seed, window_keep=cond.get("window_keep", 32)); info.update(sel)247 mx.eval([x for cc in c for x in (cc.keys, cc.values)]); mx.synchronize()248 t.stop("compress")249 t.start("serialize")250 man = build_manifest(receiver.info, pre, c, "doc", method, {k: v for k, v in cond.items() if k != "method"}, {"selection_info": {k: v for k, v in info.items() if k != "layer_budgets"}})251 payload = serialize_cache(c, man)252 t.stop("serialize")253 out.update({"cache": c, "payload": payload, "payload_bytes": len(payload), "raw_payload_bytes": len(payload), "cache_bytes": cache_tensor_bytes(c), "manifest": man,254 "compress_ms": t.spans["compress"], "serialize_ms": t.spans["serialize"], "codec": "none", "select_info": info, "doc_build_ms": tp["prefill_ms"], "doc_build_peak": int(mx.get_peak_memory()),255 "prefix_tokens": len(pre), "dense_bytes": cache_tensor_bytes(s_cache), "sender_prefill_ms": tp["prefill_ms"]})256 del s_cache257 elif method.startswith("B"):258 pre = dc.prefix_tokens()259 dense = dc.dense_cache(pre)260 out["doc_build_ms"] = dc.build_ms; out["doc_build_peak"] = dc.build_peak; out["prefix_tokens"] = len(pre)261 out["dense_bytes"] = cache_tensor_bytes(dense)262 t.start("compress")263 if method == "B0":264 c = to_sparse_all(deep_copy_cache(dense)); info = {}265 elif method == "B1":266 c = to_sparse_all(deep_copy_cache(dense)); info = {"serialize_roundtrip": True}267 elif method == "B2":268 c = quantize_cache(dense, cond["bits"], cond.get("group_size", 64)); info = {"bits": cond["bits"]}269 elif method in ("B3", "B4", "B5", "B6", "B9"):270 policy = {"B3": "sink_recent", "B4": "random", "B5": "attention", "B6": "pyramid", "B9": cond.get("policy", "sink_recent")}[method]271 window = None272 if policy in ("attention", "pyramid"):273 if question is not None:274 window = dc.split_ids(question)[1] # question-aware: the fresh query tokens are the observation window275 else:276 window = receiver.encode("\n\nSummarize the key facts, identifiers, amounts, dates and statuses of this document.") # question-blind generic instruction277 c, info = select_cache(receiver, dense, policy, cond["keep_frac"], window_token_ids=window, seed=seed, sinks=cond.get("sinks", 4), window_keep=cond.get("window_keep", 32))278 if method == "B9":279 c = quantize_cache(c, cond["bits"], cond.get("group_size", 64)); info["bits"] = cond["bits"]280 else:281 raise NotImplementedError(method)282 mx.eval([x for cc in c for x in (cc.keys if isinstance(cc.keys, tuple) else (cc.keys,))])283 mx.synchronize()284 t.stop("compress")285 t.start("serialize")286 man = build_manifest(receiver.info, pre, c, "doc", method, {k: v for k, v in cond.items() if k != "method"}, {"selection_info": {k: v for k, v in info.items() if k != "layer_budgets"}})287 payload = serialize_cache(c, man)288 t.stop("serialize")289 codec = cond.get("codec", "none")290 comp, comp_ms = codec_compress(payload, codec) if codec != "none" else (payload, 0.0)291 out.update({"cache": c, "payload": comp, "payload_bytes": len(comp), "raw_payload_bytes": len(payload), "cache_bytes": cache_tensor_bytes(c), "manifest": man,292 "compress_ms": t.spans.get("compress", 0.0), "serialize_ms": t.spans["serialize"] + comp_ms, "codec": codec, "select_info": info})293 else:294 raise NotImplementedError(method)295 t.stop("encode")296 out["encode_ms"] = t.spans["encode"]297 return out298299def _run_one(cfg, cond, cid, method, access, pair, it, doc, q, qkey, key, sender, receiver, dc, seed, tk, shared, shared_err, gen_max, protocol_hash, config_hash, reuse_count):300 fam = it["family"]301 rec = new_record(experiment_id=cfg["experiment_id"], trial_id=tk, run_group_id=cfg["experiment_id"] + ":" + cid, protocol_hash=protocol_hash, config_hash=config_hash,302 task_family=fam, document_id=it["document_id"], document_hash=it["document_hash"], question_id=q["question_id"], split=it["split"], cluster_id=it["cluster_id"],303 sender_model_revision=f"{sender.info.repo_id}@{sender.info.revision}", receiver_model_revision=f"{receiver.info.repo_id}@{receiver.info.revision}",304 tokenizer_hashes={"sender": sender.info.tokenizer_hash, "receiver": receiver.info.tokenizer_hash},305 backend_versions={"mlx": mx.__version__, "mlx_lm": receiver.info.mlx_lm_version}, hardware_id=HARDWARE_ID, device_state={"mlx_active_before": int(mx.get_active_memory())},306 weight_precision="bf16", method_id=method, implementation_fidelity=FIDELITY.get(method, "custom"),307 compression_config={k: v for k, v in cond.items() if k != "method"}, question_access=access, topology="single_handoff", handoff_index=1 if method != "A0" else 0,308 reuse_count=reuse_count if access in ("blind", "none") else 1, cache_hit=(access in ("blind", "none") and method.startswith("B")), cache_compatibility_hash=None,309 random_seed=seed, query_tokens=None, message_tokens=None, message_utf8_bytes=None, cache_tensor_bytes=None, serialized_payload_bytes=None,310 input_usage={}, output_usage={}, provider_cached_usage=None, process_memory=None, backend_memory=None, peak_prefill_memory=None, peak_decode_memory=None,311 mapper_memory=None, cost_with_source=None, prediction_artifact=None, evidence_artifact=None, reference_key_id=f"keys/{fam}/{it['document_id']}.json",312 task_scores=None, status="implementation_error", error_code=None, log_artifact=f"runs/logs/{cfg['experiment_id']}.log", payload_hash=None, output_hash=None)313 rec["source_tokens_sender"] = len(sender.encode(doc["text"])); rec["source_tokens_receiver"] = len(receiver.encode(doc["text"]))314 t_total0 = time.perf_counter()315 try:316 if shared_err is not None:317 raise shared_err318 built = shared if shared is not None else _build_message(method, cond, doc["text"], q["question"], sender, receiver, dc, seed)319 spans = {"encode_ms": built["encode_ms"]}320 reset_peak()321 if method.startswith("A"):322 msg = built["msg"]323 if method == "A6":324 material, rinfo = TM.a6_retrieve(msg, q["question"], cond.get("max_fetch_bytes", 2000), cond.get("max_lookups", 6))325 rec["fetched_bytes"] = rinfo["fetched_bytes"]; rec["evidence_artifact"] = rinfo326 else:327 material = msg.text328 if method == "A0":329 ids = receiver.chat_prompt_tokens([{"role": "system", "content": SYSTEM_RECEIVER_NOMSG}, {"role": "user", "content": receiver_question_only(q["question"], fam)}])330 else:331 ids = receiver.chat_prompt_tokens([{"role": "system", "content": SYSTEM_RECEIVER}, {"role": "user", "content": receiver_user_text(msg.material_label, material, q["question"], fam)}])332 spans["decode_payload_ms"] = msg.decode_ms333 g = receiver.generate_text(ids, max_tokens=gen_max)334 spans.update({"receiver_prefill_ms": g["prefill_ms"], "ttft_ms": g["ttft_ms"], "decode_ms": g["decode_ms"]})335 rec.update({"message_tokens": len(receiver.encode(material)), "message_utf8_bytes": msg.utf8_bytes, "serialized_payload_bytes": msg.payload_bytes,336 "side_information_bytes": msg.side_information_bytes, "query_tokens": len(ids), "input_usage": {"receiver_prompt_tokens": len(ids), **msg.sender_usage},337 "payload_hash": sha256_text(material)})338 if msg.meta: rec["compression_config"] = {**rec["compression_config"], "realized": {k: v for k, v in msg.meta.items() if k not in ("question_aware",)}}339 if method == "A5": rec["evidence_artifact"] = {"n_facts": msg.meta.get("n_facts"), "unresolved_quotes": msg.meta.get("unresolved_quotes"), "parse_ok": msg.meta.get("parse_ok")}340 else:341 pre, query_ids = dc.split_ids(q["question"])342 assert len(pre) == built["prefix_tokens"], "prefix mismatch"343 c = built["cache"]344 spans.update({"doc_prefill_ms": built["doc_build_ms"], "compress_ms": built["compress_ms"], "serialize_ms": built["serialize_ms"]})345 t = Timer(); t.start("load")346 if method == "B1" or cond.get("roundtrip", False):347 raw, dms = codec_decompress(built["payload"], built["codec"]) if built["codec"] != "none" else (built["payload"], 0.0)348 c_use, man = deserialize_cache(raw, receiver.info, built["manifest"]["prefix_token_hash"])349 rec["cache_compatibility_hash"] = man["prefix_token_hash"][:16]350 else:351 c_use = deep_copy_cache(c)352 t.stop("load"); spans["load_ms"] = t.spans["load"]353 g = receiver.generate_from_cache(c_use, query_ids, max_tokens=gen_max)354 spans.update({"receiver_prefill_ms": 0.0, "query_prefill_ms": g["query_prefill_ms"], "ttft_ms": g["ttft_ms"], "decode_ms": g["decode_ms"]})355 rec.update({"message_tokens": built["prefix_tokens"], "message_utf8_bytes": len(doc["text"].encode("utf-8")), "serialized_payload_bytes": built["payload_bytes"],356 "cache_tensor_bytes": built["cache_bytes"], "side_information_bytes": built["payload_bytes"] - built["cache_bytes"] if built["codec"] == "none" else None,357 "query_tokens": len(query_ids), "input_usage": {"receiver_prefix_tokens": built["prefix_tokens"], "dense_cache_bytes": built["dense_bytes"], "query_tokens": len(query_ids)},358 "payload_hash": sha256_text(str(len(built["payload"]))) , "peak_prefill_memory": built["doc_build_peak"]})359 rec["compression_config"] = {**rec["compression_config"], "realized": {k: v for k, v in built["select_info"].items() if k not in ("layer_budgets",)}}360 pred = g["text"]361 rec["prediction_artifact"] = pred; rec["output_hash"] = sha256_text(pred); rec["output_usage"] = {"output_tokens": g["output_tokens"]}362 rec["ttft_ms"] = spans["ttft_ms"]; rec["timing_spans"] = spans363 rec["total_wall_ms"] = (time.perf_counter() - t_total0) * 1000364 rec["peak_decode_memory"] = int(mx.get_peak_memory()); rec["backend_memory"] = memory_snapshot(); rec["process_memory"] = rec["backend_memory"]["process_rss_bytes"]365 if qkey is None:366 rec["status"] = "implementation_error"; rec["error_code"] = "missing_key"367 else:368 rec["task_scores"] = _score(fam, pred, qkey, key)369 rec["status"] = "success" if pred.strip() else "invalid_output"370 except Exception as e:371 rec["status"] = "oom" if "memory" in str(e).lower() else "implementation_error"372 rec["error_code"] = f"{type(e).__name__}: {str(e)[:300]}"373 rec["total_wall_ms"] = (time.perf_counter() - t_total0) * 1000374 traceback.print_exc()375 return rec376