@lawaty/lacode 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ All notable changes to LaCode are recorded here. The format follows
 Versions come from git release commits; the npm version is bumped in the same
 commit as the changelog entry it describes.
 
+## [1.2.0] — voice, a per-session timeline, and a pool without a cap
+
+### Added
+
+- **Voice control for the TUI.** `lacode-voice` runs a local daemon that captures
+  audio, transcribes it through Groq, and forwards prompts to the TUI over a
+  loopback-only control socket. Wake-word detection is optional: the Vosk and
+  Porcupine engines, the recorder and the audio capture path each degrade
+  gracefully when their native dependency, key or device is missing. The daemon,
+  transport and audio code live in `src/voice/`; the TUI is published as the
+  `./tui` export.
+- **A per-session timeline.** `src/plugins/timeline.ts` summarizes a session's
+  transcript into an append-only JSONL file under
+  `~/.local/share/opencode/lacode/timeline/`, and `/reprocess-timeline` rebuilds
+  it from the full transcript through the `timeline_reprocess` tool. Internal
+  summarizer sessions stay out of notifications.
+- **`npm run score`** probes every cost-zero model the configured providers
+  serve, scores context, output, speed and reliability, and suggests a pool
+  order. Results are written to `~/.config/lacode/model-scores.json`.
+
+### Changed
+
+- **BREAKING: Slot routing is one pass, and the four-slot cap is gone.** A
+  slot's `weight` is now its cap, not half of a two-pass budget: the pool fills
+  each slot to its weight in declaration order in one pass, then overflows to the
+  least-loaded slot. Every line is a slot, and a model may repeat — each line
+  adds seats at its position. A preset tuned for the old two-pass behaviour sees
+  roughly half the concurrency it did before; to restore it, double the weights
+  or list a model again.
+- **The pool hot-reloads a bucket-only edit.** Changing only a slot's `b:` bucket
+  now counts as a change and re-validates the table.
+- **A stated `Retry-After` is honoured up to six hours**, instead of being
+  clamped to the fifteen-minute backoff cap.
+
+### Fixed
+
+- **A voice daemon shutdown waits for the transcription in flight**, and manual
+  recording is bounded at two minutes instead of growing without limit.
+- **The voice control socket stays on loopback** unless a non-local bind is
+  explicitly opted into, and the wake engine treats an empty environment value
+  as unset.
+- **The timeline strips terminal control sequences** before rendering model
+  output, and shares its session state across a double-loaded plugin.
+
 ## [1.1.0] — a map contract, feedback, and host credential sync
 
 ### Added
@@ -875,7 +919,9 @@ experimental; `latest` remains 0.4.2.
 
 - First published release: pooled subagents over a shared set of models.
 
-[Unreleased]: https://github.com/lawaty/lacode/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/lawaty/lacode/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/lawaty/lacode/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/lawaty/lacode/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/lawaty/lacode/compare/v0.11.0...v1.0.0
 [0.11.0]: https://github.com/lawaty/lacode/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/lawaty/lacode/compare/v0.9.0...v0.10.0

package/README.md

@@ -145,7 +145,7 @@ option is optional:
 | Option | Default | Meaning |
 | --- | --- | --- |
 | `enabled` | `true` | The single off switch. `false` injects nothing at all and does no writes. |
