looply-cli 0.5.3 → 0.5.5

package/dist/init-detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-detect.js","sourceRoot":"","sources":["../src/init-detect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init-detect.js","sourceRoot":"","sources":["../src/init-detect.ts"],"names":[],"mappings":"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"}

package/dist/machine-run-slots.d.ts

@@ -0,0 +1,59 @@
+import { type ProbeFn } from './run-lease';
+/**
+ * HOW MANY AUTONOMOUS RUNS THIS COMPUTER HAS, ACROSS EVERY REPOSITORY IT SERVES.
+ *
+ * `looply serve` runs one daemon per repository, and each daemon's coordinator
+ * bounds only its own project (`machine.max_parallel_runs`). A PC serving 27
+ * repositories at 3 each could otherwise launch 81 agent sessions at once. This
+ * is the one number they share: `machine.max_runs_on_machine` (default 4).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ONE FILE PER SLOT, IN `~/.looply/machine-runs/`.
+ *
+ * A slot is CLAIMED before a launch (pending, holding the daemon's pid) and
+ * BOUND to the child's pid once it is spawned. A slot frees itself: a bound
+ * slot whose pid is dead, or a pending slot older than `PENDING_TTL_MS`, is not
+ * counted and is swept on the next claim. Nothing has to remember to release,
+ * so a crashed run or daemon cannot leak capacity for longer than one probe.
+ *
+ * Claims are serialised by the shared exclusive lock, so two daemons cannot
+ * both see the last free slot and both take it.
+ *
+ * ⚠️ A CLAIM IS ASKED BEFORE A TRY IS SPENT. The launcher's `busyFor` takes it
+ * (see `run-launcher.ts`), and `busyFor` runs before `reserveLaunch` in the
+ * tick, so "the machine is full" is a queue — never a failed attempt. A claim
+ * is idempotent per request: asking again for the same request refreshes it.
+ *
+ * ⚠️ AN UNKNOWN LIVENESS COUNTS AS ALIVE, the direction that cannot overshoot.
+ */
+/** A claim that never became a run stops holding a slot after this. */
+export declare const PENDING_TTL_MS: number;
+export interface MachineSlot {
+    readonly key: string;
+    readonly pid: number;
+    readonly pending: boolean;
+    readonly at: string;
+    /** Which repository the run is for — for a person reading the directory. */
+    readonly repo?: string;
+}
+export interface MachineRunSlots {
+    /** Take (or refresh) a slot for `key`; null when taken, else why the machine is full. */
+    claim(key: string): string | null;
+    /** The launch happened: the slot now lives as long as `pid` does. */
+    bind(key: string, pid: number): void;
+    /** The launch did not happen. */
+    release(key: string): void;
+    /** Live slots right now, `key` excluded when given. */
+    inUse(except?: string): number;
+    readonly cap: number;
+}
+export interface MachineRunSlotDeps {
+    readonly home?: string;
+    readonly now?: () => number;
+    readonly probe?: ProbeFn;
+    readonly pid?: number;
+    readonly repo?: string;
+}
+export declare function machineSlotsDir(home?: string): string;
+export declare function machineRunSlots(cap: number, deps?: MachineRunSlotDeps): MachineRunSlots;
+//# sourceMappingURL=machine-run-slots.d.ts.map

package/dist/machine-run-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-run-slots.d.ts","sourceRoot":"","sources":["../src/machine-run-slots.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,uEAAuE;AACvE,eAAO,MAAM,cAAc,QAAa,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,qEAAqE;IACrE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,iCAAiC;IACjC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uDAAuD;IACvD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhE;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,eAAe,CA8F3F"}

