@lawaty/lacode 0.0.0-stage → 0.1.1

package/presets/free-tier.json

@@ -0,0 +1,60 @@
+{
+  "$comment": [
+    "THE BUNDLED DEFAULT, not the only source. See presets/README.md for the resolution chain:",
+    "plugin options -> ~/.config/lacode/pool.json -> this file -> a built-in fallback.",
+    "",
+    "src/lib/pool.ts reads it at config time and rewrites every pooled variant agent",
+    "(explore-fast-N, implement-fast-N, context-manager-N) plus the provider whitelists",
+    "to match, so no model is written down next to an agent anywhere.",
+    "Slot N is the same model for every base agent, which is what makes load shared.",
+    "",
+    "RULES, all validated at startup: models are written provider/model-id, split on the FIRST",
+    "slash only so openrouter's vendor-prefixed ids (nvidia/x:free) resolve; must be distinct.",
+    "AT MOST 4 SLOTS: one hidden variant per base per slot is declared, so a fifth entry would",
+    "route at an agent that does not exist. Extra entries are dropped with a warning.",
+    "",
+    "WEIGHT IS THE ONLY KNOWN KNOB, and it is a SOFT CEILING on how many concurrent claims a",
+    "slot holds -- not a share of the work. Priority is that same number, so the rule is:",
+    "  1. the HIGHEST-weight slot that is still under its ceiling takes the spawn",
+    "  2. slot 1 therefore fills to its number before slot 2 sees any work at all",
+    "  3. once EVERY slot is at its ceiling, the overflow goes to the least loaded slot,",
+    "     so a burst past the summed ceilings degrades to even spreading and never blocks",
+    "",
+    "With this file: longcat (opencode-go) takes 3 sessions to itself, then space-bunny",
+    "takes 2, then big-pickle and longcat (Zen) take 1 each -- sequence 1,1,1,2,2,3,4,...",
+    "Equal weights give a plain round robin in list order. 2,2,1,1 reproduces the old",
+    "primary/overflow cycle exactly, which is why the old tier values still work.",
+    "",
+    "Absent means weight 1. Must be a number in (0, 100]; anything else warns and uses 1.",
+    "List order is the tie-break between slots of equal weight, so put the ones you want",
+    "first and treat the bottom of the list as the reserve.",
+    "",
+    "COST IS THE DEFAULT, NOT A CONSTRAINT. These four slots are free because that is what",
+    "the pool is FOR: mechanical work -- reading files, grepping, mechanical edits, cartography.",
+    "They are not here to be the smartest model in the system. The point of putting that work",
+    "on a near-free model is that the mechanical tokens stop being spent by your expensive",
+    "main model, and that the main model's context is never filled with file contents it does",
+    "not need to reason about. Those are two separate effects and the second is the larger one.",
+    "",
+    "The pool is OPEN: it accepts any model you give it, free, cheap or expensive, and the",
+    "plugin never inspects, prices, warns about, filters or rewrites one. There is no",
+    "allowlist, no cost check, and no validation beyond structure (US-7). Free is expressed",
+    "once, right here, as the choice this file makes for you when you have not made one.",
+    "",
+    "You MAY substitute your own list, including paid models, and nothing will reject or",
+    "second-guess it: edit the \"slots\" array below (replace a {\"model\": ...} entry with your",
+    "own provider/id and keep the weight), or leave this file alone entirely and put the list",
+    "in ~/.config/lacode/pool.json instead, which wins over it.",
+    "",
+    "Re-check any model you substitute against models.dev; this project does not look prices",
+    "up at runtime and will not guess at them for you.",
+    "",
+    "Changing this file requires restarting every opencode process: plugins are not hot-reloaded."
+  ],
+  "slots": [
+    { "model": "opencode-go/longcat-2.5-preview-free", "weight": 3 },
+    { "model": "opencode/space-bunny-free", "weight": 2 },
+    { "model": "opencode/big-pickle", "weight": 1 },
+    { "model": "opencode/longcat-2.5-preview-free", "weight": 1 }
+  ]
+}