@iowarp/clio-coder 0.3.9 → 0.4.1

package/dist/chunk-YKOFT37S.js

@@ -1,279 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  assistantTextFromEvent
-} from "./chunk-D73KXYPF.js";
-import {
-  durableAssistantTextFromEvent
-} from "./chunk-TEO2TLVN.js";
-import {
-  compileExecutionPlan
-} from "./chunk-HKO36JWF.js";
-import {
-  deriveExecutionRole
-} from "./chunk-H7IXIC72.js";
-import {
-  truncateUtf8
-} from "./chunk-6XLNIQDB.js";
-import {
-  BusChannels
-} from "./chunk-RKRLDWD3.js";
-import {
-  init_esm_shims
-} from "./chunk-3R73A4XB.js";
-
-// src/tools/dispatch-run-events.ts
-init_esm_shims();
-var RUN_TAIL_ENTRY_LIMIT = 100;
-var RUN_TAIL_RUN_LIMIT = 64;
-var RUN_TAIL_TEXT_LIMIT = 600;
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function eventDetail(event) {
-  const text = assistantTextFromEvent(event);
-  if (text.length > 0) return truncateUtf8(text, RUN_TAIL_TEXT_LIMIT, "...");
-  if (!isRecord(event)) return void 0;
-  if (event.type === "clio_tool_finish" && isRecord(event.payload)) {
-    const tool = typeof event.payload.tool === "string" ? event.payload.tool : "tool";
-    const outcome = typeof event.payload.outcome === "string" ? event.payload.outcome : "";
-    return `${tool} ${outcome}`.trim();
-  }
-  if (event.type === "attempt_start") {
-    const attempt = typeof event.attempt === "number" ? event.attempt : "?";
-    const runId = typeof event.runId === "string" ? event.runId : "?";
-    const reason = typeof event.reason === "string" ? event.reason : "retry";
-    return truncateUtf8(`attempt ${attempt} -> ${runId}: ${reason}`, RUN_TAIL_TEXT_LIMIT, "...");
-  }
-  return void 0;
-}
-function createDispatchRunEventRegistry() {
-  const runTails = /* @__PURE__ */ new Map();
-  const activeRuns = /* @__PURE__ */ new Set();
-  const activeBatches = /* @__PURE__ */ new Set();
-  const pruneRunTails = () => {
-    while (runTails.size > RUN_TAIL_RUN_LIMIT) {
-      let oldestKey = null;
-      let oldestSeen = Number.POSITIVE_INFINITY;
-      for (const [key, state] of runTails) {
-        if (activeRuns.has(key) || state.lastSeenAt >= oldestSeen) continue;
-        oldestKey = key;
-        oldestSeen = state.lastSeenAt;
-      }
-      if (oldestKey === null) break;
-      runTails.delete(oldestKey);
-    }
-  };
-  const recordRunEvent = (runId, agentId, event) => {
-    const type = isRecord(event) && typeof event.type === "string" ? event.type : "unknown";
-    if (type === "heartbeat" || type === "message_update") return;
-    const state = runTails.get(runId) ?? { agentId, entries: [], lastSeenAt: Date.now() };
-    state.lastSeenAt = Date.now();
-    const entry = { at: (/* @__PURE__ */ new Date()).toISOString(), type };
-    const detail = eventDetail(event);
-    if (detail !== void 0) entry.detail = detail;
-    state.entries.push(entry);
-    if (state.entries.length > RUN_TAIL_ENTRY_LIMIT) {
-      state.entries.splice(0, state.entries.length - RUN_TAIL_ENTRY_LIMIT);
-    }
-    runTails.set(runId, state);
-    pruneRunTails();
-  };
-  const drainSingle = async (runId, agentId, events, bus) => {
-    const summary = {
-      count: 0,
-      types: [],
-      lastAssistantText: "",
-      terminalAttemptRunId: runId
-    };
-    for await (const event of events) {
-      summary.count += 1;
-      const type = isRecord(event) && typeof event.type === "string" ? event.type : "unknown";
-      summary.types.push(type);
-      if (type === "attempt_start") summary.lastAssistantText = "";
-      const text = durableAssistantTextFromEvent(event);
-      if (text.trim().length > 0) summary.lastAssistantText = text;
-      recordRunEvent(runId, agentId, event);
-      if (type !== "heartbeat") bus?.emit(BusChannels.DispatchProgress, { runId, agentId, event });
-    }
-    return summary;
-  };
-  const drainBatch = async (batchId, events, bus) => {
-    const summaries = /* @__PURE__ */ new Map();
-    for await (const event of events) {
-      if (!isRecord(event) || event.type !== "batch_run_event") continue;
-      const runId = typeof event.runId === "string" ? event.runId : batchId;
-      const agentId = typeof event.agentId === "string" ? event.agentId : "batch";
-      const inner = event.event;
-      const summary = summaries.get(runId) ?? {
-        count: 0,
-        types: [],
-        lastAssistantText: "",
-        terminalAttemptRunId: runId
-      };
-      summary.count += 1;
-      const type = isRecord(inner) && typeof inner.type === "string" ? inner.type : "unknown";
-      summary.types.push(type);
-      const text = durableAssistantTextFromEvent(inner);
-      if (text.trim().length > 0) summary.lastAssistantText = text;
-      summaries.set(runId, summary);
-      recordRunEvent(runId, agentId, inner);
-      if (type !== "heartbeat") bus?.emit(BusChannels.DispatchProgress, { runId, agentId, event: inner });
-    }
-    return summaries;
-  };
-  return {
-    registerSingle(handle, agentId, bus) {
-      if (activeRuns.has(handle.runId)) {
-        throw new Error(`dispatch event registry: run '${handle.runId}' is already registered`);
-      }
-      activeRuns.add(handle.runId);
-      const summaryPromise = drainSingle(handle.runId, agentId, handle.events, bus);
-      const completion = Promise.allSettled([summaryPromise, handle.finalPromise]).then(
-        ([summaryResult, receiptResult]) => {
-          if (summaryResult.status === "rejected") throw summaryResult.reason;
-          if (receiptResult.status === "rejected") throw receiptResult.reason;
-          return { receipt: receiptResult.value, summary: summaryResult.value };
-        }
-      );
-      void completion.finally(() => {
-        activeRuns.delete(handle.runId);
-        pruneRunTails();
-      }).catch(() => {
-      });
-      return { runId: handle.runId, completion };
-    },
-    registerBatch(handle, agentIds, bus) {
-      if (activeBatches.has(handle.batchId)) {
-        throw new Error(`dispatch event registry: batch '${handle.batchId}' is already registered`);
-      }
-      const duplicateRunId = handle.assignmentIds.find(
-        (runId, index) => handle.assignmentIds.slice(0, index).includes(runId)
-      );
-      if (duplicateRunId !== void 0) {
-        throw new Error(`dispatch event registry: batch '${handle.batchId}' repeats run '${duplicateRunId}'`);
-      }
-      const activeRunId = handle.assignmentIds.find((runId) => activeRuns.has(runId));
-      if (activeRunId !== void 0) {
-        throw new Error(`dispatch event registry: run '${activeRunId}' is already registered`);
-      }
-      activeBatches.add(handle.batchId);
-      for (const runId of handle.assignmentIds) activeRuns.add(runId);
-      const completion = Promise.allSettled([drainBatch(handle.batchId, handle.events, bus), handle.finalPromise]).then(
-        ([summariesResult, receiptsResult]) => {
-          if (summariesResult.status === "rejected") throw summariesResult.reason;
-          if (receiptsResult.status === "rejected") throw receiptsResult.reason;
-          return { receipts: receiptsResult.value, summaries: summariesResult.value };
-        }
-      );
-      void completion.finally(() => {
-        activeBatches.delete(handle.batchId);
-        for (const runId of handle.assignmentIds) activeRuns.delete(runId);
-        pruneRunTails();
-      }).catch(() => {
-      });
-      for (const [index, runId] of handle.assignmentIds.entries()) {
-        if (!runTails.has(runId)) {
-          runTails.set(runId, {
-            agentId: agentIds[index] ?? "unknown",
-            entries: [],
-            lastSeenAt: Date.now()
-          });
-        }
-      }
-      return { batchId: handle.batchId, assignmentIds: handle.assignmentIds, completion };
-    },
-    recordEvent: recordRunEvent,
-    eventTail(runId) {
-      const state = runTails.get(runId);
-      return state === void 0 ? null : { agentId: state.agentId, entries: [...state.entries] };
-    }
-  };
-}
-
-// src/domains/dispatch/scout-transition.ts
-init_esm_shims();
-function scopeFor(authority) {
-  return authority === "read-only" || authority === "verification" ? "readonly" : "workspace";
-}
-function assertReceiptDigest(value) {
-  if (!/^[0-9a-f]{64}$/u.test(value)) throw new Error("scout transition: source receipt digest is invalid");
-}
-function compileScoutTransition(input) {
-  assertReceiptDigest(input.sourceReceiptDigest);
-  if (!input.scout.needsSplit) {
-    return {
-      kind: "settled",
-      sourceReceiptDigest: input.sourceReceiptDigest,
-      findings: input.scout.findings.map((finding) => ({ ...finding }))
-    };
-  }
-  const subtasks = input.scout.proposedSubtasks;
-  const byId = new Map(input.bindings.map((binding) => [binding.subtaskId, binding]));
-  if (byId.size !== input.bindings.length || byId.size !== subtasks.length) {
-    throw new Error("scout transition: coordinator bindings must match subtasks exactly");
-  }
-  for (const binding of input.bindings) {
-    if (!subtasks.some((subtask) => subtask.id === binding.subtaskId)) {
-      throw new Error(`scout transition: undeclared binding '${binding.subtaskId}'`);
-    }
-  }
-  const approved = new Set(input.authority.approvedAuthorities);
-  const missing = /* @__PURE__ */ new Set();
-  const steps = subtasks.map((subtask) => {
-    const binding = byId.get(subtask.id);
-    if (binding === void 0) throw new Error(`scout transition: subtask '${subtask.id}' has no agent binding`);
-    if (binding.spec.resultContract.kind !== subtask.expectedResultContract) {
-      throw new Error(`scout transition: subtask '${subtask.id}' result contract does not match its bound agent`);
-    }
-    if (binding.spec.capabilityClass !== subtask.requestedAuthority) {
-      throw new Error(`scout transition: subtask '${subtask.id}' authority does not match its bound agent`);
-    }
-    const granted = approved.has(subtask.requestedAuthority);
-    if (!granted) missing.add(subtask.requestedAuthority);
-    return {
-      id: subtask.id,
-      agentId: binding.spec.id,
-      executionRole: deriveExecutionRole({
-        attempt: 0,
-        capabilityClass: binding.spec.capabilityClass,
-        resultContractKind: binding.spec.resultContract.kind
-      }),
-      scope: scopeFor(subtask.requestedAuthority),
-      expectedResultContract: subtask.expectedResultContract,
-      requestedAuthority: subtask.requestedAuthority,
-      approvedAuthority: granted ? subtask.requestedAuthority : null,
-      dependencies: [...subtask.dependencies],
-      task: subtask.task
-    };
-  });
-  const plan = compileExecutionPlan({
-    topology: "fleet",
-    rootTask: input.rootTask,
-    maxWorkers: Math.max(1, Math.min(4, input.maxWorkers, steps.length)),
-    onFailure: "stop",
-    steps
-  });
-  if (missing.size > 0) {
-    return {
-      kind: "approval-required",
-      sourceReceiptDigest: input.sourceReceiptDigest,
-      plan,
-      requiredAuthorities: [...missing]
-    };
-  }
-  return {
-    kind: "ready",
-    sourceReceiptDigest: input.sourceReceiptDigest,
-    plan,
-    authority: {
-      basis: input.authority.basis,
-      approvedAuthorities: [...input.authority.approvedAuthorities]
-    }
-  };
-}
-
-export {
-  compileScoutTransition,
-  createDispatchRunEventRegistry
-};
-//# sourceMappingURL=chunk-YKOFT37S.js.map