package/dist/machine-run-slots.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PENDING_TTL_MS = void 0;
+exports.machineSlotsDir = machineSlotsDir;
+exports.machineRunSlots = machineRunSlots;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const exclusive_lock_1 = require("./exclusive-lock");
+const run_lease_1 = require("./run-lease");
+/**
+ * HOW MANY AUTONOMOUS RUNS THIS COMPUTER HAS, ACROSS EVERY REPOSITORY IT SERVES.
+ *
+ * `looply serve` runs one daemon per repository, and each daemon's coordinator
+ * bounds only its own project (`machine.max_parallel_runs`). A PC serving 27
+ * repositories at 3 each could otherwise launch 81 agent sessions at once. This
+ * is the one number they share: `machine.max_runs_on_machine` (default 4).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ONE FILE PER SLOT, IN `~/.looply/machine-runs/`.
+ *
+ * A slot is CLAIMED before a launch (pending, holding the daemon's pid) and
+ * BOUND to the child's pid once it is spawned. A slot frees itself: a bound
+ * slot whose pid is dead, or a pending slot older than `PENDING_TTL_MS`, is not
+ * counted and is swept on the next claim. Nothing has to remember to release,
+ * so a crashed run or daemon cannot leak capacity for longer than one probe.
+ *
+ * Claims are serialised by the shared exclusive lock, so two daemons cannot
+ * both see the last free slot and both take it.
+ *
+ * ⚠️ A CLAIM IS ASKED BEFORE A TRY IS SPENT. The launcher's `busyFor` takes it
+ * (see `run-launcher.ts`), and `busyFor` runs before `reserveLaunch` in the
+ * tick, so "the machine is full" is a queue — never a failed attempt. A claim
+ * is idempotent per request: asking again for the same request refreshes it.
+ *
+ * ⚠️ AN UNKNOWN LIVENESS COUNTS AS ALIVE, the direction that cannot overshoot.
+ */
+/** A claim that never became a run stops holding a slot after this. */
+exports.PENDING_TTL_MS = 3 * 60_000;
+function machineSlotsDir(home = (0, node_os_1.homedir)()) {
+    return (0, node_path_1.join)(home, '.looply', 'machine-runs');
+}
+const fileOf = (key) => `${(0, node_crypto_1.createHash)('sha256').update(key).digest('hex').slice(0, 32)}.json`;
+function machineRunSlots(cap, deps = {}) {
+    const dir = machineSlotsDir(deps.home);
+    const now = deps.now ?? (() => Date.now());
+    const probe = deps.probe ?? run_lease_1.nodeProbe;
+    const me = deps.pid ?? process.pid;
+    const limit = Math.max(1, Math.floor(cap));
+    const read = () => {
+        let names;
+        try {
+            names = (0, node_fs_1.readdirSync)(dir).filter((n) => n.endsWith('.json'));
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const file of names) {
+            try {
+                const raw = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(dir, file), 'utf8'));
+                if (typeof raw.key !== 'string' || typeof raw.pid !== 'number' || typeof raw.at !== 'string')
+                    continue;
+                out.push({ file, slot: { key: raw.key, pid: raw.pid, pending: raw.pending === true, at: raw.at, ...(raw.repo === undefined ? {} : { repo: raw.repo }) } });
+            }
+            catch {
+                // A torn write is not a run. The claim that wrote it rewrites it.
+            }
+        }
+        return out;
+    };
+    const live = (s) => {
+        if (s.pending) {
+            const at = Date.parse(s.at);
+            if (!Number.isFinite(at) || now() - at > exports.PENDING_TTL_MS)
+                return false;
+        }
+        return probe(s.pid) !== 'dead';
+    };
+    const write = (slot) => {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+        const target = (0, node_path_1.join)(dir, fileOf(slot.key));
+        const tmp = `${target}.${me}.tmp`;
+        (0, node_fs_1.writeFileSync)(tmp, `${JSON.stringify(slot)}\n`, 'utf8');
+        (0, node_fs_1.renameSync)(tmp, target);
+    };
+    const inUse = (except) => read().filter(({ slot }) => slot.key !== except && live(slot)).length;
+    return {
+        cap: limit,
+        inUse,
+        claim(key) {
+            try {
+                (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+            }
+            catch {
+                // Fall through: the lock below refuses, and a refusal is a wait.
+            }
+            return (0, exclusive_lock_1.withExclusiveLock)((0, node_path_1.join)(dir, 'claim.lock'), () => {
+                const all = read();
+                for (const { file, slot } of all) {
+                    if (!live(slot)) {
+                        try {
+                            (0, node_fs_1.rmSync)((0, node_path_1.join)(dir, file), { force: true });
+                        }
+                        catch {
+                            /* swept next time */
+                        }
+                    }
+                }
+                const mine = all.find(({ slot }) => slot.key === key);
+                if (mine !== undefined && !mine.slot.pending && live(mine.slot))
+                    return null; // already running
+                const others = all.filter(({ slot }) => slot.key !== key && live(slot)).length;
+                if (others >= limit) {
+                    return `this computer already has ${others} autonomous run(s) going across its repositories and its ceiling is ${limit} (machine.max_runs_on_machine)`;
+                }
+                write({ key, pid: me, pending: true, at: new Date(now()).toISOString(), ...(deps.repo === undefined ? {} : { repo: deps.repo }) });
+                return null;
+            }, (why) => `the machine-wide run count could not be checked (${why})`);
+        },
+        bind(key, pid) {
+            try {
+                write({ key, pid, pending: false, at: new Date(now()).toISOString(), ...(deps.repo === undefined ? {} : { repo: deps.repo }) });
+            }
+            catch {
+                // A slot that cannot be bound expires as pending; the run goes on.
+            }
+        },
+        release(key) {
+            try {
+                (0, node_fs_1.rmSync)((0, node_path_1.join)(dir, fileOf(key)), { force: true });
+            }
+            catch {
+                /* expires on its own */
+            }
+        },
+    };
+}
+//# sourceMappingURL=machine-run-slots.js.map

