Mid-generation reasoning intervention probe for closed-source reasoning models.Patch a chain-of-thought step, then observe what the model does next.
BDP Exocodex Cultivation Orbital / BDP-insight L2 is the public research and prototype release space for the BDP / Meta-13 line of runtime debugging, intervention-aware MRI, and LLM behavior analysis tools.
This repository currently publishes the first public BDP-insight prototype:
BDP-insight L2 HodgeConverter v0.1.1
BDP-insight L2 HodgeConverter is a controlled output-prefix intervention prototype for LLM runtime debugging experiments.
It is not ordinary prompt rewriting. In the full debugger workflow the original user prompt remains unchanged. A local model begins generation, the debugger observes partial assistant output, a selected target span is sent to the server-bound Hodge kernel, and continuation resumes from the patched prefix.
It is also not hidden-state intervention (Pyvene / TransformerLens / nnsight require model weights). L2 operates on the token surface, so it works with closed-source models reachable only through their generation API.
This release is a prototype-level research and debugging tool.
What's already validated (v0.1.1)
The current release ships with 29 documented experiments preserved verbatim in an 11-sheet workbook:
17-page User Guide PDF · 11-sheet Workbook · QUICK_START · API Hub description · CHANGELOG
Cross-model evidence is consistent with the Token-Surface Conversion Hypothesis (H1) — an observational note (not a theorem) that the L2 intervention surface widens for models that emit more structured intermediate scaffolding (problem analysis → setup → equation → computation → answer). This is what makes reasoning models (o-series, Claude extended thinking, R1-style, QwQ-style) particularly amenable to token-surface intervention.
Full results, including 11 recommended public demo cases and the four Gemma cross-model records (EXP-GEMMA-01..04), are in the workbook under BDP/BDP_L2_HodgeConverter_v0_1_1_Note/.
Additional public notes for the L2 HodgeConverter — including the full English user guide PDF, the 11-sheet experiment workbook, and the Korean reference appendix — are stored under:
The direct endpoint performs the prefix conversion only — it does not invoke a model. To see arithmetic answers re-derive (e.g. 2 + 4 = 6 → 2 + 9 = 11), use the Python debugger workflow described below.
Python package
The public Python package is on PyPI:
https://pypi.org/project/bdp-insight/0.1.1/
Install:
pip install bdp-insight==0.1.1
Hugging Face model examples:
pip install "bdp-insight[hf]==0.1.1"
Optional static Studio dashboard:
pip install "bdp-insight[hf,studio]==0.1.1"
Quick start
After installation:
bdp-insight-smoke
For interactive local model testing:
bdp-insight-chat
Available console commands:
text
1bdp-insight-chat Interactive chat + optional dashboards
2bdp-insight-smoke API Hub / Modal smoke test
3bdp-insight-dashboard Dynamic debugger dashboard
4bdp-insight-static Static Studio dashboard
This project is released under the MIT License. See the LICENSE file for the full text. The same MIT license applies to both the GitHub and Hugging Face mirrors of this repository.