package/dist/clio-LT5V7SSZ.js

@@ -1,26 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  runClioCommand,
-  terminalLeaseEligible
-} from "./chunk-B5XRQOLB.js";
-import "./chunk-FALJGAWU.js";
-import "./chunk-HKIYEGME.js";
-import "./chunk-56KB5IJP.js";
-import "./chunk-PNY46YEY.js";
-import "./chunk-FQ4SKYE4.js";
-import "./chunk-IWHMRKLL.js";
-import "./chunk-XDOQXGFO.js";
-import "./chunk-LL4KHSZI.js";
-import "./chunk-4ZG3XFUR.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import "./chunk-BNAZZHFG.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-YXLYO42X.js";
-import "./chunk-3R73A4XB.js";
-export {
-  runClioCommand,
-  terminalLeaseEligible
-};
-//# sourceMappingURL=clio-LT5V7SSZ.js.map

package/dist/configure-2WYWSCSD.js

@@ -1,49 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  runConfigureCommand,
-  runTargetRemove,
-  runTargetRename
-} from "./chunk-3V5AYSEQ.js";
-import "./chunk-2STGEDFV.js";
-import "./chunk-2IR2NMPA.js";
-import "./chunk-IFBNV6H6.js";
-import "./chunk-QQ7EKM72.js";
-import "./chunk-56KB5IJP.js";
-import "./chunk-XK56QHLX.js";
-import "./chunk-5TSRNF4G.js";
-import "./chunk-MIX5N5AC.js";
-import "./chunk-CFGTUFWB.js";
-import "./chunk-LU7P4LHA.js";
-import "./chunk-AEYBF3TB.js";
-import "./chunk-IHXBNWMM.js";
-import "./chunk-B5CSFE7B.js";
-import "./chunk-PNY46YEY.js";
-import "./chunk-FQ4SKYE4.js";
-import "./chunk-ZGVHUX3M.js";
-import "./chunk-RKRLDWD3.js";
-import "./chunk-KV2AOLDF.js";
-import "./chunk-6EJMN2Y3.js";
-import "./chunk-IWHMRKLL.js";
-import "./chunk-JEQQR47K.js";
-import "./chunk-XDOQXGFO.js";
-import "./chunk-LL4KHSZI.js";
-import "./chunk-4ZG3XFUR.js";
-import "./chunk-774ILSRL.js";
-import "./chunk-EQ63NRB7.js";
-import "./chunk-SST6Z5JA.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import "./chunk-BNAZZHFG.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-NUGM5KR6.js";
-import "./chunk-VO2LKSTM.js";
-import "./chunk-UOSL25KY.js";
-import "./chunk-YXLYO42X.js";
-import "./chunk-3R73A4XB.js";
-export {
-  runConfigureCommand,
-  runTargetRemove,
-  runTargetRename
-};
-//# sourceMappingURL=configure-2WYWSCSD.js.map