package/dist/machine-run-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-run-slots.js","sourceRoot":"","sources":["../src/machine-run-slots.ts"],"names":[],"mappings":"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"}

package/dist/model-routing.d.ts

@@ -23,15 +23,21 @@
  * time, before a run starts, with the reason — not at round one after the first
  * call has been paid for.
  */
+import { type AgentEffort, type AgentSettings } from '@looply/core';
 /** The roles that drive a model, in the order a round meets them. */
 export declare const MODEL_ROLES: readonly ["implementer", "verifier", "scanner", "brain"];
 export type ModelRole = (typeof MODEL_ROLES)[number];
 /** The keys `agent.models` may carry: every role, plus the one that covers the rest. */
 export declare const MODEL_KEYS: readonly ["default", "implementer", "verifier", "scanner", "brain"];
 export type ModelKey = (typeof MODEL_KEYS)[number];
-/** `--effort`, as Claude Code spells it. Checked against `claude --help` on 2026-09-13. */
+/**
+ * `--effort`, as Claude Code spells it. Checked against `claude --help` on
+ * 2026-09-13. Declared in core, so the server refuses exactly what this does.
+ */
 export declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
-export type Effort = (typeof EFFORT_LEVELS)[number];
+export type Effort = AgentEffort;
+/** `agent.effort` written as a map: `default` covers any role not named. */
+export type RoleEfforts = Partial<Record<ModelKey, Effort>>;
 /**
  * Role → model id. `default` covers any role not named; a role named here wins.
  * Every value is one model id, passed as one argument — never a flag string.
@@ -46,17 +52,56 @@ export type RoleModels = Partial<Record<ModelKey, string>>;
  * one should not be able to step around a cost rule with a capital letter.
  */
 export declare function isBrainOnlyModel(model: string): boolean;
-/** The model a role runs under this configuration, or undefined to leave it to the provider. */
+/** The model config.yaml names for a role, or undefined when it names none. */
 export declare function modelFor(role: ModelRole, models: RoleModels | undefined): string | undefined;
