@kubitnodes/stellaris 0.4.0 → 0.4.1

package/dist/cli/index.js

@@ -370,6 +370,18 @@ function mergeQuota(previous, next) {
     windows: [...windows.values()]
   };
 }
+var UNKNOWN_LIMIT_HOLD_MS = 30 * 6e4;
+function stopsTurns(quota) {
+  return quota.status === "limited" && !(quota.source === "read" && quota.extraUsage?.enabled === true);
+}
+function limitHold(quota, now) {
+  if (!stopsTurns(quota)) {
+    return null;
+  }
+  const known = quota.limitedUntil !== null;
+  const until = quota.limitedUntil ?? new Date(Date.parse(quota.observedAt) + UNKNOWN_LIMIT_HOLD_MS).toISOString();
+  return Date.parse(until) > now.getTime() ? { until, known } : null;
+}
 function readings(quota) {
   const windows = quota.windows.map((window) => `${window.key}=${window.usedPercent === null ? "?" : Math.round(window.usedPercent)}@${window.resetsAt === null ? "?" : Math.round(Date.parse(window.resetsAt) / 6e4)}`).toSorted();
   return windows.join(",");
@@ -699,12 +711,16 @@ var RunnerSchema = z5.object({
 function runnerPause(runner2, cli) {
   return runner2.paused ?? runner2.pausedClis?.[cli];
 }
-function heldOn(runners, runner2, cli) {
+function runnerLimitHold(runner2, cli, now) {
+  const quota = runner2.quotas?.[cli];
+  return quota === void 0 ? null : limitHold(quota, now);
+}
+function heldOn(runners, runner2, cli, now) {
   if (runner2 === void 0 || cli === null) {
     return false;
   }
   const record = runners.find((each) => each.name === runner2);
-  return record !== void 0 && runnerPause(record, cli) !== void 0;
+  return record !== void 0 && (runnerPause(record, cli) !== void 0 || runnerLimitHold(record, cli, now) !== null);
 }
 var ProposalKindSchema = z5.enum([
   "role",
@@ -2284,7 +2300,7 @@ var RunnerConfigSchema = z13.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.4.0";
+var STELLARIS_VERSION = "0.4.1";
 
 // packages/shared/dist/mentions.js
 import { parse, postprocess, preprocess } from "micromark";
@@ -3900,8 +3916,10 @@ function plain(value) {
     return "";
   return JSON.stringify(value);
 }
-function sentence(summary) {
-  return summary.trim().replace(/\.+$/, "");
+var SENTENCE_END = /[.…?!]["'”’»)\]}*_]*$/u;
+function asSentence(text) {
+  const trimmed = text.trim();
+  return SENTENCE_END.test(trimmed) ? trimmed : `${trimmed}.`;
 }
 function skillSummary(data, body) {
   const description = data["description"];
@@ -5485,7 +5503,7 @@ ${current.body}`);
         name: args.name,
         reason: args.reason
       });
-      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${sentence(withoutMentions(args.reason))}. Every citizen's skills index stops listing it from its next turn.`);
+      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${asSentence(withoutMentions(args.reason))} Every citizen's skills index stops listing it from its next turn.`);
       return removed;
     });
   }
@@ -6555,7 +6573,7 @@ ${args.summary}`);
       });
       const thread2 = await this.openThreadUnlocked(actor.name, this.proposalThreadOpening(proposal2));
       const rationale = args.rationale.trim();
-      await this.appendThreadMessage(actor.name, thread2.id, `Proposal ${proposal2.id}: ${describeCharter(proposal2.kind, proposal2.charter)}.${rationale.length === 0 ? "" : `
+      await this.appendThreadMessage(actor.name, thread2.id, `Proposal ${proposal2.id}: ${asSentence(describeCharter(proposal2.kind, proposal2.charter))}${rationale.length === 0 ? "" : `
 
 ${rationale}`}`);
       return proposal2;
@@ -7259,7 +7277,7 @@ ${rationale}`}`);
       const ts = this.now().toISOString();
       const landed = current.onDone !== "none";
       if (landed) {
-        await this.postTaskNote(actor.name, current, input.ok ? `${sentence(input.detail)}.` : `Landing failed: ${sentence(input.detail)}. The task waits at its last stage for its participants to reshape the plan.`, input.ok ? { action: "landed", stage: current.stage, to: null } : { action: "reopened", stage: current.stage, to: current.stage });
+        await this.postTaskNote(actor.name, current, input.ok ? asSentence(input.detail) : `Landing failed: ${asSentence(input.detail)} The task waits at its last stage for its participants to reshape the plan.`, input.ok ? { action: "landed", stage: current.stage, to: null } : { action: "reopened", stage: current.stage, to: current.stage });
       }
       if (input.ok) {
         const task3 = await this.writeEndedTask(actor.name, location.project, {
@@ -7279,7 +7297,7 @@ ${rationale}`}`);
           await this.refreshMember(name);
         }
         if (landed) {
-          await this.appendMessage(actor.name, channelRef(location.project, task3.channel), `Task ${task3.id} "${task3.title}" is done: ${sentence(input.detail)}.`);
+          await this.appendMessage(actor.name, channelRef(location.project, task3.channel), `Task ${task3.id} "${task3.title}" is done: ${asSentence(input.detail)}`);
         }
         return task3;
       }
@@ -7990,7 +8008,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       files: taken.files.length,
       ...meta
     });
-    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill2.name} ${replaced ? "updated in" : "promoted to"} the society: ${sentence(skill2.summary)}. Every citizen's skills index now lists it.`);
+    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill2.name} ${replaced ? "updated in" : "promoted to"} the society: ${asSentence(skill2.summary)} Every citizen's skills index now lists it.`);
     return replaced;
   }
   /**
@@ -8237,7 +8255,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
     });
     const purpose = withoutMentions(input.purpose);
     await this.appendMessage(SYSTEM_ACTOR.name, ref, `Channel ${ref} opened: ${purpose}`);
-    await this.appendMessage(SYSTEM_ACTOR.name, channelRef(input.project, "general"), `Channel ${ref} opened by ${by}: ${purpose}. Subscribe to it to follow its posts; its tasks and mentions reach whoever they concern either way.`);
+    await this.appendMessage(SYSTEM_ACTOR.name, channelRef(input.project, "general"), `Channel ${ref} opened by ${by}: ${asSentence(purpose)} Subscribe to it to follow its posts; its tasks and mentions reach whoever they concern either way.`);
     return ref;
   }
   /**
@@ -8660,17 +8678,18 @@ ${charter.purpose}
     return kept > lease ? new Date(kept).toISOString() : null;
   }
   /**
-   * The lease a holder keeps while the user's pause holds its turns in the task's project
-   * (`heldOn`), when later than the one it has, else null. It is renewed for a full lease once less
-   * than half is left, as for a pending cron, so it never lapses while the holder cannot take a
-   * turn there, and after the resume the holder has at least half a lease to come back to it.
+   * The lease a holder keeps while the user's pause, or its CLI's limit, holds its turns in the
+   * task's project (`heldOn`), when later than the one it has, else null. It is renewed for a full
+   * lease once less than half is left, as for a pending cron, so it never lapses while the holder
+   * cannot take a turn there, and after the resume or the reset the holder has at least half a
+   * lease to come back to it.
    */
   async pausedLease(task2, runners, runner2, now) {
     if (task2.claimedBy === void 0 || task2.leaseExpiresAt === void 0) {
       return null;
     }
     const holder = await this.readAgent(task2.claimedBy).catch(() => null);
-    if (holder === null || !heldOn(runners, runner2, holder.cli)) {
+    if (holder === null || !heldOn(runners, runner2, holder.cli, now)) {
       return null;
     }
     const lease = Date.parse(task2.leaseExpiresAt);
@@ -8761,9 +8780,9 @@ ${charter.purpose}
       });
     }
     const verdict = outcome === "approved" ? "Approved" : "Rejected";
