@lawaty/lacode 0.4.2 → 0.6.0

package/CHANGELOG.md

@@ -9,6 +9,54 @@ commit as the changelog entry it describes.
 
 ## [Unreleased]
 
+## [0.6.0] — a client-only /pool command, and README corrections
+
+### Added
+
+- **`/pool <instruction>`** — a client-only command that rewrites this machine's
+  pool override, `~/.config/lacode/pool.txt`, from a short instruction. It
+  applies the loader's rules (at most 4 distinct slots, weight in (0, 100], line
+  order is the rotation), writes the WHOLE file rather than a patch, reports the
+  before → after table, and reminds you that nothing hot-reloads.
+
+### Fixed
+
+- README: the count of agent keys deliberately *not* injected was stated as
+  three, not the five `docs/CONFIGURATION.md` lists; and the `lacode` CLI section
+  was missing `version`, `update`, `receive` and `tunnel setup`.
+  `docs/INSTALL.md`'s CLI list gained `version` and `update`. A stale test title
+  ("three commands") was corrected to match what it asserts.
+
+## [0.5.0] — a user-only /manager-directive, instant limit failover, and the longcat preset
+
+Released on the npm **`beta`** dist-tag (not `latest`) while the project is
+experimental; `latest` remains 0.4.2.
+
+### Added
+
+- **`/manager-directive <text>`** — a client-only command that runs a hidden
+  `manager` agent to apply your instruction to `.opencode/context/manager.md`
+  (record it, move it between sections, rewrite `## Current`, …). The `manager`
+  agent is the only agent permitted to edit that file, its grant is scoped to
+  `manager.md` alone, and no other agent can spawn it — the command is the only
+  route in. The one-writer guard (`writer-rule.ts` Direction 3) now exempts
+  exactly that agent name and still reports every other writer.
+
+### Changed
+
+- **Bundled pool preset** — `opencode-go/step-5-preview-free` and
+  `opencode/step-5-preview-free` were retired upstream. Slots 2 and 4 now name
+  `longcat-2.5-preview-free` on the same providers (`opencode-go`, `opencode`).
+  Update `~/.config/lacode/pool.txt` if you pinned the old ids there.
+
+### Fixed
+
+- **Immediate failover on a usage limit** — when a limit-shaped assistant error or
+  a limit-shaped `session.status` retry names the session an in-flight claim is
+  running on, the pool aborts that session at once instead of leaving it for the
+  ~5-minute hang reaper. The claim is released and the next spawn routes to a slot
+  that answers; a limit on an unrelated session never kills a claim.
+
 ## [0.4.2] — fix silent claim eviction, unkillable chatty tasks, and gateway 5xx misclassification
 
 ### Fixed
@@ -166,7 +214,9 @@ commit as the changelog entry it describes.
 
 - First published release: pooled subagents over a shared set of models.
 
-[Unreleased]: https://github.com/lawaty/lacode/compare/v0.4.1...HEAD
+[Unreleased]: https://github.com/lawaty/lacode/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/lawaty/lacode/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/lawaty/lacode/compare/v0.4.2...v0.5.0
 [0.4.1]: https://github.com/lawaty/lacode/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/lawaty/lacode/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/lawaty/lacode/compare/v0.2.2...v0.3.0

package/README.md

@@ -2,6 +2,11 @@
 
 > Ultimate opencode setup for Go users
 
+> **Beta — experimental, changing fast.** For the next month LaCode ships on the
+> npm **`beta`** dist-tag rather than `latest`, so nothing pulls it by accident:
+> install `@lawaty/lacode@beta`, or pin an exact version. Interfaces here can
+> change between releases without a major bump while the project stabilises.
+
 LaCode is an opencode plugin. It routes delegated work onto a weighted pool of
 cheap models instead of the expensive one, reaps subagents that hang without
 telling anyone, keeps a maintained map of your repository so agents stop
@@ -178,11 +183,12 @@ only thing that works: naming a variant lets the caller choose the provider
 directly, which is exactly what the rotation and the per-slot ceiling exist to
 prevent, so it is refused.
 