+/**
+ * The effort config.yaml names for a role. `agent.effort` is either one level
+ * for every role (the original shape, still byte-compatible) or a map with an
+ * optional `default`.
+ */
+export declare function effortFor(role: ModelRole, effort: Effort | RoleEfforts | undefined): Effort | undefined;
+/** Where a resolved value came from, as `looply doctor` prints it. */
+export type SettingSource = 'config.yaml' | 'remote' | 'default';
+export interface ResolvedRole {
+    model: string;
+    effort: Effort;
+    modelFrom: SettingSource;
+    effortFrom: SettingSource;
+}
+/**
+ * The model and effort a role runs on the BUILT-IN provider, field by field:
+ *
+ *     config.yaml  >  remote project settings  >  DEFAULT_AGENT_SETTINGS
+ *
+ * config.yaml wins because it is a person's decision written in the repository
+ * on the machine itself; remote settings (console, integrations) fill what the
+ * file leaves unsaid; the built-in table fills the rest. Model and effort are
+ * resolved independently, so a file naming only an effort still takes the
+ * remote or default model.
+ *
+ * ⚠️ A remote Fable model for a non-brain role is ignored here even though the
+ * validator refuses it at the API: the cache is a file on disk, and the rule
+ * is cheap to hold twice.
+ */
+export declare function resolveRole(role: ModelRole, spec: {
+    models?: RoleModels;
+    effort?: Effort | RoleEfforts;
+}, remote?: AgentSettings | null): ResolvedRole;
 /**
  * The arguments that put a role on its model, ready to splice into a Claude
- * Code command line. Empty when nothing is configured, so a project that says
- * nothing about models produces the byte-identical invocation it did before.
+ * Code command line.
+ *
+ * ⚠️ CHANGED DELIBERATELY: this used to be EMPTY when nothing was configured,
+ * so the provider's own default ran (whatever Claude Code happened to pick on
+ * that machine). Every built-in turn now names its model and effort — from
+ * config.yaml, the project's remote settings, or `DEFAULT_AGENT_SETTINGS` — so
+ * what a role runs is a Looply decision that `looply doctor` can print, not an
+ * accident of the machine. Only ever called on the built-in branch.
  */
 export declare function modelArgs(role: ModelRole, spec: {
     models?: RoleModels;
-    effort?: Effort;
-}): string[];
+    effort?: Effort | RoleEfforts;
+}, remote?: AgentSettings | null): string[];
 export type RoleModelsCheck = {
     ok: true;
 } | {

package/dist/model-routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-routing.d.ts","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,qEAAqE;AACrE,eAAO,MAAM,WAAW,0DAA2D,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wFAAwF;AACxF,eAAO,MAAM,UAAU,qEAAuC,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,EAAE,CAMV;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAiCnE"}
+{"version":3,"file":"model-routing.d.ts","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,qEAAqE;AACrE,eAAO,MAAM,WAAW,0DAA2D,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wFAAwF;AACxF,eAAO,MAAM,UAAU,qEAAuC,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,aAAa,oDAAgB,CAAC;AAC3C,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC;AAEjC,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIvG;AAED,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,EAC5D,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,GAC5B,YAAY,CAkCd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,EAC5D,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,GAC5B,MAAM,EAAE,CAGV;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAiCnE"}

package/dist/model-routing.js

@@ -28,14 +28,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EFFORT_LEVELS = exports.MODEL_KEYS = exports.MODEL_ROLES = void 0;
 exports.isBrainOnlyModel = isBrainOnlyModel;
 exports.modelFor = modelFor;
+exports.effortFor = effortFor;
+exports.resolveRole = resolveRole;
 exports.modelArgs = modelArgs;
 exports.checkRoleModels = checkRoleModels;
+const core_1 = require("@looply/core");
 /** The roles that drive a model, in the order a round meets them. */
 exports.MODEL_ROLES = ['implementer', 'verifier', 'scanner', 'brain'];
 /** The keys `agent.models` may carry: every role, plus the one that covers the rest. */
 exports.MODEL_KEYS = ['default', ...exports.MODEL_ROLES];
-/** `--effort`, as Claude Code spells it. Checked against `claude --help` on 2026-09-13. */
-exports.EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
+/**
+ * `--effort`, as Claude Code spells it. Checked against `claude --help` on
+ * 2026-09-13. Declared in core, so the server refuses exactly what this does.
+ */
+exports.EFFORT_LEVELS = core_1.AGENT_EFFORTS;
 /**
  * Which model ids may only be the brain's.
  *
@@ -45,25 +51,89 @@ exports.EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
  * one should not be able to step around a cost rule with a capital letter.
  */
 function isBrainOnlyModel(model) {
-    return /fable/i.test(model);
+    return (0, core_1.isBrainOnlyModelId)(model);
 }
-/** The model a role runs under this configuration, or undefined to leave it to the provider. */
+/** The model config.yaml names for a role, or undefined when it names none. */
 function modelFor(role, models) {
     return models?.[role] ?? models?.default;
 }
+/**
+ * The effort config.yaml names for a role. `agent.effort` is either one level
+ * for every role (the original shape, still byte-compatible) or a map with an
+ * optional `default`.
+ */
+function effortFor(role, effort) {
+    if (effort === undefined)
+        return undefined;
+    if (typeof effort === 'string')
+        return effort;
+    return effort[role] ?? effort.default;
+}
+/**
+ * The model and effort a role runs on the BUILT-IN provider, field by field:
+ *
+ *     config.yaml  >  remote project settings  >  DEFAULT_AGENT_SETTINGS
+ *
+ * config.yaml wins because it is a person's decision written in the repository
+ * on the machine itself; remote settings (console, integrations) fill what the
+ * file leaves unsaid; the built-in table fills the rest. Model and effort are
+ * resolved independently, so a file naming only an effort still takes the
+ * remote or default model.
+ *
+ * ⚠️ A remote Fable model for a non-brain role is ignored here even though the
+ * validator refuses it at the API: the cache is a file on disk, and the rule
+ * is cheap to hold twice.
+ */
+function resolveRole(role, spec, remote) {
+    const fallback = core_1.DEFAULT_AGENT_SETTINGS[role];
+    const fromRemote = remote?.[role];
+    let model;
+    let modelFrom;
+    const configured = modelFor(role, spec.models);
+    const remoteModel = fromRemote?.model;
+    if (configured !== undefined) {
+        model = configured;
+        modelFrom = 'config.yaml';
+    }
+    else if (remoteModel !== undefined && (role === 'brain' || !(0, core_1.isBrainOnlyModelId)(remoteModel))) {
+        model = remoteModel;
+        modelFrom = 'remote';
+    }
+    else {
+        model = fallback.model;
+        modelFrom = 'default';
+    }
+    let effort;
+    let effortFrom;
+    const configuredEffort = effortFor(role, spec.effort);
+    if (configuredEffort !== undefined) {
+        effort = configuredEffort;
+        effortFrom = 'config.yaml';
+    }
+    else if (fromRemote?.effort !== undefined) {
+        effort = fromRemote.effort;
+        effortFrom = 'remote';
+    }
+    else {
+        effort = fallback.effort;
+        effortFrom = 'default';
+    }
+    return { model, effort, modelFrom, effortFrom };
+}
 /**
  * The arguments that put a role on its model, ready to splice into a Claude
- * Code command line. Empty when nothing is configured, so a project that says
- * nothing about models produces the byte-identical invocation it did before.
+ * Code command line.
+ *
+ * ⚠️ CHANGED DELIBERATELY: this used to be EMPTY when nothing was configured,
+ * so the provider's own default ran (whatever Claude Code happened to pick on
+ * that machine). Every built-in turn now names its model and effort — from
+ * config.yaml, the project's remote settings, or `DEFAULT_AGENT_SETTINGS` — so
+ * what a role runs is a Looply decision that `looply doctor` can print, not an
+ * accident of the machine. Only ever called on the built-in branch.
  */
-function modelArgs(role, spec) {
-    const out = [];
-    const model = modelFor(role, spec.models);
-    if (model !== undefined)
-        out.push('--model', model);
-    if (spec.effort !== undefined)
-        out.push('--effort', spec.effort);
-    return out;
+function modelArgs(role, spec, remote) {
+    const r = resolveRole(role, spec, remote);
+    return ['--model', r.model, '--effort', r.effort];
 }
 /**
  * Is this `agent.models` block one looply will drive?

package/dist/model-routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-routing.js","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AA4BH,4CAEC;AAGD,4BAEC;AAOD,8BASC;AAWD,0CAiCC;AA7FD,qEAAqE;AACxD,QAAA,WAAW,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAGpF,wFAAwF;AAC3E,QAAA,UAAU,GAAG,CAAC,SAAS,EAAE,GAAG,mBAAW,CAAU,CAAC;AAG/D,2FAA2F;AAC9E,QAAA,aAAa,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAShF;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,gGAAgG;AAChG,SAAgB,QAAQ,CAAC,IAAe,EAAE,MAA8B;IACtE,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,OAAO,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CACvB,IAAe,EACf,IAA8C;IAE9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC;AAID;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,MAAkB;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAE,kBAAgC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,gBAAgB,GAAG,EAAE;gBAC1B,OAAO,EAAE,iBAAiB,GAAG,cAAc,kBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACnE,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,GAAG,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;QAClF,CAAC;QACD,2EAA2E;QAC3E,8CAA8C;QAC9C,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,gBAAgB,GAAG,EAAE;gBAC1B,OAAO,EAAE,mCAAmC,KAAK,kCAAkC;aACpF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,gBAAgB,GAAG,EAAE;gBAC1B,OAAO,EACL,SAAS,KAAK,yCAAyC;oBACvD,mFAAmF;oBACnF,2FAA2F;aAC9F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"model-routing.js","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":"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"}

package/dist/model-settings.d.ts

@@ -0,0 +1,67 @@
+import { type AgentSettings } from '@looply/core';
+import { type Effort, type RoleEfforts, type RoleModels } from './model-routing';
+/**
+ * THE PROJECT'S REMOTE MODEL SETTINGS, AS THIS MACHINE LAST HEARD THEM.
+ *
+ * The server holds per-project model/effort choices (set from the console or
+ * by an integration). The standalone daemon pulls them on start and every few
+ * minutes and writes them HERE; every built-in model turn — a daemon-launched
+ * run, `looply run`, `scan`, `verify` — reads this file at launch time.
+ *
+ * Why a cached file rather than a field on a payload the run already fetches:
+ * a run may start with the server unreachable, and a machine that goes offline
+ * must keep running the models it was last told to — not silently fall back to
+ * the defaults mid-night. One writer (the daemon), many readers, and a reader
+ * that finds nothing, or something malformed, gets the defaults.
+ *
+ * The value is re-validated on every read with the same core rule the server
+ * applies on write, so a hand-edited or corrupted file cannot put a Fable
+ * model on an agent role or smuggle a flag into the command line.
+ */
+export declare const AGENT_SETTINGS_FILE = "agent-settings.json";
+/** How often the daemon asks the server. */
+export declare const DEFAULT_AGENT_SETTINGS_POLL_MS: number;
+export interface AgentSettingsCache {
+    /** Null means "back to defaults", which is an answer, not an absence. */
+    settings: AgentSettings | null;
+    /** When the server says the settings last changed. */
+    updatedAt: string | null;
+    /** When this machine last heard it. */
+    fetchedAt: string;
+}
+/** The cached answer, or null when there is none or it does not validate. */
+export declare function readAgentSettingsCache(stateDir: string): AgentSettingsCache | null;
+/** Atomic: a reader never sees half a file. */
+export declare function writeAgentSettingsCache(stateDir: string, value: AgentSettingsCache): void;
+/**
+ * The remote settings that apply to a project directory (a worktree resolves
+ * to its repository's shared state), or null. Never throws: a model turn must
+ * not fail because a cache could not be read — it runs the defaults instead.
+ */
+export declare function remoteAgentSettingsFor(projectDir: string): AgentSettings | null;
+export interface AgentSettingsPullDeps {
+    /** `GET /v1/projects/:id/agent-settings`. */
+    fetch(): Promise<unknown>;
+    stateDir: string;
+    log(line: string): void;
+    now(): number;
+}
+export type AgentSettingsPullResult = 'updated' | 'unchanged' | 'failed';
+/**
+ * One pull: ask the server, and write the cache when the answer changed.
+ *
+ * A failure keeps whatever the cache holds — an outage must not reset a
+ * machine to defaults. Offline is reported by the heartbeat already; anything
+ * else (an older server without the route, a malformed answer) is said once
+ * per outage rather than every five minutes.
+ */
+export declare function makeAgentSettingsPull(deps: AgentSettingsPullDeps): () => Promise<AgentSettingsPullResult>;
+/**
+ * The lines `looply doctor` and `looply status` print: per role, the model and
+ * effort and where each came from.
+ */
+export declare function describeModelRouting(spec: {
+    models?: RoleModels;
+    effort?: Effort | RoleEfforts;
+}, builtIn: boolean, remote: AgentSettings | null): string[];
+//# sourceMappingURL=model-settings.d.ts.map

package/dist/model-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-settings.d.ts","sourceRoot":"","sources":["../src/model-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAA4B,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG3G;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,4CAA4C;AAC5C,eAAO,MAAM,8BAA8B,QAAa,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAoBlF;AAED,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAM/E;AAED,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,CA4DzG;AAYD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,EAC5D,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GAAG,IAAI,GAC3B,MAAM,EAAE,CAeV"}