@lawaty/lacode 0.5.0 → 0.7.0

package/dist/commands.js

@@ -1,5 +1,55 @@
-// src/lib/manager-directive.ts
-var MANAGER_AGENT_NAME = "manager";
+// src/lib/agent-instructions.ts
+var AGENT_INSTRUCTIONS_COMMAND = "agent-instructions";
+var AGENT_INSTRUCTIONS_WRITER = "instructions";
+
+// 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 = {
@@ -22,13 +72,7 @@ Remember: write conclusions, not inventories. Link to the project's existing
 documentation instead of duplicating it.
 
 Report what you created or updated, what you deliberately left out, and
-anything that contradicts the code or existing docs.
-
-If \`.opencode/context/manager.md\` does not exist, mention in your final
-report that the client can add it themselves \u2014 their own file with
-\`## Current\`, \`## Next\`, \`## Confirmed\` and \`## Instructions\` \u2014 for what
-is being worked on, what comes next, what they have ratified, and standing
-direction. Never create it.`
+anything that contradicts the code or existing docs.`
   },
   "context-update": {
     description: "Incrementally update .opencode/context/ after recent work via the context agent.",
@@ -59,9 +103,8 @@ timestamp-only edits. If nothing material changed, make no edits and report
     subtask: true,
     template: `Context review.
 
-Everything outside the five context files is read-only for this run \u2014
-including \`manager.md\`, which belongs to the client. Do not modify source
-code under any circumstances.
+Everything outside the five context files is read-only for this run. Do not
+modify source code under any circumstances.
 
 Audit the five context files for:
 
@@ -74,18 +117,15 @@ Audit the five context files for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything stated as fact that you cannot verify,
   or that lacks a confidence marker
-- \`manager.md\`, if present: is \`## Current\` and \`## Next\` still true of
-  recent work, is every \`## Confirmed\` entry still true of the code, has it
-  outgrown roughly 150 lines \u2014 report findings, but never edit it
 
 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,
+  [AGENT_INSTRUCTIONS_COMMAND]: {
+    description: "Apply a client instruction to the project's AGENTS.md. Client-only \u2014 runs the instructions agent, the only writer of that file.",
+    agent: AGENT_INSTRUCTIONS_WRITER,
     subtask: true,
-    template: `Apply this instruction to \`.opencode/context/manager.md\`, and edit only that file:
+    template: `Apply this instruction to the project's \`AGENTS.md\`, and edit only that file:
 
 $ARGUMENTS
 
@@ -121,6 +161,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) {
@@ -137,50 +207,7 @@ function applyCommands(cfg, commands = COMMANDS) {
   }
   return { added, kept };
 }
-var INSTRUCTION_MARKER = "<!-- lacode:context-map-instruction:v1 -->";
-var INSTRUCTION_OPT_OUT = "<!-- lacode:context-map-instruction:off -->";
-var STANDING_INSTRUCTION = `## Repository context map
-
-This project may keep a navigation map in \`.opencode/context/\`. Before broad
-exploration, check whether it exists (\`ls .opencode/context\` \u2014 never the \`glob\`
-tool, which skips hidden directories). If \`manager.md\` exists there, read it
-first: it is the client's own statement of intent \u2014 what is being worked on,
-what comes next, \`## Confirmed\` lists what the client has ratified, and
-\`## Instructions\` holds standing managerial directions. It outranks every
-other context file and every inference of yours about what matters right now.
-It says nothing about where code lives, so it cannot contradict the code;
-treat its \`## Confirmed\` entries as settled decisions, not as a licence to
-skip reading the code. Any heading in it is direction, so read the whole
-file rather than only the sections above. The rest of the map remains usable,
-just unratified where \`## Confirmed\` does not cover it. Then read only the
-file relevant to the task \u2014 \`architecture.md\`, \`contexts.md\`,
-\`conventions.md\`, \`workflows.md\`, \`decisions.md\` \u2014 and start from the
-canonical entry points it lists.
-
-Source code is authoritative: if the map disagrees with the code,
-trust the code and say so; never edit source to match it.
-Never edit the five context files yourself \u2014 the context agent owns them.
-\`manager.md\` is the client's own file and the context agent is explicitly
-permission-denied from writing it. You may write it only when the client
-explicitly asks you to in this conversation, and then only what they asked
-for; never on your own initiative, and never to "keep it up to date". Say in
-your final report if your work revealed something that belongs to the map, or
-if \`manager.md\` and the code disagree.`;
-function applyInstructions(cfg) {
-  const existing = Array.isArray(cfg.instructions) ? cfg.instructions : [];
-  const texts = existing.filter((e) => typeof e === "string");
-  if (texts.some((e) => e.includes(INSTRUCTION_OPT_OUT))) return { added: false };
-  if (texts.some((e) => e.includes(INSTRUCTION_MARKER))) return { added: false };
-  cfg.instructions = [...existing, `${INSTRUCTION_MARKER}
-
-${STANDING_INSTRUCTION}`];
-  return { added: true };
-}
 export {
   COMMANDS,
-  INSTRUCTION_MARKER,
-  INSTRUCTION_OPT_OUT,
-  STANDING_INSTRUCTION,
-  applyCommands,
-  applyInstructions
+  applyCommands
 };