-Four commands: `/context-init`, `/context-update`, `/context-review` and
-`/lacode-doctor`. Everything is added **only when your config does not already
+Six commands: `/context-init`, `/context-update`, `/context-review`,
+`/lacode-doctor`, `/manager-directive` and `/pool`. 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 three keys that are
+without leaving a trace. The exact injection list, and the five keys that are
 deliberately *not* injected, are in
 [docs/CONFIGURATION.md](docs/CONFIGURATION.md#what-gets-injected).
 
@@ -212,6 +218,8 @@ are reading:
 /context-update    # incremental refresh; accepts a focus, e.g. /context-update src/payments
 /context-review    # audit it for staleness, contradictions, duplication and bloat
 /lacode-doctor     # check the pool, model resolution and the OmniRoute gateway. Report only
+/manager-directive # record a managerial direction in manager.md — client-only, see below
+/pool              # rewrite the pool slot table in ~/.config/lacode/pool.txt; restart to apply
 ```
 
 The map is local and untracked — it describes your checkout on your machine, so
@@ -251,6 +259,15 @@ agent working in your live session may write it only when you explicitly ask
 it to, and only what you asked for — never on its own initiative, and never
 to "keep it up to date".
 
+**`/manager-directive` — the one sanctioned write path.** Type
+`/manager-directive <text>` and the `manager` agent applies your instruction to
+`manager.md` — recording it, moving it between sections, rewriting `## Current`,
+whatever you asked — then reports what it changed. It is a normal agent turn, not
+a dead append: tell it what you want and review the result. The `manager` agent
+is the one agent permitted to edit that file, its grant is scoped to
+`manager.md` alone, and no other agent can spawn it — the command is the only
+route in.
+
 ## Cost
 
 The mechanism is specific and small: bulk exploration, implementation and
@@ -322,6 +339,13 @@ must never be able to fail the process that tried to notify you. `lacode forward
 HOST -- COMMAND` runs a command on another host over ssh and exits with its
 status.
 
+The full CLI is `notify`, `forward`, `doctor`, `version`, `update`, `receive`
+and `tunnel setup`. `version` reports which copy of LaCode is running — and
+whether opencode is loading that same copy — and `update [--check]` refreshes an
+installed one. `receive` is the desktop end of the tunnel (the forced command a
+remote key is restricted to) and `tunnel setup` provisions the key and the
+forward.
+
 Configuration, the payload format, the receiver contract and holding the forward
 open are in [docs/TUNNEL.md](docs/TUNNEL.md).
 

package/dist/agents.js

@@ -46,6 +46,9 @@ var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
 var CHILD_MEMORY_MS = 30 * 6e4;
 
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
 // src/agents.ts
 var POOLED_BASES = ["explore", "implement", "context"];
 var AGENTS = {
@@ -722,6 +725,68 @@ Finish with a short report:
     }
   }
 };