package/dist/doctor-TWBWFK5V.js

@@ -1,165 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  formatDoctorReport,
-  isUninitializedHome,
-  runDoctor,
-  runDoctorFleetChecks,
-  runDoctorInteropChecks,
-  runDoctorModelChecks,
-  runDoctorRuntimeChecks
-} from "./chunk-T3Z6VAAF.js";
-import "./chunk-AD7Y7STJ.js";
-import "./chunk-AMKHQW3C.js";
-import "./chunk-3DPEIQKN.js";
-import "./chunk-5QKCQQ3E.js";
-import "./chunk-RAPCMZL4.js";
-import "./chunk-CGKSTWHD.js";
-import "./chunk-XPLRXC72.js";
-import "./chunk-IFBNV6H6.js";
-import "./chunk-QQ7EKM72.js";
-import "./chunk-56KB5IJP.js";
-import {
-  printError
-} from "./chunk-XK56QHLX.js";
-import "./chunk-5TSRNF4G.js";
-import "./chunk-LU7P4LHA.js";
-import "./chunk-IHXBNWMM.js";
-import "./chunk-B5CSFE7B.js";
-import "./chunk-PNY46YEY.js";
-import "./chunk-FQ4SKYE4.js";
-import "./chunk-KV2AOLDF.js";
-import "./chunk-6EJMN2Y3.js";
-import "./chunk-IWHMRKLL.js";
-import "./chunk-XDOQXGFO.js";
-import "./chunk-LL4KHSZI.js";
-import "./chunk-4ZG3XFUR.js";
-import "./chunk-EQ63NRB7.js";
-import "./chunk-SST6Z5JA.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import {
-  resolveClioDirs
-} from "./chunk-BNAZZHFG.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-NUGM5KR6.js";
-import "./chunk-YXLYO42X.js";
-import {
-  init_esm_shims
-} from "./chunk-3R73A4XB.js";
-
-// src/cli/doctor.ts
-init_esm_shims();
-
-// src/cli/doctor-state-size.ts
-init_esm_shims();
-import { lstatSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-function stateStorageFinding(stateDir = resolveClioDirs().state) {
-  let names;
-  try {
-    names = readdirSync(stateDir);
-  } catch (error) {
-    return {
-      ok: false,
-      name: "state storage",
-      detail: `${stateDir} could not be measured: ${error instanceof Error ? error.message : String(error)}`
-    };
-  }
-  let total = 0;
-  let largest = null;
-  for (const name of names.sort()) {
-    const measured = measureEntry(join(stateDir, name));
-    if (measured.error !== null) {
-      return { ok: false, name: "state storage", detail: measured.error };
-    }
-    total += measured.bytes;
-    if (largest === null || measured.bytes > largest.bytes) largest = { name, bytes: measured.bytes };
-  }
-  return {
-    ok: true,
-    name: "state storage",
-    detail: largest === null ? `${formatBytes(total)} (${total.toLocaleString("en-US")} bytes); largest contributor none` : `${formatBytes(total)} (${total.toLocaleString("en-US")} bytes); largest contributor ${largest.name} at ${formatBytes(largest.bytes)} (${largest.bytes.toLocaleString("en-US")} bytes)`
-  };
-}
-function measureEntry(path) {
-  let stats;
-  try {
-    stats = lstatSync(path);
-  } catch (error) {
-    return {
-      bytes: 0,
-      error: `${path} could not be inspected: ${error instanceof Error ? error.message : String(error)}`
-    };
-  }
-  if (!stats.isDirectory() || stats.isSymbolicLink()) return { bytes: stats.size, error: null };
-  let names;
-  try {
-    names = readdirSync(path);
-  } catch (error) {
-    return { bytes: 0, error: `${path} could not be listed: ${error instanceof Error ? error.message : String(error)}` };
-  }
-  let bytes = 0;
-  for (const name of names) {
-    const child = measureEntry(join(path, name));
-    if (child.error !== null) return child;
-    bytes += child.bytes;
-  }
-  return { bytes, error: null };
-}
-function formatBytes(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  const units = ["KiB", "MiB", "GiB", "TiB"];
-  let value = bytes;
-  let unit = -1;
-  do {
-    value /= 1024;
-    unit += 1;
-  } while (value >= 1024 && unit < units.length - 1);
-  return `${value.toFixed(value >= 10 ? 1 : 2)} ${units[unit]}`;
-}
-
-// src/cli/doctor.ts
-var HELP = `clio-coder doctor [--fix] [--json]
-
-Diagnose Clio Coder state without creating files. On a home Clio has never
-written to, doctor says so in one row and exits 0. Use --fix to repair structure:
-missing directories, missing template files, and credential permissions.
-Settings are validated directly against the current schema.
-Pass --json to emit a machine-readable report on stdout.
-`;
-async function runDoctorCommand(args = []) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(HELP);
-    return 0;
-  }
-  const fix = args.includes("--fix");
-  const json = args.includes("--json");
-  const unknown = args.find((arg) => arg !== "--fix" && arg !== "--json");
-  if (unknown) {
-    printError(`unknown flag: ${unknown}`);
-    process.stderr.write(HELP);
-    return 2;
-  }
-  const untouched = !fix && isUninitializedHome();
-  const findings = runDoctor({ fix });
-  const storageChecks = untouched ? [] : [stateStorageFinding()];
-  const runtimeChecks = await runDoctorRuntimeChecks();
-  const modelChecks = await runDoctorModelChecks();
-  const interopChecks = untouched ? [] : await runDoctorInteropChecks();
-  const fleetChecks = untouched ? [] : await runDoctorFleetChecks();
-  const all = [...findings, ...storageChecks, ...runtimeChecks, ...modelChecks, ...interopChecks, ...fleetChecks];
-  const ok = all.every((f) => f.ok);
-  if (json) {
-    process.stdout.write(`${JSON.stringify({ ok, fix, findings: all }, null, 2)}
-`);
-  } else {
-    process.stdout.write(`${formatDoctorReport(all)}
-`);
-  }
-  return ok ? 0 : 1;
-}
-export {
-  runDoctorCommand
-};
-//# sourceMappingURL=doctor-TWBWFK5V.js.map