-    const why = reason === void 0 ? "" : ` Reason: ${reason}.`;
+    const why = reason === void 0 ? "" : ` Reason: ${asSentence(reason)}`;
     const result = provision === void 0 ? "" : ` Provisioned: ${Object.entries(provision).map(([key, value]) => `${key} ${plain(value)}`).join(", ")}.`;
-    const post = `${verdict}: ${describeCharter(proposal2.kind, proposal2.charter)}.${why}${result}`;
+    const post = `${verdict}: ${asSentence(describeCharter(proposal2.kind, proposal2.charter))}${why}${result}`;
     await this.appendThreadMessage(actor.name, thread2.id, actor.name === SYSTEM_ACTOR.name ? withoutMentions(post) : post, { step: { action: outcome } });
     await this.endThreadOf(proposalId, actor.name, outcome);
     return decision;
@@ -9040,7 +9059,11 @@ runner.command("add <name>").description("Register a runner and print its token
 runner.command("list").description("List runners and what they offer").action(async () => {
   const board = await open3();
   const runners = await board.listRunners();
-  print(runners, () => runners.length === 0 ? "No runners yet; add one with `runner add <name>`." : runners.map((each) => `${each.name}  ${each.status}${each.paused === void 0 ? "" : "  paused"}  ${each.os}${each.version === void 0 ? "" : `  v${each.version}`}  ${each.clis.join(",") || "no CLIs yet"}${each.capabilities.length === 0 ? "" : `  ${each.capabilities.join(",")}`}${Object.keys(each.pausedClis ?? {}).map((cli) => `  ${cli} paused`).join("")}`).join("\n"));
+  const now = /* @__PURE__ */ new Date();
+  print(runners, () => runners.length === 0 ? "No runners yet; add one with `runner add <name>`." : runners.map((each) => `${each.name}  ${each.status}${each.paused === void 0 ? "" : "  paused"}  ${each.os}${each.version === void 0 ? "" : `  v${each.version}`}  ${each.clis.join(",") || "no CLIs yet"}${each.capabilities.length === 0 ? "" : `  ${each.capabilities.join(",")}`}${Object.keys(each.pausedClis ?? {}).map((cli) => `  ${cli} paused`).join("")}${each.clis.map((cli) => {
+    const hold = runnerLimitHold(each, cli, now);
+    return hold === null ? "" : `  ${cli} held until ${hold.until}`;
+  }).join("")}`).join("\n"));
 });
 for (const [verb, paused] of [
   ["pause", true],

package/dist/server/index.js

@@ -398,6 +398,21 @@ function quotaLevel(quota, now) {
   const high = quota.windows.some((window) => windowCurrent(window, now) && window.usedPercent !== null && window.usedPercent >= QUOTA_WARNING_PERCENT);
   return quota.status === "warning" || high ? "warning" : "ok";
 }
+var UNKNOWN_LIMIT_HOLD_MS = 30 * 6e4;
+function stopsTurns(quota) {
+  return quota.status === "limited" && !(quota.source === "read" && quota.extraUsage?.enabled === true);
+}
+function limitHold(quota, now) {
+  if (!stopsTurns(quota)) {
+    return null;
+  }
+  const known = quota.limitedUntil !== null;
+  const until = quota.limitedUntil ?? new Date(Date.parse(quota.observedAt) + UNKNOWN_LIMIT_HOLD_MS).toISOString();
+  return Date.parse(until) > now.getTime() ? { until, known } : null;
+}
+function limitLapsed(quota, now) {
+  return stopsTurns(quota) && quota.limitedUntil === null && limitHold(quota, now) === null;
+}
 var WINDOW_NAMES = {
   five_hour: "5h",
   seven_day: "7d",
@@ -751,12 +766,16 @@ var RunnerSchema = z5.object({
 function runnerPause(runner, cli) {
   return runner.paused ?? runner.pausedClis?.[cli];
 }
-function heldOn(runners2, runner, cli) {
+function runnerLimitHold(runner, cli, now) {
+  const quota = runner.quotas?.[cli];
+  return quota === void 0 ? null : limitHold(quota, now);
+}
+function heldOn(runners2, runner, cli, now) {
   if (runner === void 0 || cli === null) {
     return false;
   }
   const record = runners2.find((each) => each.name === runner);
-  return record !== void 0 && runnerPause(record, cli) !== void 0;
+  return record !== void 0 && (runnerPause(record, cli) !== void 0 || runnerLimitHold(record, cli, now) !== null);
 }
 var ProposalKindSchema = z5.enum([
   "role",
@@ -2467,7 +2486,7 @@ var RunnerConfigSchema = z13.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.4.0";
+var STELLARIS_VERSION = "0.4.1";
 
 // packages/shared/dist/mentions.js
 import { parse, postprocess, preprocess } from "micromark";
@@ -4086,8 +4105,10 @@ function plain(value) {
     return "";
   return JSON.stringify(value);
 }
-function sentence(summary) {
-  return summary.trim().replace(/\.+$/, "");
+var SENTENCE_END = /[.…?!]["'”’»)\]}*_]*$/u;
+function asSentence(text) {
+  const trimmed = text.trim();
+  return SENTENCE_END.test(trimmed) ? trimmed : `${trimmed}.`;
 }
 function skillSummary(data, body) {
   const description = data["description"];
@@ -5671,7 +5692,7 @@ ${current.body}`);
         name: args.name,
         reason: args.reason
       });
-      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${sentence(withoutMentions(args.reason))}. Every citizen's skills index stops listing it from its next turn.`);
+      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${asSentence(withoutMentions(args.reason))} Every citizen's skills index stops listing it from its next turn.`);
       return removed;
     });
   }
@@ -6741,7 +6762,7 @@ ${args.summary}`);
       });
       const thread = await this.openThreadUnlocked(actor.name, this.proposalThreadOpening(proposal));
       const rationale = args.rationale.trim();
-      await this.appendThreadMessage(actor.name, thread.id, `Proposal ${proposal.id}: ${describeCharter(proposal.kind, proposal.charter)}.${rationale.length === 0 ? "" : `
+      await this.appendThreadMessage(actor.name, thread.id, `Proposal ${proposal.id}: ${asSentence(describeCharter(proposal.kind, proposal.charter))}${rationale.length === 0 ? "" : `
 
 ${rationale}`}`);
       return proposal;
@@ -7445,7 +7466,7 @@ ${rationale}`}`);
       const ts = this.now().toISOString();
       const landed = current.onDone !== "none";
       if (landed) {
-        await this.postTaskNote(actor.name, current, input.ok ? `${sentence(input.detail)}.` : `Landing failed: ${sentence(input.detail)}. The task waits at its last stage for its participants to reshape the plan.`, input.ok ? { action: "landed", stage: current.stage, to: null } : { action: "reopened", stage: current.stage, to: current.stage });
+        await this.postTaskNote(actor.name, current, input.ok ? asSentence(input.detail) : `Landing failed: ${asSentence(input.detail)} The task waits at its last stage for its participants to reshape the plan.`, input.ok ? { action: "landed", stage: current.stage, to: null } : { action: "reopened", stage: current.stage, to: current.stage });
       }
       if (input.ok) {
         const task2 = await this.writeEndedTask(actor.name, location.project, {
@@ -7465,7 +7486,7 @@ ${rationale}`}`);
           await this.refreshMember(name);
         }
         if (landed) {
-          await this.appendMessage(actor.name, channelRef(location.project, task2.channel), `Task ${task2.id} "${task2.title}" is done: ${sentence(input.detail)}.`);
+          await this.appendMessage(actor.name, channelRef(location.project, task2.channel), `Task ${task2.id} "${task2.title}" is done: ${asSentence(input.detail)}`);
         }
         return task2;
       }
@@ -8176,7 +8197,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       files: taken.files.length,
       ...meta
     });
-    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill.name} ${replaced ? "updated in" : "promoted to"} the society: ${sentence(skill.summary)}. Every citizen's skills index now lists it.`);
+    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill.name} ${replaced ? "updated in" : "promoted to"} the society: ${asSentence(skill.summary)} Every citizen's skills index now lists it.`);
     return replaced;
   }
   /**
@@ -8423,7 +8444,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
     });
     const purpose = withoutMentions(input.purpose);
     await this.appendMessage(SYSTEM_ACTOR.name, ref, `Channel ${ref} opened: ${purpose}`);
-    await this.appendMessage(SYSTEM_ACTOR.name, channelRef(input.project, "general"), `Channel ${ref} opened by ${by}: ${purpose}. Subscribe to it to follow its posts; its tasks and mentions reach whoever they concern either way.`);
+    await this.appendMessage(SYSTEM_ACTOR.name, channelRef(input.project, "general"), `Channel ${ref} opened by ${by}: ${asSentence(purpose)} Subscribe to it to follow its posts; its tasks and mentions reach whoever they concern either way.`);
     return ref;
   }
   /**
@@ -8846,17 +8867,18 @@ ${charter.purpose}
     return kept > lease ? new Date(kept).toISOString() : null;
   }
   /**
-   * The lease a holder keeps while the user's pause holds its turns in the task's project
-   * (`heldOn`), when later than the one it has, else null. It is renewed for a full lease once less
-   * than half is left, as for a pending cron, so it never lapses while the holder cannot take a
-   * turn there, and after the resume the holder has at least half a lease to come back to it.
+   * The lease a holder keeps while the user's pause, or its CLI's limit, holds its turns in the
+   * task's project (`heldOn`), when later than the one it has, else null. It is renewed for a full
+   * lease once less than half is left, as for a pending cron, so it never lapses while the holder
+   * cannot take a turn there, and after the resume or the reset the holder has at least half a
+   * lease to come back to it.
    */
   async pausedLease(task, runners2, runner, now) {
     if (task.claimedBy === void 0 || task.leaseExpiresAt === void 0) {
       return null;
     }
     const holder = await this.readAgent(task.claimedBy).catch(() => null);
-    if (holder === null || !heldOn(runners2, runner, holder.cli)) {
+    if (holder === null || !heldOn(runners2, runner, holder.cli, now)) {
       return null;
     }
     const lease = Date.parse(task.leaseExpiresAt);
@@ -8947,9 +8969,9 @@ ${charter.purpose}
       });
     }
     const verdict = outcome === "approved" ? "Approved" : "Rejected";
-    const why = reason === void 0 ? "" : ` Reason: ${reason}.`;
+    const why = reason === void 0 ? "" : ` Reason: ${asSentence(reason)}`;
     const result = provision === void 0 ? "" : ` Provisioned: ${Object.entries(provision).map(([key, value]) => `${key} ${plain(value)}`).join(", ")}.`;
-    const post = `${verdict}: ${describeCharter(proposal.kind, proposal.charter)}.${why}${result}`;
+    const post = `${verdict}: ${asSentence(describeCharter(proposal.kind, proposal.charter))}${why}${result}`;
     await this.appendThreadMessage(actor.name, thread.id, actor.name === SYSTEM_ACTOR.name ? withoutMentions(post) : post, { step: { action: outcome } });
     await this.endThreadOf(proposalId, actor.name, outcome);
     return decision;
@@ -10501,7 +10523,7 @@ var Scheduler = class {
         }
         members ??= await this.board.projectMembers(project.slug);
         const takers = members.filter((member) => member.cli !== null && mayHoldStage(member, task));
-        if (takers.length > 0 && takers.every((taker) => heldOn(runners2, project.runner, taker.cli))) {
+        if (takers.length > 0 && takers.every((taker) => heldOn(runners2, project.runner, taker.cli, new Date(now)))) {
           this.state.waitingHeld[key] = iso(now);
           continue;
         }
@@ -10708,7 +10730,8 @@ var Scheduler = class {
           last = Math.max(last, Date.parse(ended));
         }
       }
-      const held = heldOn(runners2, agent.homeRunner, agent.cli) || projects.some((project) => agent.memberships.includes(project.slug) && heldOn(runners2, project.runner, agent.cli));
+      const at = new Date(now);
+      const held = heldOn(runners2, agent.homeRunner, agent.cli, at) || projects.some((project) => agent.memberships.includes(project.slug) && heldOn(runners2, project.runner, agent.cli, at));
       if (held) {
         this.state.idleHeld[agent.name] = iso(now);
       }
@@ -11227,7 +11250,11 @@ function runnerLine(runner, projects, now) {
   ].join(", ");
   const pauses = runner.clis.flatMap((cli) => {
     const pause = runner.pausedClis?.[cli];
-    return pause === void 0 ? [] : [`${cli} paused by the user since ${pause.at}`];
+    const hold = runnerLimitHold(runner, cli, now);
+    return [
+      ...pause === void 0 ? [] : [`${cli} paused by the user since ${pause.at}`],
+      ...hold === null ? [] : [`${cli} held by its limit until ${hold.until}`]
+    ];
   });
   const quotas = runner.clis.flatMap((cli) => {
     const quota = runner.quotas?.[cli];
@@ -11400,7 +11427,7 @@ function buildTurnPrompt(input) {
   }
   const machines = input.runners;
   if (machines !== void 0 && machines !== null) {
-    lines.push("", "## Runners", "", "The machines turns run on. A project lives on the runner that takes its first turn, one that offers every capability the project and that turn's task require, and moves only when the user moves it. A task's required_capabilities must name capabilities exactly as a runner below offers them; a task needing one its project's runner lacks waits. A runner's quota is what each CLI's login there last reported of its plan, in percent of each window; a CLI limited until a time fails its turns there until then. A runner, or a CLI on it, paused by the user starts none of the turns it would run until the user resumes it: they wait, and the stages their citizens hold keep their leases.", "");
+    lines.push("", "## Runners", "", "The machines turns run on. A project lives on the runner that takes its first turn, one that offers every capability the project and that turn's task require, and moves only when the user moves it. A task's required_capabilities must name capabilities exactly as a runner below offers them; a task needing one its project's runner lacks waits. A runner's quota is what each CLI's login there last reported of its plan, in percent of each window. A runner, or a CLI on it, paused by the user starts none of the turns it would run until the user resumes it, and a CLI held by its limit starts none of its turns there until the limit lifts, at the reset the CLI gave or, with none given, half an hour after the report: they wait, and the stages their citizens hold keep their leases.", "");
     if (machines.runners.length === 0) {
       lines.push("None registered yet.");
     }
@@ -12297,6 +12324,9 @@ var TurnHost = class {
 
 // packages/turn-host/dist/hub.js
 import { randomUUID as randomUUID2 } from "node:crypto";
+function receiptOverdue(seat) {
+  return [...seat.unacked.values()].some((each) => each.overdue);
+}
 var RunnerProtocolError = class extends Error {
 };
 var RunnerAwayError = class extends Error {
@@ -12341,6 +12371,13 @@ var RunnerHub = class {
   starting = /* @__PURE__ */ new Map();
   /** Moves started since the hub did, so a placement that a move overtook gives its turn back. */
   moveStarts = 0;
+  /** When each runner was last asked to read a CLI's quota for a limit with no reset, by `runner/cli`. */
+  limitReads = /* @__PURE__ */ new Map();
+  /**
+   * The turn let through once a limit with no reset had held its half hour, by `runner/cli`: the
+   * report it tries, which `observedAt` names, and whether the turn has ended.
+   */
+  limitTries = /* @__PURE__ */ new Map();
   constructor(options) {
     this.board = options.board;
     this.host = options.host;
@@ -12377,9 +12414,9 @@ var RunnerHub = class {
     if (hello.protocol !== RUNNER_PROTOCOL) {
       throw new RunnerProtocolError(`runner protocol ${hello.protocol} is not ${RUNNER_PROTOCOL}; upgrade the runner or the server`);
     }
-    const seat = this.seats.get(name);
+    let seat = this.seats.get(name);
     if (seat === void 0) {
-      this.seats.set(name, {
+      seat = {
         name,
         hello,
         send: null,
@@ -12387,19 +12424,18 @@ var RunnerHub = class {
         warm: /* @__PURE__ */ new Set(),
         disconnectedAt: null,
         grace: null,
-        unacked: /* @__PURE__ */ new Map(),
-        unconfirmed: false
-      });
+        unacked: /* @__PURE__ */ new Map()
+      };
+      this.seats.set(name, seat);
     } else {
       seat.hello = hello;
       seat.warm = /* @__PURE__ */ new Set();
     }
     const still = new Set(hello.turns);
-    const unacked = this.seats.get(name)?.unacked ?? /* @__PURE__ */ new Map();
     for (const turnId of this.host.turnsOn(name)) {
       if (still.has(turnId)) {
-        this.settle(unacked, turnId);
-      } else if (!unacked.has(turnId)) {
+        this.settle(seat, turnId);
+      } else if (!seat.unacked.has(turnId)) {
         await this.host.abortTurn(turnId, `runner ${name} restarted during the turn`);
       }
     }
@@ -12422,7 +12458,6 @@ var RunnerHub = class {
     }
     seat.send = send;
     seat.disconnectedAt = null;
-    seat.unconfirmed = false;
     if (seat.grace !== null) {
       clearTimeout(seat.grace);
       seat.grace = null;
@@ -12463,24 +12498,23 @@ var RunnerHub = class {
     }
     await Promise.allSettled(this.detaching);
   }
+  /** A turn's steps, which show its job arrived as its receipt would. */
   async turnEvents(runner, turnId, entries) {
     this.assertOwns(runner, turnId);
+    this.received(runner, turnId);
     await this.host.addEvents(turnId, entries);
   }
   /** A runner's word that a turn's job arrived, which also shows its stream delivers again. */
   received(runner, turnId) {
     const seat = this.seats.get(runner);
-    if (seat === void 0 || !seat.unacked.has(turnId)) {
-      return;
-    }
-    this.settle(seat.unacked, turnId);
-    if (seat.unconfirmed) {
-      seat.unconfirmed = false;
-      this.log.info({ runner }, "runner is taking jobs again");
+    if (seat !== void 0) {
+      this.settle(seat, turnId);
     }
   }
+  /** A turn's outcome, which shows its job arrived as its receipt would. */
   async turnOutcome(runner, turnId, outcome) {
     this.assertOwns(runner, turnId);
+    this.received(runner, turnId);
     const ack = await this.host.closeTurn(turnId, outcome);
     return ack ?? { dropWorkspace: false };
   }
@@ -12625,8 +12659,10 @@ var RunnerHub = class {
     }
     const cli = agent.cli;
     const runners2 = await this.board.listRunners();
-    const free = (seat) => seat.send !== null && !seat.unconfirmed && seat.hello.clis.includes(cli) && (seat.hello.slots === null || seat.inUse < seat.hello.slots) && !heldOn(runners2, seat.name, cli);
+    const now = this.now();
+    const free = (seat) => seat.send !== null && !receiptOverdue(seat) && seat.hello.clis.includes(cli) && (seat.hello.slots === null || seat.inUse < seat.hello.slots) && !heldOn(runners2, seat.name, cli, now) && !this.tryRunning(runners2, seat.name, cli, now);
     let chosen;
+    let waitsOn = agent.homeRunner;
     if (dispatch.project === SOCIETY_SCOPE) {
       chosen = await this.pinnedSeat(agent.name, agent.homeRunner, cli, free);
     } else {
@@ -12655,8 +12691,12 @@ var RunnerHub = class {
       }
       const seat = this.seats.get(home);
       chosen = seat !== void 0 && free(seat) ? seat : void 0;
+      waitsOn = home;
     }
     if (chosen === void 0) {
+      if (waitsOn !== void 0) {
+        this.readAfterLimit(runners2, waitsOn, cli, now);
+      }
       return null;
     }
     if (dispatch.project !== SOCIETY_SCOPE && (this.moving.has(dispatch.project) || this.moveStarts !== starts)) {
@@ -12666,7 +12706,17 @@ var RunnerHub = class {
     if (dispatch.project !== SOCIETY_SCOPE) {
       this.starting.set(dispatch.project, (this.starting.get(dispatch.project) ?? 0) + 1);
     }
-    return { runner: chosen.name };
+    const runner = chosen.name;
+    const lapsed = runners2.find((each) => each.name === runner)?.quotas?.[cli];
+    const tried = this.limitTries.get(`${runner}/${cli}`);
+    if (lapsed !== void 0 && limitLapsed(lapsed, now) && tried?.observedAt !== lapsed.observedAt) {
+      this.limitTries.set(`${runner}/${cli}`, {
+        observedAt: lapsed.observedAt,
+        dispatch,
+        ended: false
+      });
+    }
+    return { runner };
   }
   async runTurn(dispatch, assignment) {
     if ("refused" in assignment) {
@@ -12703,10 +12753,15 @@ var RunnerHub = class {
       return await opened.ended;
     } finally {
       opening();
+      for (const tried of this.limitTries.values()) {
+        if (tried.dispatch === dispatch) {
+          tried.ended = true;
+        }
+      }
       if (seat !== void 0) {
         seat.inUse = Math.max(0, seat.inUse - 1);
         if (turnId !== null) {
-          this.settle(seat.unacked, turnId);
+          this.settle(seat, turnId);
         }
       }
     }
@@ -13096,6 +13151,40 @@ var RunnerHub = class {
     await this.board.recordQuota(runner, cli, quota);
     return quota;
   }
+  /**
+   * Whether a turn let through to try a limit with no reset, once its hold ran out, is still running
+   * on the runner, so the CLI's other turns there wait for what it reports: a refusal records a newer
+   * limit, which holds them another half hour, and a turn that ends without one lets them go.
+   */
+  tryRunning(runners2, name, cli, now) {
+    const quota = runners2.find((each) => each.name === name)?.quotas?.[cli];
+    const tried = this.limitTries.get(`${name}/${cli}`);
+    return quota !== void 0 && tried !== void 0 && !tried.ended && tried.observedAt === quota.observedAt && limitLapsed(quota, now);
+  }
+  /**
+   * Asks a runner to read a CLI's quota again while a limit it gave no reset for holds a turn
+   * waiting for it there, at most once per `UNKNOWN_LIMIT_HOLD_MS` for each runner and CLI, so a
+   * reset the read names becomes the hold and a clear read lifts it. Not while the user's pause
+   * holds the CLI there too, nor on a runner from before quota reads; a read that fails changes
+   * nothing, and the hold runs out as it would have.
+   */
+  readAfterLimit(runners2, name, cli, now) {
+    const record = runners2.find((each) => each.name === name);
+    const seat = this.seats.get(name);
+    if (record === void 0 || seat === void 0 || seat.send === null || !seat.hello.quotaReads || !seat.hello.clis.includes(cli) || runnerPause(record, cli) !== void 0 || runnerLimitHold(record, cli, now)?.known !== false) {
+      return;
+    }
+    const key = `${name}/${cli}`;
+    const last = this.limitReads.get(key);
+    if (last !== void 0 && now.getTime() - last < UNKNOWN_LIMIT_HOLD_MS) {
+      return;
+    }
+    this.limitReads.set(key, now.getTime());
+    this.log.info({ runner: name, cli }, "reading a quota limited until an unknown time");
+    this.quota(name, cli).catch((error) => {
+      this.log.warn({ runner: name, cli, error: String(error) }, "could not read a limited quota");
+    });
+  }
   /** Calls `listener` whenever a runner registers, connects, or goes away. */
   onRunnerChange(listener) {
     this.runnerListeners.add(listener);
@@ -13109,29 +13198,41 @@ var RunnerHub = class {
   /**
    * Waits for a runner to acknowledge a job. One that does not in time may be behind a stream that
    * looks open but delivers nothing, as when its machine's network stops passing traffic, so no
-   * more turns go to it until it acknowledges or connects again; the turns it has carry on, since
-   * they report by posts.
+   * more turns go to it until the job is acknowledged, its turn ends, or the runner connects again;
+   * the turns it has carry on, since they report by posts.
    */
   expectAck(seat, job) {
     const previous = seat.unacked.get(job.turnId);
     if (previous !== void 0) {
       clearTimeout(previous.timer);
     }
-    const timer = setTimeout(() => {
-      if (!seat.unacked.has(job.turnId) || seat.unconfirmed || seat.send === null) {
-        return;
-      }
-      seat.unconfirmed = true;
-      this.log.warn({ runner: seat.name, turnId: job.turnId, waitedMs: this.ackTimeoutMs }, "runner has not acknowledged a job; no more turns go to it until it does or reconnects");
-    }, this.ackTimeoutMs);
-    timer.unref?.();
-    seat.unacked.set(job.turnId, { job, timer });
-  }
-  settle(unacked, turnId) {
-    const entry = unacked.get(turnId);
-    if (entry !== void 0) {
-      clearTimeout(entry.timer);
-      unacked.delete(turnId);
+    const entry = {
+      job,
+      timer: setTimeout(() => {
+        if (seat.unacked.get(job.turnId) !== entry || seat.send === null) {
+          return;
+        }
+        const wasHeld = receiptOverdue(seat);
+        entry.overdue = true;
+        if (!wasHeld) {
+          this.log.warn({ runner: seat.name, turnId: job.turnId, waitedMs: this.ackTimeoutMs }, "runner has not acknowledged a job; no more turns go to it until it does, the turn ends, or it reconnects");
+        }
+      }, this.ackTimeoutMs),
+      overdue: false
+    };
+    entry.timer.unref?.();
+    seat.unacked.set(job.turnId, entry);
+  }
+  /** A job acknowledged, or its turn over: the hold it put on its runner, if any, goes with it. */
+  settle(seat, turnId) {
+    const entry = seat.unacked.get(turnId);
+    if (entry === void 0) {
+      return;
+    }
+    clearTimeout(entry.timer);
+    seat.unacked.delete(turnId);
+    if (entry.overdue && !receiptOverdue(seat)) {
+      this.log.info({ runner: seat.name }, "runner is taking jobs again");
     }
   }
   async detach(seat) {

package/package.json

@@ -8,7 +8,7 @@
     "codex",
     "multi-agent"
   ],
-  "version": "0.4.0",
+  "version": "0.4.1",
   "license": "MIT",
   "homepage": "https://github.com/kr4t0n/stellaris",
   "repository": {

package/web/dist/assets/BackLink-fxPmFUg8.js

@@ -0,0 +1 @@
+import{Jn as e,S as t,tn as n}from"./format-BYF63sQU.js";import{O as r,n as i,r as a,t as o,v as s}from"./index-CyROMh25.js";var c=e(),l=`grid size-7 shrink-0 place-items-center rounded-lg text-fg-tertiary hover:bg-surface-2/70 hover:text-fg-primary`;function u({fallback:e}){let u=n(),d=r({select:e=>e.location.state.__TSR_index}),f=a(),p=s(),m=t(),h=i(f,d);if(h===null)return e;let g=o(h,{entity:e=>p.get(e)?.title,project:e=>m.data?.find(t=>t.slug===e)?.name});return(0,c.jsx)(`button`,{type:`button`,onClick:()=>u.history.back(),"aria-label":`Back to ${g}`,title:`Back to ${g}`,className:l,children:`←`})}export{u as t};

package/web/dist/assets/Button-DxGzriWQ.js

@@ -0,0 +1 @@
+import{An as e,Bn as t,In as n,Jn as r,Mn as i,Pn as a,Qn as o,Un as s,Wn as c,Yn as l,kn as u,qn as d}from"./format-BYF63sQU.js";var f=class extends u{#e;#t;#n;#r;constructor(e){super(),this.#e=e.client,this.mutationId=e.mutationId,this.#n=e.mutationCache,this.#t=[],this.state=e.state||p(),this.setOptions(e.options),this.scheduleGc()}setOptions(e){this.options=e,this.updateGcTime(this.options.gcTime)}get meta(){return this.options.meta}addObserver(e){this.#t.includes(e)||(this.#t.push(e),this.clearGcTimeout(),this.#n.notify({type:`observerAdded`,mutation:this,observer:e}))}removeObserver(e){this.#t=this.#t.filter(t=>t!==e),this.scheduleGc(),this.#n.notify({type:`observerRemoved`,mutation:this,observer:e})}optionalRemove(){this.#t.length||(this.state.status===`pending`?this.scheduleGc():this.#n.remove(this))}continue(){return this.#r?.continue()??(this.state.status===`pending`?this.execute(this.state.variables):Promise.resolve())}async execute(t){let n=()=>{this.#i({type:`continue`})},r={client:this.#e,meta:this.options.meta,mutationKey:this.options.mutationKey},i=this.#r=e({fn:()=>this.options.mutationFn?this.options.mutationFn(t,r):Promise.reject(Error(`No mutationFn found`)),onFail:(e,t)=>{this.#i({type:`failed`,failureCount:e,error:t})},onPause:()=>{this.#i({type:`pause`})},onContinue:n,retry:this.options.retry??0,retryDelay:this.options.retryDelay,networkMode:this.options.networkMode,canRun:()=>this.#n.canRun(this)}),a=this.state.status===`pending`,o=!i.canStart();try{if(a)n();else{this.#i({type:`pending`,variables:t,isPaused:o}),this.#n.config.onMutate&&await this.#n.config.onMutate(t,this,r);let e=await this.options.onMutate?.(t,r);e!==this.state.context&&this.#i({type:`pending`,context:e,variables:t,isPaused:o})}let e=await i.start();return await this.#n.config.onSuccess?.(e,t,this.state.context,this,r),await this.options.onSuccess?.(e,t,this.state.context,r),await this.#n.config.onSettled?.(e,null,this.state.variables,this.state.context,this,r),await this.options.onSettled?.(e,null,t,this.state.context,r),this.#i({type:`success`,data:e}),e}catch(e){try{await this.#n.config.onError?.(e,t,this.state.context,this,r)}catch(e){Promise.reject(e)}try{await this.options.onError?.(e,t,this.state.context,r)}catch(e){Promise.reject(e)}try{await this.#n.config.onSettled?.(void 0,e,this.state.variables,this.state.context,this,r)}catch(e){Promise.reject(e)}try{await this.options.onSettled?.(void 0,e,t,this.state.context,r)}catch(e){Promise.reject(e)}throw this.#i({type:`error`,error:e}),e}finally{this.#r===i&&(this.#r=void 0),this.#n.runNext(this)}}#i(e){let t=t=>{switch(e.type){case`failed`:return{...t,failureCount:e.failureCount,failureReason:e.error};case`pause`:return{...t,isPaused:!0};case`continue`:return{...t,isPaused:!1};case`pending`:return{...t,context:e.context,data:void 0,failureCount:0,failureReason:null,error:null,isPaused:e.isPaused,status:`pending`,variables:e.variables,submittedAt:Date.now()};case`success`:return{...t,data:e.data,failureCount:0,failureReason:null,error:null,status:`success`,isPaused:!1};case`error`:return{...t,data:void 0,error:e.error,failureCount:t.failureCount+1,failureReason:e.error,isPaused:!1,status:`error`}}};this.state=t(this.state),i.batch(()=>{this.#t.forEach(t=>{t.onMutationUpdate(e)}),this.#n.notify({mutation:this,type:`updated`,action:e})})}};function p(){return{context:void 0,data:void 0,error:null,failureCount:0,failureReason:null,isPaused:!1,status:`idle`,variables:void 0,submittedAt:0}}var m=class extends a{#e;#t=void 0;#n;#r;constructor(e,t){super(),this.#e=e,this.setOptions(t),this.bindMethods(),this.#i()}bindMethods(){this.mutate=this.mutate.bind(this),this.reset=this.reset.bind(this)}setOptions(e){let t=this.options;this.options=this.#e.defaultMutationOptions(e),s(this.options,t)||this.#e.getMutationCache().notify({type:`observerOptionsUpdated`,mutation:this.#n,observer:this}),t?.mutationKey&&this.options.mutationKey&&n(t.mutationKey)!==n(this.options.mutationKey)?this.reset():this.#n?.state.status===`pending`&&this.#n.setOptions(this.options)}onSubscribe(){this.listeners.size===1&&this.#n&&(this.#n.addObserver(this),this.#i())}onUnsubscribe(){this.hasListeners()||this.#n?.removeObserver(this)}onMutationUpdate(e){this.#i(),this.#a(e)}getCurrentResult(){return this.#t}reset(){this.#n?.removeObserver(this),this.#n=void 0,this.#i(),this.#a()}mutate(e,t){return this.#r=t,this.#n?.removeObserver(this),this.#n=this.#e.getMutationCache().build(this.#e,this.options),this.#n.addObserver(this),this.#n.execute(e)}#i(){let e=this.#n?.state??p();this.#t={...e,isPending:e.status===`pending`,isSuccess:e.status===`success`,isError:e.status===`error`,isIdle:e.status===`idle`,mutate:this.mutate,reset:this.reset}}#a(e){i.batch(()=>{if(this.#r&&this.hasListeners()){let t=this.#t.variables,n=this.#t.context,r={client:this.#e,meta:this.options.meta,mutationKey:this.options.mutationKey};if(e?.type===`success`){try{this.#r.onSuccess?.(e.data,t,n,r)}catch(e){Promise.reject(e)}try{this.#r.onSettled?.(e.data,null,t,n,r)}catch(e){Promise.reject(e)}}else if(e?.type===`error`){try{this.#r.onError?.(e.error,t,n,r)}catch(e){Promise.reject(e)}try{this.#r.onSettled?.(void 0,e.error,t,n,r)}catch(e){Promise.reject(e)}}}this.listeners.forEach(e=>{e(this.#t)})})}},h=o(l(),1);function g(e,n){let r=d(n),[a]=h.useState(()=>new m(r,e));h.useEffect(()=>{a.setOptions(e)},[a,e]);let o=h.useSyncExternalStore(h.useCallback(e=>a.subscribe(i.batchCalls(e)),[a]),()=>a.getCurrentResult(),()=>a.getCurrentResult()),s=h.useCallback((...e)=>{a.mutate(e[0],e[1]).catch(t)},[a]);if(o.error&&c(a.options.throwOnError,[o.error]))throw o.error;return{...o,mutate:s,mutateAsync:o.mutate}}var _=r(),v={primary:`bg-fg-primary font-medium text-surface-0 hover:bg-white`,ghost:`text-fg-tertiary hover:bg-surface-2/70 hover:text-fg-primary`};function y({variant:e=`ghost`,className:t=``,...n}){return(0,_.jsx)(`button`,{type:`button`,...n,className:`inline-flex h-7 shrink-0 items-center rounded-md px-3 text-xs transition-colors focus-visible:ring-2 focus-visible:ring-fg-primary/30 focus-visible:outline-none disabled:pointer-events-none disabled:opacity-40 ${v[e]} ${t}`})}export{g as n,f as r,y as t};

package/web/dist/assets/ChannelForms-C3m4IPnZ.js

@@ -0,0 +1 @@
+import{$t as e,Jn as t,Qn as n,Yn as r,j as i,qn as a,t as o}from"./format-BYF63sQU.js";import{n as s,t as c}from"./Button-DxGzriWQ.js";import{l}from"./compose-CV4o6TMb.js";import{n as u,r as d}from"./ThreadForms-CbFClyd0.js";var f=n(r(),1),p=t();function m({project:e,onDone:t}){let{api:n}=i(),r=a(),o=l(),[m,h]=(0,f.useState)(``),[g,_]=(0,f.useState)(``),v=(0,f.useRef)(null);(0,f.useEffect)(()=>v.current?.focus(),[]);let y=s({mutationFn:()=>n.createChannel({project:e,name:m.trim(),purpose:g.trim()}),onSuccess:async e=>{await r.invalidateQueries({queryKey:[`channels`]}),t(),await o({to:`/c/$`,params:{_splat:e}})}});return(0,p.jsxs)(`form`,{"aria-label":`New channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),y.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`div`,{className:`w-40 shrink-0`,children:(0,p.jsx)(`input`,{ref:v,value:m,maxLength:64,spellCheck:!1,"aria-label":`Channel name`,placeholder:`release-0-4`,onChange:e=>h(e.target.value),className:`${u} font-mono`})}),(0,p.jsx)(`input`,{value:g,"aria-label":`Purpose`,placeholder:`What the channel is for`,onChange:e=>_(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(c,{onClick:t,children:`Cancel`}),(0,p.jsx)(c,{variant:`primary`,type:`submit`,disabled:y.isPending||m.trim()===``||g.trim()===``,children:y.isPending?`Opening…`:`Open`})]}),(0,p.jsx)(d,{error:y.error})]})}function h({channel:e,onDone:t}){let{api:n}=i(),r=a(),[o,l]=(0,f.useState)(``),m=s({mutationFn:()=>n.archiveChannel({channel:e,reason:o.trim()}),onSuccess:async()=>{await r.invalidateQueries({queryKey:[`channels`]}),t()}});return(0,p.jsxs)(`form`,{"aria-label":`Archive the channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),m.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`input`,{value:o,"aria-label":`Reason`,placeholder:`Why its work is done`,onChange:e=>l(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(c,{onClick:t,children:`Cancel`}),(0,p.jsx)(c,{variant:`primary`,type:`submit`,disabled:m.isPending||o.trim()===``,children:m.isPending?`Archiving…`:`Archive channel`})]}),(0,p.jsx)(d,{error:m.error})]})}function g({channels:t,now:n}){return t.length===0?(0,p.jsx)(`p`,{className:`text-meta`,children:`No channels.`}):(0,p.jsx)(`ul`,{className:`space-y-1`,children:t.map(t=>(0,p.jsxs)(`li`,{children:[(0,p.jsxs)(e,{to:`/c/$`,params:{_splat:t.ref},className:`text-sm hover:text-fg-primary ${t.archived===void 0?`text-fg-secondary`:`text-fg-tertiary`}`,children:[`# `,t.name]}),(0,p.jsxs)(`span`,{className:`text-meta`,children:[` `,`· `,t.messages,` messages`,t.archived===void 0?``:` · archived ${o(t.archived.at,n)}`]})]},t.ref))})}export{g as n,m as r,h as t};