-| `models` | — | An inline slot list. Highest-priority source. |
+| `models` | — | An inline slot list; `weight` is that line's budget and cap, a model may repeat, and there is no slot cap. Highest-priority source. |
 | `modelsFile` | — | An explicit slot file; short-circuits the [resolution chain](docs/CONFIGURATION.md#pool-preset-resolution). |
 | `reapMs` | `30000` | Hang-reaper interval. |
 | `probeMs` | `900000` | How often benched models are checked by actually using them. `0` turns the periodic check off and leaves the `pool_recheck` tool as the only way to ask. |
@@ -213,11 +213,17 @@ When it reports `stale`, rebuild with `npm run build`. No network is touched;
 ## What you get
 
 Three pooled agents: `explore`, `implement` and `context`. You spawn the base
-name and the pool picks a cheap model slot for it. Behind each base sits up to
-four hidden variants — one per slot — and a spawn of the bare name is the only
-thing that works: a hand-named variant such as `explore-1` is coerced to its
-base and routed by the pool, so naming one cannot pin a provider or skip
-ordered slot filling.
+name and the pool picks a cheap model slot for it. Behind each base sits one
+hidden variant per slot — however many the pool declares — and a spawn of the
+bare name is the only thing that works: a hand-named variant such as `explore-1`
+is coerced to its base and routed by the pool, so naming one cannot pin a
+provider or skip ordered slot filling.
+
+A slot's `weight` is both its concurrency budget and its cap: the pool fills
+slots in declaration order in one pass, then overflows to the least-loaded slot.
+There is no slot cap, and a model may appear on more than one line — each line
+is a separate slot with its own weight — so to give a model more capacity, list
+it again.
 
 A model that rate-limits or runs out of quota is benched until its window ends,
 so one sick provider does not take the pool with it.
@@ -235,9 +241,9 @@ serve at all is benched for the quota cap and named in the report.
 A change is reported as a toast and a log line; a pass that finds nothing changed says
 nothing at all.
 
-Nine commands: `/context-init`, `/context-update`, `/context-review`,
-`/lacode-doctor`, `/agent-instructions`, `/pool`, `/pool-recheck`, `/image-in-cb`
-and `/image`. Everything is added **only when your config does not already
+Ten commands: `/context-init`, `/context-update`, `/context-review`,
+`/lacode-doctor`, `/agent-instructions`, `/pool`, `/pool-recheck`,
+`/reprocess-timeline`, `/image-in-cb` and `/image`. Everything is added **only when your config does not already
 define it** — an agent or command you wrote yourself is left byte-identical,
 never patched or partially merged. `{"enabled": false}` turns the whole thing off
 without leaving a trace. The exact injection list, and the five keys that are
@@ -391,6 +397,12 @@ to emit a number they cannot derive — an unpriced model reports `unknown`, nev
 `0`. How the two modes differ is in [docs/BENCHMARKS.md](docs/BENCHMARKS.md),
 which explains the harness and deliberately contains no results.
 
+`npm run score` is the other measurement: it probes each configured provider's
+free models with one tiny request and ranks them by measured latency, context and
+output limit. It prints a suggested `pool.txt` but never edits it, and writes the
+raw rows to `~/.config/lacode/model-scores.json`. Run it every few days — free
+models and quota windows move.
+
 ## Remote hosts
 
 Notifications raised on a remote host need a way back to your desktop. The
@@ -445,6 +457,7 @@ want it.
 npm run build          # esbuild -> dist/ (what the tarball ships)
 npm test               # node --test tests/ — offline, no network, no running server
 npm run benchmark      # the cost harness; see docs/BENCHMARKS.md
+npm run score          # rank free models by context, output and measured latency
 ```
 
 Node ≥ 22.18.

package/dist/agents.js

@@ -33,7 +33,6 @@ var STUCK_IDLE_MS = 3 * 60 * 1e3;
 var MAX_CLAIM_AGE_MS = 30 * 60 * 1e3;
 var HANG_COOLDOWN_MS = 10 * 60 * 1e3;
 var UNAVAILABLE_COOLDOWN_MS = 60 * 1e3;
-var MAX_SLOTS = 4;
 var COOLDOWN_BASE_MS = 60 * 1e3;
 var COOLDOWN_MAX_MS = 15 * 60 * 1e3;
 var QUOTA_COOLDOWN_BASE_MS = 15 * 60 * 1e3;
@@ -44,6 +43,12 @@ var DEFAULT_PRESET = join2(PRESETS_DIR, "free-tier.json");
 var USER_CONFIG_DIR = join2(homedir(), ".config", "lacode");
 var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
+var FALLBACK_SLOTS = [
+  { index: 1, model: "opencode/big-pickle", weight: 3 },
+  { index: 2, model: "opencode-go/beam-free", weight: 2 },
+  { index: 3, model: "opencode/deepseek-v4.1-flash-free", weight: 1 },
+  { index: 4, model: "opencode/glm-5.3-flash-free", weight: 1 }
+];
 var STATE_SWEEP_INTERVAL_MS = 60 * 60 * 1e3;
 var CHILD_MEMORY_MS = 30 * 6e4;
 
@@ -977,12 +982,12 @@ Report briefly what you changed and where. Do not edit any other file.`,
     }
   }
 };
