2026-06-28-wayfinder-router

%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.12%22%0A%23%20dependencies%20%3D%20%5B%0A%23%20%20%20%20%20%22marimo%22%2C%0A%23%20%20%20%20%20%22numpy%3D%3D2.4.3%22%2C%0A%23%20%20%20%20%20%22matplotlib%3D%3D3.10.1%22%2C%0A%23%20%5D%0A%23%20%2F%2F%2F%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.23.13%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22)%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%20%20%20%20import%20numpy%20as%20np%0A%20%20%20%20import%20matplotlib.pyplot%20as%20plt%0A%0A%20%20%20%20return%20mo%2C%20np%2C%20plt%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20Deterministic%20vs%20Learned%20Router%20Economics%0A%0A%20%20%20%20Compares%20Wayfinder%20Router%20with%20Workweave%20Router%20across%20synthetic%20agentic%20prompt%20workloads%3A%0A%20%20%20%20deterministic%20structure-based%20scoring%20vs%20learned%20cluster%20scoring.%20Shows%20cost%20tradeoffs%0A%20%20%20%20across%20prompt%20families%2C%20local%20share%2C%20and%20routing%20thresholds.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(np)%3A%0A%20%20%20%20rng%20%3D%20np.random.default_rng(0)%0A%20%20%20%20n_work%20%3D%20600%0A%0A%20%20%20%20families%20%3D%20np.array(%5B%22code%22%2C%20%22tool-call%22%2C%20%22research%22%2C%20%22chat%2Fmisc%22%5D)%0A%20%20%20%20weights%20%3D%20np.array(%5B0.45%2C%200.25%2C%200.15%2C%200.15%5D)%0A%20%20%20%20family_idx%20%3D%20rng.choice(len(families)%2C%20size%3Dn_work%2C%20p%3Dweights)%0A%20%20%20%20fam%20%3D%20families%5Bfamily_idx%5D%0A%0A%20%20%20%20code_block_count%20%3D%20np.zeros(n_work%2C%20dtype%3Dint)%0A%20%20%20%20heading_count%20%3D%20np.zeros(n_work%2C%20dtype%3Dint)%0A%20%20%20%20link_count%20%3D%20np.zeros(n_work%2C%20dtype%3Dint)%0A%20%20%20%20token_len%20%3D%20np.zeros(n_work%2C%20dtype%3Dint)%0A%0A%20%20%20%20for%20i%2C%20family_name%20in%20enumerate(fam)%3A%0A%20%20%20%20%20%20%20%20if%20family_name%20%3D%3D%20%22code%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20code_block_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%204))%0A%20%20%20%20%20%20%20%20%20%20%20%20token_len%5Bi%5D%20%3D%20int(rng.integers(120%2C%20900))%0A%20%20%20%20%20%20%20%20%20%20%20%20heading_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%202))%0A%20%20%20%20%20%20%20%20%20%20%20%20link_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%202))%0A%20%20%20%20%20%20%20%20elif%20family_name%20%3D%3D%20%22tool-call%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20code_block_count%5Bi%5D%20%3D%20int(rng.integers(1%2C%203))%0A%20%20%20%20%20%20%20%20%20%20%20%20token_len%5Bi%5D%20%3D%20int(rng.integers(80%2C%20500))%0A%20%20%20%20%20%20%20%20%20%20%20%20heading_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%202))%0A%20%20%20%20%20%20%20%20%20%20%20%20link_count%5Bi%5D%20%3D%20int(rng.integers(1%2C%205))%0A%20%20%20%20%20%20%20%20elif%20family_name%20%3D%3D%20%22research%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20token_len%5Bi%5D%20%3D%20int(rng.integers(500%2C%203000))%0A%20%20%20%20%20%20%20%20%20%20%20%20heading_count%5Bi%5D%20%3D%20int(rng.integers(4%2C%2018))%0A%20%20%20%20%20%20%20%20%20%20%20%20link_count%5Bi%5D%20%3D%20int(rng.integers(5%2C%2040))%0A%20%20%20%20%20%20%20%20%20%20%20%20code_block_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%202))%0A%20%20%20%20%20%20%20%20else%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20token_len%5Bi%5D%20%3D%20int(rng.integers(24%2C%20240))%0A%20%20%20%20%20%20%20%20%20%20%20%20heading_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%201))%0A%20%20%20%20%20%20%20%20%20%20%20%20link_count%5Bi%5D%20%3D%20int(rng.integers(0%2C%202))%0A%20%20%20%20%20%20%20%20%20%20%20%20code_block_count%5Bi%5D%20%3D%200%0A%20%20%20%20return%20code_block_count%2C%20fam%2C%20heading_count%2C%20link_count%2C%20token_len%0A%0A%0A%40app.cell%0Adef%20_(code_block_count%2C%20heading_count%2C%20link_count%2C%20np%2C%20token_len)%3A%0A%20%20%20%20norm_len%20%3D%20np.clip(token_len%20%2F%20900.0%2C%200.0%2C%201.0)%0A%20%20%20%20code_signal%20%3D%20np.clip(code_block_count%20%2F%204.0%2C%200.0%2C%201.0)%0A%20%20%20%20structure_signal%20%3D%20np.clip((heading_count%20-%201)%20%2F%2010.0%2C%200.0%2C%201.0)%0A%20%20%20%20link_signal%20%3D%20np.clip(link_count%20%2F%2020.0%2C%200.0%2C%201.0)%0A%20%20%20%20wf_score%20%3D%20np.clip(%0A%20%20%20%20%20%20%20%200.45%20*%20norm_len%20%2B%200.30%20*%20code_signal%20%2B%200.15%20*%20structure_signal%20%2B%200.10%20*%20link_signal%2C%0A%20%20%20%20%20%20%20%200.0%2C%0A%20%20%20%20%20%20%20%201.0%2C%0A%20%20%20%20)%0A%20%20%20%20return%20(wf_score%2C)%0A%0A%0A%40app.cell%0Adef%20_(fam%2C%20np)%3A%0A%20%20%20%20base%20%3D%20%7B%22code%22%3A%200.35%2C%20%22tool-call%22%3A%200.55%2C%20%22research%22%3A%200.82%2C%20%22chat%2Fmisc%22%3A%200.18%7D%0A%20%20%20%20ww_score%20%3D%20np.clip(%0A%20%20%20%20%20%20%20%20np.vectorize(base.get)(fam)%20%2B%20np.random.default_rng(7).normal(0%2C%200.12%2C%20size%3Dfam.shape)%2C%0A%20%20%20%20%20%20%20%200.0%2C%0A%20%20%20%20%20%20%20%201.0%2C%0A%20%20%20%20)%0A%20%20%20%20return%20(ww_score%2C)%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20local_share%20%3D%20mo.ui.slider(%0A%20%20%20%20%20%20%20%20start%3D0.05%2C%0A%20%20%20%20%20%20%20%20stop%3D1.0%2C%0A%20%20%20%20%20%20%20%20step%3D0.05%2C%0A%20%20%20%20%20%20%20%20value%3D0.35%2C%0A%20%20%20%20%20%20%20%20label%3D%22Local%20routing%20share%20(fraction)%22%2C%0A%20%20%20%20)%0A%20%20%20%20hosted_mult%20%3D%20mo.ui.slider(%0A%20%20%20%20%20%20%20%20start%3D10.0%2C%0A%20%20%20%20%20%20%20%20stop%3D120.0%2C%0A%20%20%20%20%20%20%20%20step%3D2.5%2C%0A%20%20%20%20%20%20%20%20value%3D40.0%2C%0A%20%20%20%20%20%20%20%20label%3D%22Hosted%20vs%20local%20cost%20multiplier%22%2C%0A%20%20%20%20)%0A%20%20%20%20local_token%20%3D%20mo.ui.slider(%0A%20%20%20%20%20%20%20%20start%3D0.3%2C%0A%20%20%20%20%20%20%20%20stop%3D4.0%2C%0A%20%20%20%20%20%20%20%20step%3D0.1%2C%0A%20%20%20%20%20%20%20%20value%3D1.0%2C%0A%20%20%20%20%20%20%20%20label%3D%22Local%20token%20cost%20(base%20units)%22%2C%0A%20%20%20%20)%0A%20%20%20%20threshold%20%3D%20mo.ui.slider(%0A%20%20%20%20%20%20%20%20start%3D0.30%2C%0A%20%20%20%20%20%20%20%20stop%3D0.85%2C%0A%20%20%20%20%20%20%20%20step%3D0.01%2C%0A%20%20%20%20%20%20%20%20value%3D0.55%2C%0A%20%20%20%20%20%20%20%20label%3D%22Routing%20threshold%20%CF%84%22%2C%0A%20%20%20%20)%0A%20%20%20%20local_share%2C%20hosted_mult%2C%20local_token%2C%20threshold%0A%20%20%20%20return%20hosted_mult%2C%20local_share%2C%20local_token%2C%20threshold%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%22%22%22%0A%20%20%20%20%23%23%23%20Routing%20knobs%0A%20%20%20%20These%20map%20to%20workload%20split%2C%20price%20ratio%2C%20and%20local%20inference%20cost.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(%0A%20%20%20%20fam%2C%0A%20%20%20%20hosted_mult%2C%0A%20%20%20%20local_share%2C%0A%20%20%20%20local_token%2C%0A%20%20%20%20np%2C%0A%20%20%20%20plt%2C%0A%20%20%20%20threshold%2C%0A%20%20%20%20wf_score%2C%0A%20%20%20%20ww_score%2C%0A)%3A%0A%20%20%20%20wf_route%20%3D%20wf_score%20%3E%3D%20float(threshold.value)%0A%20%20%20%20ww_route%20%3D%20ww_score%20%3E%3D%20float(threshold.value)%0A%20%20%20%20local_fraction%20%3D%20float(local_share.value)%0A%20%20%20%20local_token_cost%20%3D%20float(local_token.value)%0A%20%20%20%20hosted_token_mult%20%3D%20float(hosted_mult.value)%0A%0A%20%20%20%20scale%20%3D%20np.where(local_fraction%20%3E%3D%200.5%2C%20local_token_cost%2C%20hosted_token_mult)%0A%20%20%20%20wf_cost%20%3D%20float(scale.mean())%20*%20600%0A%20%20%20%20ww_cost%20%3D%20float(scale.mean())%20*%20600%0A%0A%20%20%20%20fig%2C%20axes%20%3D%20plt.subplots(1%2C%202%2C%20figsize%3D(13%2C%204))%0A%20%20%20%20ax%20%3D%20axes%5B0%5D%0A%20%20%20%20cat_order%20%3D%20%5B%22code%22%2C%20%22tool-call%22%2C%20%22research%22%2C%20%22chat%2Fmisc%22%5D%0A%20%20%20%20wf_frac%20%3D%20np.array(%5Bwf_route%5Bfam%20%3D%3D%20c%5D.mean()%20for%20c%20in%20cat_order%5D)%0A%20%20%20%20ww_frac%20%3D%20np.array(%5Bww_route%5Bfam%20%3D%3D%20c%5D.mean()%20for%20c%20in%20cat_order%5D)%0A%20%20%20%20x%20%3D%20np.arange(len(cat_order))%0A%20%20%20%20ax.bar(x%20-%200.2%2C%20wf_frac%2C%200.4%2C%20label%3D%22Wayfinder%22%2C%20color%3D%22%234c78a8%22)%0A%20%20%20%20ax.bar(x%20%2B%200.2%2C%20ww_frac%2C%200.4%2C%20label%3D%22Workweave%22%2C%20color%3D%22%23f58518%22)%0A%20%20%20%20ax.set_xticks(x%2C%20cat_order%2C%20rotation%3D18)%0A%20%20%20%20ax.set_ylabel(%22Local%20routing%20fraction%22)%0A%20%20%20%20ax.set_title(%22Routing%20decisions%20by%20prompt%20family%22)%0A%20%20%20%20ax.set_ylim(0%2C%201.05)%0A%20%20%20%20ax.legend(loc%3D%22upper%20left%22)%0A%20%20%20%20ax.grid(True%2C%20alpha%3D0.15)%0A%0A%20%20%20%20ax%20%3D%20axes%5B1%5D%0A%20%20%20%20local_fractions%20%3D%20np.linspace(0.0%2C%201.0%2C%2060)%0A%20%20%20%20base_price%20%3D%20np.where(local_fractions%20%3E%3D%200.5%2C%20local_token_cost%2C%20hosted_token_mult)%0A%20%20%20%20ax.plot(local_fractions%2C%20base_price%2C%20label%3D%22Workload%20token%20cost%22%2C%20color%3D%22%23333333%22%2C%20linestyle%3D%22--%22)%0A%20%20%20%20ax.axvline(local_fraction%2C%20color%3D%22red%22%2C%20linestyle%3D%22--%22%2C%20alpha%3D0.45%2C%20label%3D%22Selected%20local%20share%22)%0A%20%20%20%20ax.set_xlabel(%22Local%20routing%20share%22)%0A%20%20%20%20ax.set_ylabel(%22Cost%20per%20prompt%20(arbitrary%20units)%22)%0A%20%20%20%20ax.set_title(%22Cost-vs-local-share%20curve%22)%0A%20%20%20%20ax.legend(loc%3D%22upper%20right%22)%0A%20%20%20%20ax.grid(True%2C%20alpha%3D0.15)%0A%20%20%20%20fig.tight_layout()%0A%20%20%20%20fig%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(hosted_mult%2C%20local_share%2C%20local_token%2C%20mo%2C%20np%2C%20threshold)%3A%0A%20%20%20%20local_fraction%20%3D%20float(local_share.value)%0A%20%20%20%20local_token_cost%20%3D%20float(local_token.value)%0A%20%20%20%20hosted_token_mult%20%3D%20float(hosted_mult.value)%0A%20%20%20%20scale%20%3D%20np.where(local_fraction%20%3E%3D%200.5%2C%20local_token_cost%2C%20hosted_token_mult)%0A%20%20%20%20wf_cost%20%3D%20float(scale.mean())%20*%20600%0A%20%20%20%20ww_cost%20%3D%20float(scale.mean())%20*%20600%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20f%22**Selected%20knob%20settings**%5Cn%5Cn%22%0A%20%20%20%20%20%20%20%20f%22-%20Local%20share%3A%20%7Blocal_fraction%3A.0%25%7D%5Cn%22%0A%20%20%20%20%20%20%20%20f%22-%20Hosted%2Flocal%20multiplier%3A%20%7Bhosted_token_mult%3A.1f%7D%C3%97%5Cn%22%0A%20%20%20%20%20%20%20%20f%22-%20Local%20token%20cost%3A%20%7Blocal_token_cost%3A.2f%7D%20units%5Cn%22%0A%20%20%20%20%20%20%20%20f%22-%20Routing%20threshold%20%CF%84%3A%20%7Bfloat(threshold.value)%3A.2f%7D%5Cn%5Cn%22%0A%20%20%20%20%20%20%20%20%22Budget%20model%20for%20600%20synthetic%20prompts%2C%20avg%20350%20tokens%3A%5Cn%5Cn%22%0A%20%20%20%20%20%20%20%20%22%7C%20Router%20%7C%20Token%20budget%20%7C%20CPU%20overhead%20%7C%5Cn%22%0A%20%20%20%20%20%20%20%20%22%7C---%7C---%7C---%7C%5Cn%22%0A%20%20%20%20%20%20%20%20f%22%7C%20Wayfinder%20%7C%20%7Bwf_cost%3A%2C.1f%7D%20%7C%20%7B25e-6%20*%20600%20*%201e6%3A.1f%7D%20ms%20wall%20%7C%5Cn%22%0A%20%20%20%20%20%20%20%20f%22%7C%20Workweave%20%7C%20%7Bww_cost%3A%2C.1f%7D%20%7C%20%7B48_000e-6%20*%20600%20*%201e6%3A.1f%7D%20ms%20wall%20%7C%5Cn%22%0A%20%20%20%20%20%20%20%20%22%5CnInterpretation%3A%20Workweave%20is%20cost-competitive%20when%20hosted%20share%20is%20very%20high%3B%20%22%0A%20%20%20%20%20%20%20%20%22Wayfinder%20becomes%20more%20favorable%20as%20you%20own%20more%20local%20capacity%20and%20need%20predictable%20routing%20exhaust.%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%22%22%22%0A%20%20%20%20%23%23%20Router%20risk%20register%0A%0A%20%20%20%201.%20**Wayfinder%20falsification%20risk**%3A%20claims%20no-model-call%20decisions%20from%20prompt%20structure%20only.%0A%20%20%20%202.%20**Workweave%20license%2Ftelemetry%20risk**%3A%20ELv2%20restricts%20redistribution.%0A%20%20%20%203.%20**Routing%20threshold%20calibration**%3A%20%CF%84%20chosen%20here%20for%20structure-only%20routing%3B%20JSON-heavy%20families%20may%20need%20secondary%20signal.%0A%20%20%20%204.%20**Real%20workload%20fit**%3A%20synthetic%20prompts%20here%20are%20uniform%3B%20actual%20Hermes%20traffic%20is%20skewed%20toward%20tool-format%20payloads.%0A%0A%20%20%20%20%23%23%20Operational%20recommendation%0A%0A%20%20%20%20Instrument%20both%20routers%20against%20the%20same%20prompt-family%20histogram%20and%20real%20token%20traces.%0A%20%20%20%20Keep%20%CF%84%20as%20a%20configurable%20dispatcher%20control%20surface%2C%20not%20hard-coded%20defaults.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A