package/src/engine/apis/degraded-inference.ts

@@ -1,95 +0,0 @@
-/**
- * Degraded-inference watchdog for local runtimes.
- *
- * A local server whose weights or KV cache spilled to CPU does not fail: it
- * answers, at roughly a hundredth of the speed, and the operator sees only a
- * spinner. The observed case was 2m18s of streaming for 25 tokens with no
- * indication that anything was wrong. This watchdog turns that silence into a
- * notice: once a prediction has run past a grace period, a sustained token rate
- * below the floor is reported once per turn, along with what is resident on the
- * target so the cause is visible in the same line.
- *
- * The watchdog observes; it never cancels a turn. A slow model is still a
- * working model, and the operator decides whether to abort.
- */
-
-/** Wall-clock a prediction gets before its rate is judged. */
-export const DEGRADED_GRACE_MS = 30_000;
-/** Sustained output tokens per second below which inference is reported as degraded. */
-export const DEGRADED_FLOOR_TOKENS_PER_SECOND = 2;
-
-export interface DegradedInferenceReport {
-	elapsedMs: number;
-	tokens: number;
-	tokensPerSecond: number;
-}
-
-export interface DegradedInferenceOptions {
-	/** Called at most once, when the observed rate stays under the floor past the grace period. */
-	onDegraded: (report: DegradedInferenceReport) => void;
-	graceMs?: number;
-	floorTokensPerSecond?: number;
-	/** Sampling interval; the watchdog checks the rate this often. */
-	pollMs?: number;
-	now?: () => number;
-	setTimer?: (fn: () => void, ms: number) => { cancel: () => void };
-}
-
-export interface DegradedInferenceWatchdog {
-	/** Record generated tokens (output plus reasoning; both are work the server did). */
-	addTokens: (count: number) => void;
-	/** Test seam: evaluate the rate now instead of waiting for the next poll. */
-	check: () => void;
-	stop: () => void;
-}
-
-function defaultTimer(fn: () => void, ms: number): { cancel: () => void } {
-	const handle = setInterval(fn, ms);
-	handle.unref?.();
-	return { cancel: () => clearInterval(handle) };
-}
-
-/**
- * Start watching a prediction's token rate. Call {@link
- * DegradedInferenceWatchdog.addTokens} as fragments arrive and `stop()` when the
- * turn ends, in a `finally`, so a failed turn never leaves a timer behind.
- */
-export function startDegradedInferenceWatchdog(options: DegradedInferenceOptions): DegradedInferenceWatchdog {
-	const now = options.now ?? Date.now;
-	const graceMs = options.graceMs ?? DEGRADED_GRACE_MS;
-	const floor = options.floorTokensPerSecond ?? DEGRADED_FLOOR_TOKENS_PER_SECOND;
-	const pollMs = options.pollMs ?? 5_000;
-	const startedAt = now();
-	let tokens = 0;
-	let reported = false;
-	let stopped = false;
-
-	const check = (): void => {
-		if (reported || stopped) return;
-		const elapsedMs = now() - startedAt;
-		if (elapsedMs < graceMs) return;
-		const tokensPerSecond = tokens / (elapsedMs / 1000);
-		if (tokensPerSecond >= floor) return;
-		reported = true;
-		timer.cancel();
-		try {
-			options.onDegraded({ elapsedMs, tokens, tokensPerSecond });
-		} catch {
-			// A notice sink failure must never escape into the turn it describes.
-		}
-	};
-
-	const timer = (options.setTimer ?? defaultTimer)(check, pollMs);
-
-	return {
-		addTokens: (count) => {
-			if (Number.isFinite(count) && count > 0) tokens += count;
-		},
-		check,
-		stop: () => {
-			if (stopped) return;
-			stopped = true;
-			timer.cancel();
-		},
-	};
-}