+var MANAGER_AGENT = {
+  description: "Records and edits the client's .opencode/context/manager.md. Run only by the /manager-directive command; no agent or subagent can spawn it.",
+  mode: "subagent",
+  hidden: true,
+  temperature: 0.1,
+  prompt: `# Role
+
+You maintain one file and nothing else: \`.opencode/context/manager.md\`, the
+client's own statement of intent. You are not a coding agent and you touch no
+other path.
+
+You are run only by the \`/manager-directive\` command. The client tells you what
+they want recorded or changed in the file; you apply that to the file and report
+what you changed. You have no permission to edit anything else, and you need
+none.
+
+# The file
+
+It records what is being worked on (\`## Current\`), what comes next
+(\`## Next\`), what the client has ratified (\`## Confirmed\`), and standing
+direction (\`## Instructions\`). The client may use any headings \u2014 every heading
+is direction, and the four above are a convenience, not a schema.
+
+# How to apply a directive
+
+- Do what the client asked. "Append", "rewrite Current", "move X to Confirmed",
+  "add a heading" all mean exactly that; a bare sentence goes under the most
+  fitting existing heading, and you create one only if none fits.
+- Never invent facts, never record your own inference as the client's, and never
+  tidy, reorder or delete content the client did not ask you to touch.
+- \`## Current\` is rewritten, not appended to, so it does not become a running
+  history.
+- Keep the file concise. If it is growing past roughly 150 lines, say so.
+
+# Reporting
+
+Report briefly what you changed and where. Do not edit any other file.`,
+  permission: {
+    // Read is scoped to the one file too: the directive is about manager.md, and
+    // nothing else is any of this agent's business.
+    read: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    glob: "deny",
+    grep: "deny",
+    list: "deny",
+    edit: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    bash: "deny",
+    webfetch: "deny",
+    websearch: "deny",
+    question: "allow",
+    task: {
+      "*": "deny"
+    }
+  }
+};
 function buildAgentSet() {
   const set = { ...AGENTS };
   for (const base of POOLED_BASES) {
@@ -737,6 +802,7 @@ function buildAgentSet() {
       set[`${base}-${slot}`] = variant;
     }
   }
+  set[MANAGER_AGENT_NAME] = MANAGER_AGENT;
   return set;
 }
 function applyAgents(cfg, agents = buildAgentSet(), opts = {}) {
@@ -756,6 +822,7 @@ function applyAgents(cfg, agents = buildAgentSet(), opts = {}) {
 }
 export {
   AGENTS,
+  MANAGER_AGENT,
   POOLED_BASES,
   applyAgents,
   buildAgentSet

package/dist/commands.js

@@ -1,3 +1,55 @@
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
+// src/lib/pool.ts
+import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join as join2 } from "node:path";
+
+// src/lib/package-root.ts
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+var PACKAGE_NAME = "@lawaty/lacode";
+var findPackageRoot = (start) => {
+  let dir = start;
+  for (let up = 0; up < 6; up++) {
+    try {
+      if (JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).name === PACKAGE_NAME) return dir;
+    } catch {
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return join(start, "..", "..");
+};
+var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
+
+// src/lib/pool.ts
+var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
+var ORPHAN_TMP_MS = 60 * 1e3;
+var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var STUCK_MIN_AGE_MS = 5 * 60 * 1e3;
+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_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;
+var QUOTA_COOLDOWN_MAX_MS = 6 * 60 * 60 * 1e3;
+var STRIKE_DECAY_MS = 30 * 60 * 1e3;
+var PRESETS_DIR = join2(PACKAGE_ROOT, "presets");
+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 CHILD_MEMORY_MS = 30 * 6e4;
+
 // src/commands.ts
 var COMMANDS = {
   "context-init": {
@@ -77,6 +129,16 @@ Audit the five context files for:
 
 Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
 and anything you could not verify.`
+  },
+  "manager-directive": {
+    description: "Apply a client instruction to .opencode/context/manager.md. Client-only \u2014 runs the manager agent, the only writer of that file.",
+    agent: MANAGER_AGENT_NAME,
+    subtask: true,
+    template: `Apply this instruction to \`.opencode/context/manager.md\`, and edit only that file:
+
+$ARGUMENTS
+
+Follow the rules for the file in your system prompt, then report what you changed.`
   },
   "lacode-doctor": {
     description: "Check the LaCode setup \u2014 pool slots, model resolution, and the OmniRoute gateway. Report only; changes nothing.",
@@ -108,6 +170,36 @@ Print one PASS/FAIL line per check below, with the exact fix for any FAIL.
    whether or not the gateway advertises it, so it needs no allowlist entry.
 
 Change nothing. Print a final one-line summary of failures.`
+  },
+  "pool": {
+    description: "Modify this machine's LaCode pool from a short instruction \u2014 the shared free-model slot table in ~/.config/lacode/pool.txt. Restarts opencode afterwards.",
+    template: `Apply this change to the LaCode pool on this machine:
+
+$ARGUMENTS
+
+The pool is ONE global slot table shared by every pooled base (explore, implement, context) \u2014 there are no per-base model lists, so "put X on explore" means "give X a slot", not a per-base override.
+
+1. Establish the baseline. Read \`${USER_MODELS_TXT}\`. If it is absent, the pool is resolving from the bundled preset \`presets/free-tier.json\`; read that file to learn what is in effect. Call the \`pool_status\` tool only if you need live load or cooldown state.
+
+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 soft ceiling on concurrent claims and the slot's share of the rotation \u2014 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.
+
+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 the rotation. Keep the existing comment header. If the write fails on a missing directory, create \`~/.config/lacode\` first and retry.
+
+4. Report the before \u2192 after slot table, the resolved path, and this reminder in substance: nothing hot-reloads, so every running opencode process must be restarted before the new pool takes effect.
+
+Two traps that fail silently, so check and state them explicitly:
+- A slot's provider must already exist in the user's opencode config, or that slot cannot resolve at all. If the instruction adds a model on a provider that is not configured, say so.
+- If a slot model is \`omniroute/<id>\`, that id must also appear in the plugin's \`omniroute.models\` allowlist (or be the \`combo\` id, which needs no entry) \u2014 otherwise the pool resolves and every spawn fails with \`ProviderModelNotFoundError\`.
+- A provider \`whitelist\` is an allowlist, and the plugin appends your model to it at config time. Nothing for you to do there.
+
+If the instruction is to RESET or REVERT rather than to change models, delete \`${USER_MODELS_TXT}\` instead, and report that the pool falls back to the bundled preset \u2014 with the same restart reminder.
+
+Change nothing else. In particular do not touch \`presets/free-tier.json\`, \`~/.config/lacode/pool.json\`, \`FALLBACK_SLOTS\` in \`src/lib/pool.ts\`, or \`tests/models-snapshot.json\`: this command owns the per-machine override and nothing else.`
   }
 };
 function applyCommands(cfg, commands = COMMANDS) {

package/dist/index.js

@@ -49,9 +49,9 @@ 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/space-bunny-free", weight: 3 },
-  { index: 2, model: "opencode-go/step-5-preview-free", weight: 2 },
+  { index: 2, model: "opencode-go/longcat-2.5-preview-free", weight: 2 },
   { index: 3, model: "opencode/big-pickle", weight: 1 },
-  { index: 4, model: "opencode/step-5-preview-free", weight: 1 }
+  { index: 4, model: "opencode/longcat-2.5-preview-free", weight: 1 }
 ];
 function parseSlots(parsed, origin) {
   const problems = [];
@@ -611,6 +611,9 @@ function coolProvider(s, provider, until, reason) {
   return affected;
 }
 
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
 // src/agents.ts
 var POOLED_BASES = ["explore", "implement", "context"];
 var AGENTS = {
@@ -1287,6 +1290,68 @@ Finish with a short report:
     }
   }
 };
+var MANAGER_AGENT = {
+  description: "Records and edits the client's .opencode/context/manager.md. Run only by the /manager-directive command; no agent or subagent can spawn it.",
+  mode: "subagent",
+  hidden: true,
+  temperature: 0.1,
+  prompt: `# Role
+
+You maintain one file and nothing else: \`.opencode/context/manager.md\`, the
+client's own statement of intent. You are not a coding agent and you touch no
+other path.
+
+You are run only by the \`/manager-directive\` command. The client tells you what
+they want recorded or changed in the file; you apply that to the file and report
+what you changed. You have no permission to edit anything else, and you need
+none.
+
+# The file
+
+It records what is being worked on (\`## Current\`), what comes next
+(\`## Next\`), what the client has ratified (\`## Confirmed\`), and standing
+direction (\`## Instructions\`). The client may use any headings \u2014 every heading
+is direction, and the four above are a convenience, not a schema.
+
+# How to apply a directive
+
+- Do what the client asked. "Append", "rewrite Current", "move X to Confirmed",
+  "add a heading" all mean exactly that; a bare sentence goes under the most
+  fitting existing heading, and you create one only if none fits.
+- Never invent facts, never record your own inference as the client's, and never
+  tidy, reorder or delete content the client did not ask you to touch.
+- \`## Current\` is rewritten, not appended to, so it does not become a running
+  history.
+- Keep the file concise. If it is growing past roughly 150 lines, say so.
+
+# Reporting
+
+Report briefly what you changed and where. Do not edit any other file.`,
+  permission: {
+    // Read is scoped to the one file too: the directive is about manager.md, and
+    // nothing else is any of this agent's business.
+    read: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    glob: "deny",
+    grep: "deny",
+    list: "deny",
+    edit: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    bash: "deny",
+    webfetch: "deny",
+    websearch: "deny",
+    question: "allow",
+    task: {
+      "*": "deny"
+    }
+  }
+};
 function buildAgentSet() {
   const set = { ...AGENTS };
   for (const base of POOLED_BASES) {
@@ -1302,6 +1367,7 @@ function buildAgentSet() {
       set[`${base}-${slot}`] = variant;
     }
   }
+  set[MANAGER_AGENT_NAME] = MANAGER_AGENT;
   return set;
 }
 function applyAgents(cfg, agents = buildAgentSet(), opts = {}) {
@@ -1399,6 +1465,16 @@ Audit the five context files for:
 
 Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
 and anything you could not verify.`
+  },
+  "manager-directive": {
+    description: "Apply a client instruction to .opencode/context/manager.md. Client-only \u2014 runs the manager agent, the only writer of that file.",
+    agent: MANAGER_AGENT_NAME,
+    subtask: true,
+    template: `Apply this instruction to \`.opencode/context/manager.md\`, and edit only that file:
+
+$ARGUMENTS
+
+Follow the rules for the file in your system prompt, then report what you changed.`
   },
   "lacode-doctor": {
     description: "Check the LaCode setup \u2014 pool slots, model resolution, and the OmniRoute gateway. Report only; changes nothing.",
@@ -1430,6 +1506,36 @@ Print one PASS/FAIL line per check below, with the exact fix for any FAIL.
    whether or not the gateway advertises it, so it needs no allowlist entry.
 
 Change nothing. Print a final one-line summary of failures.`
+  },
+  "pool": {
+    description: "Modify this machine's LaCode pool from a short instruction \u2014 the shared free-model slot table in ~/.config/lacode/pool.txt. Restarts opencode afterwards.",
+    template: `Apply this change to the LaCode pool on this machine:
+
+$ARGUMENTS
+
+The pool is ONE global slot table shared by every pooled base (explore, implement, context) \u2014 there are no per-base model lists, so "put X on explore" means "give X a slot", not a per-base override.
+
+1. Establish the baseline. Read \`${USER_MODELS_TXT}\`. If it is absent, the pool is resolving from the bundled preset \`presets/free-tier.json\`; read that file to learn what is in effect. Call the \`pool_status\` tool only if you need live load or cooldown state.
+
+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 soft ceiling on concurrent claims and the slot's share of the rotation \u2014 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.
+
+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 the rotation. Keep the existing comment header. If the write fails on a missing directory, create \`~/.config/lacode\` first and retry.
+
+4. Report the before \u2192 after slot table, the resolved path, and this reminder in substance: nothing hot-reloads, so every running opencode process must be restarted before the new pool takes effect.
+
+Two traps that fail silently, so check and state them explicitly:
+- A slot's provider must already exist in the user's opencode config, or that slot cannot resolve at all. If the instruction adds a model on a provider that is not configured, say so.
+- If a slot model is \`omniroute/<id>\`, that id must also appear in the plugin's \`omniroute.models\` allowlist (or be the \`combo\` id, which needs no entry) \u2014 otherwise the pool resolves and every spawn fails with \`ProviderModelNotFoundError\`.
+- A provider \`whitelist\` is an allowlist, and the plugin appends your model to it at config time. Nothing for you to do there.
+
+If the instruction is to RESET or REVERT rather than to change models, delete \`${USER_MODELS_TXT}\` instead, and report that the pool falls back to the bundled preset \u2014 with the same restart reminder.
+
+Change nothing else. In particular do not touch \`presets/free-tier.json\`, \`~/.config/lacode/pool.json\`, \`FALLBACK_SLOTS\` in \`src/lib/pool.ts\`, or \`tests/models-snapshot.json\`: this command owns the per-machine override and nothing else.`
   }
 };
 function applyCommands(cfg, commands = COMMANDS) {
@@ -1527,6 +1633,19 @@ var agentPoolHooks = (async ({ client, serverUrl }, options) => {
     const strike = recordStrike(s, claim.m, "hang", HANG_FALLBACK_MS);
     if (strike) await log2("warn", `cooling ${claim.m} for ${Math.round((strike.until - now) / 1e3)}s (hang)`);
   };
+  const failOver = async (sessionID, model, reason) => {
+    if (!sessionID) return;
+    const entry = [...s.own.entries()].find(([, claim2]) => claim2.g === sessionID);
+    if (!entry) return;
+    const [key, claim] = entry;
+    const kill = await abortSession(sessionID);
+    release(s, key);
+    await log(
+      "warn",
+      kill.ok ? `limit (${reason}) on ${model}; aborted in-flight ${claim.v} session ${sessionID} to fail over now` : `limit (${reason}) on ${model}; released in-flight ${claim.v} claim after a failed abort (${kill.why})`,
+      { base: claim.v, model: claim.m, slot: claim.k, session: sessionID, aborted: kill.ok, reason }
+    );
+  };
   const reapStuck = async () => {
     if (s.reaping) return;
     s.reaping = true;
@@ -1642,18 +1761,21 @@ var agentPoolHooks = (async ({ client, serverUrl }, options) => {
       try {
         const props = event.properties ?? {};
         if (event.type === "session.status") {
+          const sessionID = typeof props.sessionID === "string" ? props.sessionID : void 0;
           const status2 = props.status;
-          if (status2?.type === "retry" && status2.action?.reason === "free_tier_limit" && status2.action.provider) {
+          const reason2 = status2?.action?.reason ?? "";
+          if (status2?.type === "retry" && status2.action?.provider && (reason2 === "free_tier_limit" || isLimitText(reason2))) {
             const provider = status2.action.provider;
             const until = typeof status2.next === "number" && status2.next > Date.now() ? status2.next : Date.now() + HANG_FALLBACK_MS;
-            const cooled = coolProvider(s, provider, until, "free_tier_limit");
+            const cooled = coolProvider(s, provider, until, reason2 || "rate-limited");
             if (cooled.length > 0) {
-              await log("warn", `free tier exhausted on provider ${provider}; cooling ${cooled.length} slot(s) until ${new Date(until).toISOString().slice(11, 19)}Z`, {
+              await log("warn", `limit on provider ${provider} (${reason2 || "rate-limited"}); cooling ${cooled.length} slot(s) until ${new Date(until).toISOString().slice(11, 19)}Z`, {
                 provider,
                 until,
                 models: cooled.map((c) => c.model)
               });
             }
+            await failOver(sessionID, provider, reason2 || "rate-limited");
           }
           return;
         }
@@ -1687,6 +1809,7 @@ var agentPoolHooks = (async ({ client, serverUrl }, options) => {
         const reason = haystack.match(/rate[\s_-]?limit|usage limit|too many requests|quota|freelimiterror|overloaded/i)?.[0]?.toLowerCase().replace(/[\s_]/g, "-");
         const strike = recordStrike(s, model, reason ?? "rate-limited", stated);
         if (strike) await log("warn", `cooling ${model} for ${Math.round((strike.until - Date.now()) / 1e3)}s (${reason ?? "rate-limited"}, strike ${strike.strikes})`);
+        await failOver(info.sessionID, model, reason ?? "rate-limited");
       } catch (error) {
         await log("error", `limit detection failed: ${String(error)}`);
       }
@@ -1858,6 +1981,7 @@ import { readFileSync as readFileSync3 } from "node:fs";
 import * as path from "node:path";
 var CONTEXT_DIR = path.join(".opencode", "context");
 var WRITER = "context";
+var MANAGER_WRITER = MANAGER_AGENT_NAME;
 var toPosix = (value) => value.split(path.sep).join("/");
 var compilePattern = (pattern) => {
   const escaped = toPosix(pattern).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
@@ -1926,11 +2050,12 @@ var verifyWriterRule = (configPath, mapDir, projectRoot) => {
   if (agentDefs) {
     const writers = [];
     for (const [name, def] of Object.entries(agentDefs)) {
+      if (name === MANAGER_WRITER) continue;
       const win = winningRule(permissionOf(def), managerPath);
       if (win?.action === "allow") writers.push(`${name} (edit rule "${win.pattern}": "${win.action}")`);
     }
     if (writers.length > 0) {
-      return `${CONTEXT_DIR}/manager.md is writable by permission: ${writers.join(", ")}. It is the client's own file \u2014 what they are working on, what is ratified, what every agent must respect \u2014 and no agent writes it. Deny it LAST, after any broad allow, because opencode takes the LAST matching rule: "*": "allow", "*/${CONTEXT_DIR}/manager.md": "deny", "${CONTEXT_DIR}/manager.md": "deny". Declare this on every agent above, including \`${WRITER}\`: an agent you define yourself replaces the shipped one wholesale, permission and all.`;
+      return `${CONTEXT_DIR}/manager.md is writable by permission: ${writers.join(", ")}. It is the client's own file \u2014 what they are working on, what is ratified, what every agent must respect \u2014 and only the \`${MANAGER_WRITER}\` agent (run solely by /manager-directive) may write it. Deny it LAST on every other agent, after any broad allow, because opencode takes the LAST matching rule: "*": "allow", "*/${CONTEXT_DIR}/manager.md": "deny", "${CONTEXT_DIR}/manager.md": "deny". Declare this on every agent above, including \`${WRITER}\`: an agent you define yourself replaces the shipped one wholesale, permission and all.`;
     }
   }
   return void 0;

package/dist/pool.js

@@ -49,9 +49,9 @@ 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/space-bunny-free", weight: 3 },
-  { index: 2, model: "opencode-go/step-5-preview-free", weight: 2 },
+  { index: 2, model: "opencode-go/longcat-2.5-preview-free", weight: 2 },
   { index: 3, model: "opencode/big-pickle", weight: 1 },
-  { index: 4, model: "opencode/step-5-preview-free", weight: 1 }
+  { index: 4, model: "opencode/longcat-2.5-preview-free", weight: 1 }
 ];
 function parseSlots(parsed, origin) {
   const problems = [];

package/docs/CONFIGURATION.md

@@ -75,9 +75,11 @@ process.
 
 ## What gets injected
 
-**17 agent keys**: the 5 bases `build`, `plan`, `explore`, `implement`,
+**18 agent keys**: the 5 bases `build`, `plan`, `explore`, `implement`,
 `context`, plus one hidden
-`<base>-1`..`-4` pool variant for each of the 3 pooled bases.
+`<base>-1`..`-4` pool variant for each of the 3 pooled bases, plus the hidden
+`manager` agent — the one writer of `.opencode/context/manager.md`, reachable
+only from the `/manager-directive` command.
 
 `build` and `plan` exist in opencode as built-ins, so on a stock config those
 two keys are already taken and merge-without-clobber keeps the built-in — the

package/docs/INSTALL.md

@@ -182,7 +182,8 @@ or no GNU `timeout` — rather than passing silently or failing confusingly.
 
 ## The `lacode` CLI
 
-The package also ships the `lacode` CLI (`notify`, `forward`, `doctor`, `receive`, `tunnel setup`) — see
+The package also ships the `lacode` CLI (`notify`, `forward`, `doctor`, `version`,
+`update`, `receive`, `tunnel setup`) — see
 [Remote hosts](../README.md#remote-hosts). The plugin install does **not** put it on your
 `PATH`; run it from the package's `node_modules/.bin`, or install just the CLI
 globally with `npm i -g @lawaty/lacode` if you want the bare command. (That

package/docs/OMNIROUTE.md

@@ -102,7 +102,7 @@ your pool like any other model:
 # ~/.config/lacode/pool.txt
 omniroute/auto             3
 opencode/space-bunny-free  2
-opencode-go/step-5-preview-free 1
+opencode-go/longcat-2.5-preview-free 1
 opencode/big-pickle        1
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawaty/lacode",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "description": "Ultimate opencode setup for Go users — cost-controlled pooled subagents, hang recovery, and notifications for opencode.",
   "license": "MIT",
   "type": "module",
@@ -60,5 +60,8 @@
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "1.18.34"
+  },
+  "publishConfig": {
+    "tag": "beta"
   }
 }

package/presets/README.md

@@ -36,10 +36,10 @@ in place, no JSON and no objects:
 
 ```text
 # provider/model-id                       weight
-opencode-go/step-5-preview-free           3
+opencode-go/longcat-2.5-preview-free      3
 opencode/space-bunny-free                 2
 opencode/big-pickle                       1
-opencode/step-5-preview-free              1
+opencode/longcat-2.5-preview-free         1
 ```
 
 `#` starts a comment (whole-line or trailing), blank lines are ignored, and the

package/presets/free-tier.json

@@ -25,8 +25,8 @@
     "  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: space-bunny takes 3 consecutive turns, then step-5-preview",
-    "(opencode-go) takes 2, then big-pickle and step-5-preview (Zen) take 1 each -- sequence 1,1,1,2,2,3,4,...",
+    "With this file: space-bunny takes 3 consecutive turns, then longcat-2.5-preview",
+    "(opencode-go) takes 2, then big-pickle and longcat-2.5-preview (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.",
     "",
@@ -67,8 +67,8 @@
   ],
   "slots": [
     { "model": "opencode/space-bunny-free", "weight": 3 },
-    { "model": "opencode-go/step-5-preview-free", "weight": 2 },
+    { "model": "opencode-go/longcat-2.5-preview-free", "weight": 2 },
     { "model": "opencode/big-pickle", "weight": 1 },
-    { "model": "opencode/step-5-preview-free", "weight": 1 }
+    { "model": "opencode/longcat-2.5-preview-free", "weight": 1 }
   ]
 }