@lawaty/lacode 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -9,6 +9,33 @@ commit as the changelog entry it describes.
 
 ## [Unreleased]
 
+## [0.5.0] — a user-only /manager-directive, instant limit failover, and the longcat preset
+
+### 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 +193,8 @@ 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.5.0...HEAD
+[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

@@ -178,8 +178,9 @@ 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
+Five commands: `/context-init`, `/context-update`, `/context-review`,
+`/lacode-doctor` and `/manager-directive`. 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
@@ -212,6 +213,7 @@ 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
 ```
 
 The map is local and untracked — it describes your checkout on your machine, so
@@ -251,6 +253,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

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,6 @@
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
 // src/commands.ts
 var COMMANDS = {
   "context-init": {
@@ -77,6 +80,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.",

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.",
@@ -1527,6 +1603,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 +1731,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 +1779,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 +1951,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 +2020,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/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.5.0",
   "description": "Ultimate opencode setup for Go users — cost-controlled pooled subagents, hang recovery, and notifications for opencode.",
   "license": "MIT",
   "type": "module",

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 }
   ]
 }