-function buildAgentSet() {
+function buildAgentSet(slotCount = FALLBACK_SLOTS.length) {
   const set = { ...AGENTS };
   for (const base of POOLED_BASES) {
     const def = AGENTS[base];
     if (!def) continue;
-    for (let slot = 1; slot <= MAX_SLOTS; slot++) {
+    for (let slot = 1; slot <= Math.max(1, slotCount); slot++) {
       const variant = {
         ...def,
         description: `Hidden pool slot ${slot} for ${base}. Its model is NOT set here -- LaCode injects it from the resolved pool preset at config time, so the preset is the only place a pool model is written down. Spawn '${base}' and let the pool route.`,

package/dist/commands.js

@@ -38,7 +38,6 @@ var MAX_CLAIM_AGE_MS = 30 * 60 * 1e3;
 var HANG_COOLDOWN_MS = 10 * 60 * 1e3;
 var UNAVAILABLE_COOLDOWN_MS = 60 * 1e3;
 var MAX_WEIGHT = 100;
-var MAX_SLOTS = 4;
 var COOLDOWN_BASE_MS = 60 * 1e3;
 var COOLDOWN_MAX_MS = 15 * 60 * 1e3;
 var QUOTA_COOLDOWN_BASE_MS = 15 * 60 * 1e3;
@@ -158,7 +157,7 @@ Follow the rules for the file in your system prompt, then report what you change
 Print one PASS/FAIL line per check below, with the exact fix for any FAIL.
 
 1. Pool status \u2014 call the \`pool_status\` tool. Report the slot list, each
-   slot's load against its ceiling (twice the slot's weight), and which models
+   slot's load against its budget (its weight), and which models
    are cooling.
 
 2. OmniRoute configured \u2014 inspect the \`@lawaty/lacode\` plugin options in the
@@ -195,10 +194,10 @@ The pool is ONE global slot table shared by every pooled base (explore, implemen
 
 2. Resolve the instruction above into a target slot table. These are the rules the loader enforces \u2014 never write a file that breaks one:
    - one slot per line: \`<provider>/<model-id>  [weight]\`
-   - at most ${MAX_SLOTS} slots, and a model may appear only once
-   - weight is optional (default 1) and must be a number in (0, ${MAX_WEIGHT}]. It is the slot's active-session budget for one pass \u2014 how many turns it takes per cycle \u2014 and its concurrency ceiling is twice that. NOT a priority; pick order follows line order.
+   - any number of slots; a model may appear on more than one line, and each line is its own slot with its own budget
+   - weight is optional (default 1) and must be a number in (0, ${MAX_WEIGHT}]. It is the slot's active-session budget \u2014 how many concurrent sessions it may hold. The pool's total capacity is the sum of the weights. NOT a priority; pick order follows line order.
    - \`#\` starts a comment (whole-line or trailing); blank lines are ignored.
-   If the instruction names a model ambiguously, or would need more than ${MAX_SLOTS} slots, stop and ask rather than guessing.
+   If the instruction names a model ambiguously, stop and ask rather than guessing.
 
 3. Write the WHOLE file, not a patch. This file is an override, not an edit target: any slot you drop disappears, and slot numbers are line positions, so a partial write silently renumbers slots. Keep the existing comment header. If the write fails on a missing directory, create \`~/.config/lacode\` first and retry.
 
@@ -224,6 +223,11 @@ $ARGUMENTS
 
 Report the tool's output as it came back, then add one short line naming what changed: re-admitted, still limited, or benched because the provider does not serve the model. If a model was benched as \`model-missing\`, say so and name the replacement in \`~/.config/lacode/pool.txt\` \u2014 but change nothing yourself.`
   },
+  "reprocess-timeline": {
+    description: "Rebuild this session's timeline from its full transcript",
+    agent: "implement",
+    template: "Call the `timeline_reprocess` tool exactly once with no arguments. Then reply with only its output."
+  },
   "image-in-cb": {
     description: "Attach the clipboard image to this message \u2014 macOS needs pngpaste, Linux needs wl-paste or xclip.",
     template: "$ARGUMENTS"