ai-agentmanager 1.2.1 → 1.3.0

package/public/setup.js

@@ -0,0 +1,67 @@
+// Getting started: shown where an agent's details go while none is selected, until every step
+// is done or it is hidden. Steps open the dialog that does them.
+
+const STEPS = [
+  ['agent', 'Start your first agent', 'Give it a request and a repo or folder; it works in its own branch.', '#new-btn', 'New agents'],
+  ['alerts', 'Get Slack alerts', 'Hear when an agent needs you, is stuck or finished.', '#alerts-btn', 'Alerts'],
+  ['assistant', 'Let work come to you', 'The assistant, or triggers (a GitHub label, a webhook), start agents for new work.', '#assistant-btn', 'Assistant'],
+  ['remote', 'Use it from your phone', 'Answer agents from anywhere on your network.', '#remote-btn', 'Remote access'],
+  ['budget', 'Set a budget', 'An alert at 80% of an agent budget, and a daily limit.', '#spend-btn', 'Results'],
+];
+
+export function initSetup({ api, esc, $ }) {
+  const el = $('#placeholder');
+  const plain = el.innerHTML;
+  let data = null;
+  const hidden = () => {
+    try {
+      return localStorage.getItem('agentmgr.setupHidden') === '1';
+    } catch {
+      return false;
+    }
+  };
+
+  function render() {
+    if (!data || hidden()) {
+      el.innerHTML = plain;
+      return;
+    }
+    const done = STEPS.filter(([k]) => data.steps[k]).length;
+    if (done === STEPS.length && !data.checks.length) {
+      el.innerHTML = plain;
+      return;
+    }
+    el.innerHTML = `<div class="setup">
+      <div class="setup-head"><h3>Getting started</h3><span class="hint">${done} of ${STEPS.length} done</span><span class="spacer"></span><button class="link" data-setup-hide>Hide</button></div>
+      ${data.checks.length ? `<div class="setup-checks">${data.checks.map((c) => `<div class="setup-check ${c.status}"><b>${esc(c.name)}</b>: ${esc(c.detail)}${c.fix ? `<div class="hint">${esc(c.fix)}</div>` : ''}</div>`).join('')}</div>` : ''}
+      <ol class="setup-steps">${STEPS.map(([k, title, why, btn, label]) => `<li class="${data.steps[k] ? 'done' : ''}">
+        <span class="setup-mark">${data.steps[k] ? '✓' : ''}</span>
+        <div><b>${title}</b><div class="hint">${why}</div></div>
+        ${data.steps[k] ? '' : `<button class="small" data-setup-open="${btn}">${label}</button>`}</li>`).join('')}</ol>
+      <p class="hint">${plain}</p>
+    </div>`;
+  }
+
+  el.addEventListener('click', (e) => {
+    const open = e.target.closest('[data-setup-open]');
+    if (open) return document.querySelector(open.dataset.setupOpen)?.click();
+    if (e.target.closest('[data-setup-hide]')) {
+      try {
+        localStorage.setItem('agentmgr.setupHidden', '1');
+      } catch {}
+      render();
+    }
+  });
+
+  async function load() {
+    try {
+      data = await api('GET', '/setup');
+    } catch {
+      data = null;
+    }
+    render();
+  }
+  load();
+  window.addEventListener('focus', () => !hidden() && load());
+  return { load };
+}

package/public/spend.js

@@ -0,0 +1,82 @@
+// Spend dialog: today's cost, the last two weeks, the costliest agents, and the limits.
+
+export function initSpend({ api, esc, toast, $ }) {
+  const dlg = $('#spend-dialog');
+  const f = $('#spend-form');
+  const money = (n) => `$${Number(n ?? 0).toFixed(2)}`;
+
+  function fill(b) {
+    $('#spend-today').textContent = b.today.total ? money(b.today.total) : '';
+    if (!dlg.open) return;
+    f.perAgentUsd.value = b.perAgentUsd ?? '';
+    f.perDayUsd.value = b.perDayUsd ?? '';
+    const max = Math.max(...b.days.map((d) => d.total), 0.01);
+    $('#spend-summary').innerHTML = `
+      <p class="spend-big">${money(b.today.total)} <span class="hint">today${b.perDayUsd ? ` of ${money(b.perDayUsd)}` : ''}</span></p>
+      ${b.days.length > 1 ? `<div class="spend-bars" title="The last two weeks">${[...b.days].reverse().map((d) => `<span style="height:${Math.max(2, Math.round((d.total / max) * 40))}px" title="${esc(d.day)}: ${money(d.total)}"></span>`).join('')}</div>` : ''}`;
+    $('#spend-agents').innerHTML = b.agents.length
+      ? `<table class="spend-table"><tr><th>Agent</th><th>Spent</th><th>Today</th><th>Budget</th></tr>${b.agents.map((a) => `<tr class="${a.hit ? 'over' : ''}">
+          <td><a href="#${a.id}">${esc(a.name)}</a></td><td>${money(a.cost)}</td><td>${a.today ? money(a.today) : ''}</td>
+          <td>${a.limit ? `${money(a.limit)}${a.own ? '' : ' <span class="hint">default</span>'}${a.hit ? ' <span class="tag fail">reached</span>' : ''}` : '—'}</td></tr>`).join('')}</table>`
+      : '<p class="hint">No costs recorded yet.</p>';
+    $('#spend-note').textContent = b.note;
+  }
+
+  const hours = (h) => (h == null ? '—' : h < 1 ? `${Math.round(h * 60)} min` : h < 48 ? `${h.toFixed(1)} h` : `${(h / 24).toFixed(1)} days`);
+  const pct = (r) => (r == null ? '—' : `${Math.round(r * 100)}%`);
+
+  function table(title, rows) {
+    if (!rows.length) return '';
+    return `<details class="stats-table" ${title === 'By engine and model' ? 'open' : ''}><summary>${title}</summary><table class="spend-table">
+      <tr><th></th><th>Agents</th><th>Merged</th><th>Merge rate</th><th>To PR</th><th>Cost / merged</th></tr>
+      ${rows.map((r) => `<tr><td>${esc(r.key)}</td><td>${r.agents}</td><td>${r.merged}</td><td>${pct(r.mergeRate)}</td><td>${hours(r.medianHoursToPr)}</td><td>${r.costPerMerged == null ? '—' : money(r.costPerMerged)}</td></tr>`).join('')}
+    </table></details>`;
+  }
+
+  function fillStats(st) {
+    const t = st.total;
+    const kpi = (label, value, hint = '') => `<div class="kpi"><div class="kpi-v">${value}</div><div class="kpi-l">${label}</div>${hint ? `<div class="hint">${hint}</div>` : ''}</div>`;
+    $('#stats-body').innerHTML = t.agents
+      ? `<div class="kpis">
+          ${kpi('agents', t.agents, `${t.withPr} opened a PR`)}
+          ${kpi('PRs merged', t.merged, `${t.open} open, ${t.closed} closed`)}
+          ${kpi('merge rate', pct(t.mergeRate), 'of PRs merged or closed')}
+          ${kpi('to first PR', hours(t.medianHoursToPr), 'median')}
+          ${kpi('to merge', hours(t.medianHoursToMerge), 'median')}
+          ${kpi('per merged PR', t.costPerMerged == null ? '—' : money(t.costPerMerged), `${money(t.cost)} in all`)}
+        </div>
+        ${table('By engine and model', st.byEngine)}${table('By where they came from', st.bySource)}${table('By project', st.byProject)}`
+      : '<p class="hint">No agents in this period.</p>';
+  }
+
+  async function refresh() {
+    try {
+      fill(await api('GET', '/budgets'));
+      if (dlg.open) fillStats(await api('GET', `/stats?days=${$('#stats-days').value}`));
+    } catch {}
+  }
+  $('#stats-days').onchange = () => refresh();
+
+  $('#spend-btn').onclick = async () => {
+    $('#spend-error').hidden = true;
+    dlg.showModal();
+    await refresh();
+  };
+  $('#spend-close').onclick = () => dlg.close();
+  f.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    try {
+      fill(await api('PUT', '/budgets', { perAgentUsd: f.perAgentUsd.value || null, perDayUsd: f.perDayUsd.value || null }));
+      toast('Limits saved');
+    } catch (err) {
+      $('#spend-error').hidden = false;
+      $('#spend-error').textContent = err.message;
+    }
+  });
+  dlg.addEventListener('click', (e) => {
+    if (e.target.closest('a[href^="#"]')) dlg.close();
+  });
+  refresh();
+  setInterval(refresh, 120_000);
+  return { refresh };
+}

package/public/style.css

@@ -625,3 +625,107 @@ pre.diff .meta { color: var(--muted); font-weight: 600; }
 .team-quest { border: 1px solid var(--border); border-radius: 6px; padding: 6px 10px; }
 .team-quest summary { cursor: pointer; }
 .team-quest .team-timeline { margin-top: 8px; }
+
+/* Review changes */
+.review-dialog { width: min(1400px, calc(100vw - 24px)); height: calc(100vh - 32px); max-height: none; }
+.review-body { flex: 1; min-height: 0; display: flex; flex-direction: column; gap: 8px; padding: 8px 18px 14px; }
+.rv-summary { display: flex; flex-wrap: wrap; gap: 6px 14px; align-items: center; font-size: 13px; }
+.rv-warn { margin: 0; color: var(--yellow); }
+.rv-add { color: var(--green); font-family: var(--mono); font-size: 12px; }
+.rv-del { color: var(--red); font-family: var(--mono); font-size: 12px; }
+.rv-main { flex: 1; min-height: 0; display: grid; grid-template-columns: 240px 1fr; gap: 10px; }
+.rv-files { overflow-y: auto; border: 1px solid var(--border); border-radius: 6px; padding: 4px; font-size: 12px; }
+.rv-files a { display: grid; grid-template-columns: 1fr auto; padding: 4px 6px; border-radius: 4px; color: var(--text); text-decoration: none; }
+.rv-files a:hover { background: var(--panel-2); }
+.rv-fname { font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.rv-fdir { grid-column: 1; color: var(--muted); font-size: 11px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.rv-fstat { grid-column: 2; grid-row: 1 / span 2; align-self: center; white-space: nowrap; }
+.rv-commits { margin: 8px 4px 2px; color: var(--muted); }
+.rv-commits div { padding: 2px 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.rv-diffs { overflow: auto; display: flex; flex-direction: column; gap: 10px; }
+.rv-file { border: 1px solid var(--border); border-radius: 6px; }
+.rv-file-head { position: sticky; top: 0; z-index: 1; display: flex; gap: 6px; align-items: center; padding: 6px 10px; background: var(--panel-2); border-radius: 6px 6px 0 0; cursor: pointer; font-size: 13px; }
+.rv-caret { color: var(--muted); width: 10px; }
+.tag.rv-added { color: var(--green); }
+.tag.rv-deleted { color: var(--red); }
+.rv-pad { padding: 8px 10px; margin: 0; }
+.rv-table { width: 100%; border-collapse: collapse; font: 12px/1.5 var(--mono); }
+.rv-table td { padding: 0 6px; vertical-align: top; }
+.rv-no { width: 1%; min-width: 38px; text-align: right; color: var(--muted); user-select: none; cursor: pointer; position: relative; white-space: nowrap; }
+.rv-code { white-space: pre-wrap; word-break: break-word; }
+.rv-sign { display: inline-block; width: 1.2em; color: var(--muted); user-select: none; }
+tr.rv-add td.rv-code, tr.rv-add td.rv-no { background: color-mix(in srgb, var(--green) 12%, transparent); }
+tr.rv-del td.rv-code, tr.rv-del td.rv-no { background: color-mix(in srgb, var(--red) 12%, transparent); }
+tr.rv-hunk td { color: var(--accent); background: color-mix(in srgb, var(--accent) 7%, transparent); padding: 2px 8px; }
+.rv-plus { display: none; position: absolute; left: 2px; top: 1px; padding: 0 5px; font-size: 11px; line-height: 16px; border-radius: 3px; background: var(--accent); color: var(--accent-text); border: 0; cursor: pointer; }
+tr[data-rv-line]:hover .rv-plus { display: inline-block; }
+@media (hover: none) { .rv-plus { display: inline-block; opacity: .6; } }
+tr.rv-note td { padding: 6px 10px; background: var(--panel); font-family: inherit; }
+.rv-comment { display: flex; gap: 8px; align-items: flex-start; border-left: 3px solid var(--accent); padding: 4px 8px; background: var(--panel-2); border-radius: 4px; font: 13px/1.45 system-ui, sans-serif; }
+.rv-comment-text { white-space: pre-wrap; }
+.rv-form textarea { width: 100%; font: 13px/1.45 system-ui, sans-serif; }
+.rv-form-actions, .rv-row { display: flex; gap: 6px; align-items: center; margin-top: 4px; }
+.rv-actions { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; border-top: 1px solid var(--border); padding-top: 8px; }
+.rv-send textarea { width: 100%; }
+.rv-general { display: flex; flex-direction: column; gap: 4px; margin-bottom: 4px; }
+.rv-land input:not([type]) { flex: 1; min-width: 0; }
+.d-actions .count { font-size: 11px; padding: 0 5px; border-radius: 8px; background: var(--accent); color: var(--accent-text); }
+@media (max-width: 760px) {
+  .rv-main { grid-template-columns: 1fr; }
+  .rv-files { max-height: 120px; }
+  .rv-actions { grid-template-columns: 1fr; }
+}
+.rv-land .check { display: inline-flex; gap: 4px; align-items: center; white-space: nowrap; margin: 0; }
+
+/* Land tab */
+.land-row { cursor: default; }
+.land-row .name { white-space: normal; color: var(--text); text-decoration: none; font-weight: 600; }
+.land-row .name:hover { text-decoration: underline; }
+.land-chips { display: flex; flex-wrap: wrap; gap: 4px; margin: 4px 0; }
+.tag.fail { color: var(--red); }
+.badge.ready { background: var(--green); color: #fff; border-color: var(--green); }
+.land-empty { padding: 10px 14px; }
+.land-settings { padding: 8px 14px 14px; font-size: 13px; }
+.land-settings summary { cursor: pointer; color: var(--muted); margin-bottom: 6px; }
+.land-settings label { display: flex; gap: 6px; align-items: center; margin: 4px 0; }
+.land-settings input[type="number"] { width: 56px; }
+.land-settings select { width: auto; }
+.links li:has(.pr-chips) { flex-wrap: wrap; }
+.pr-chips { flex-basis: 100%; display: flex; flex-wrap: wrap; gap: 4px; padding-left: 2px; }
+.land-settings input[type="checkbox"] { width: auto; flex: none; margin: 0; }
+input.inline { display: inline-block; width: 80px; padding: 1px 4px; }
+#triggers-newtoken { width: auto; justify-self: start; align-self: flex-start; }
+.trig-recent { margin: 4px 0 0; padding-left: 18px; }
+.spend-today:empty { display: none; }
+.spend-today { font-size: 11px; color: var(--muted); margin-left: 2px; }
+.spend-big { font-size: 22px; font-weight: 700; margin: 0 0 6px; }
+.spend-bars { display: flex; align-items: flex-end; gap: 3px; height: 42px; margin-bottom: 8px; }
+.spend-bars span { width: 12px; background: var(--accent); border-radius: 2px 2px 0 0; opacity: .8; }
+.spend-table { width: 100%; border-collapse: collapse; font-size: 13px; }
+.spend-table th, .spend-table td { text-align: left; padding: 3px 6px; border-bottom: 1px solid var(--border); }
+.spend-table tr.over td { color: var(--red); }
+.inline-select { width: auto; font-size: 13px; font-weight: 400; margin-left: 6px; padding: 2px 4px; }
+.kpis { display: grid; grid-template-columns: repeat(3, 1fr); gap: 8px; margin-bottom: 8px; }
+.kpi { border: 1px solid var(--border); border-radius: 6px; padding: 6px 10px; }
+.kpi-v { font-size: 20px; font-weight: 700; }
+.kpi-l { font-size: 12px; color: var(--muted); }
+.stats-table { margin: 6px 0; }
+.stats-table summary { cursor: pointer; font-size: 13px; color: var(--muted); }
+.spend-h { margin: 14px 0 4px; font-size: 14px; }
+#spend-dialog { width: min(720px, calc(100vw - 32px)); }
+@media (max-width: 560px) { .kpis { grid-template-columns: repeat(2, 1fr); } }
+.pb-table td { vertical-align: top; }
+.pb-intent { max-width: 360px; white-space: normal; }
+.pb-actions { white-space: nowrap; text-align: right; }
+.pb-form { border: 1px solid var(--border); border-radius: 8px; padding: 12px; margin-top: 10px; }
+.memory-text { width: 100%; font: 12px/1.5 var(--mono); }
+#memory-dialog { width: min(760px, calc(100vw - 32px)); }
+.setup { max-width: 640px; margin: 24px auto; text-align: left; color: var(--text); }
+.setup-head { display: flex; gap: 10px; align-items: baseline; }
+.setup-head h3 { margin: 0; font-size: 16px; }
+.setup-steps { list-style: none; padding: 0; margin: 10px 0; display: flex; flex-direction: column; gap: 6px; }
+.setup-steps li { display: grid; grid-template-columns: 22px 1fr auto; gap: 8px; align-items: center; padding: 8px 10px; border: 1px solid var(--border); border-radius: 8px; background: var(--panel); }
+.setup-steps li.done { opacity: .6; }
+.setup-mark { color: var(--green); font-weight: 700; }
+.setup-check { padding: 6px 10px; border-radius: 6px; margin: 6px 0; border-left: 3px solid var(--yellow); background: var(--panel-2); font-size: 13px; }
+.setup-check.fail { border-left-color: var(--red); }

package/public/triggers.js

@@ -0,0 +1,85 @@
+// Triggers dialog: GitHub label, /agent PR comments and the webhook (see src/triggers.js).
+
+export function initTriggers({ api, esc, toast, $ }) {
+  const dlg = $('#triggers-dialog');
+  const f = $('#triggers-form');
+  let state = null;
+
+  const ago = (iso) => {
+    if (!iso) return 'never';
+    const m = Math.round((Date.now() - Date.parse(iso)) / 60_000);
+    return m < 1 ? 'just now' : m < 60 ? `${m} min ago` : `${Math.round(m / 60)} h ago`;
+  };
+
+  function fill(t, token) {
+    state = t;
+    f.gh_enabled.checked = t.github.enabled;
+    f.gh_label.value = t.github.label;
+    f.gh_everyMin.value = t.github.everyMin;
+    f.gh_comment.checked = t.github.comment;
+    f.gh_repos.value = t.github.repos.join(' ');
+    f.gh_owners.value = t.github.owners.join(' ');
+    f.pc_enabled.checked = t.prCommands.enabled;
+    f.pc_prefix.value = t.prCommands.prefix;
+    f.wh_enabled.checked = t.webhook.enabled;
+    f.wh_repos.value = t.webhook.repos.join(' ');
+    f.maxPerDay.value = t.maxPerDay;
+    const url = `${location.origin}/api/hooks/agents`;
+    $('#triggers-token').innerHTML = token
+      ? `New token, shown only now. Copy it: <code>${esc(token)}</code><br>Example: <code>curl -X POST ${esc(url)} -H "Authorization: Bearer &lt;token&gt;" -H "content-type: application/json" -d '{"intent":"…","project":"&lt;shortcut&gt;"}'</code>`
+      : t.webhook.hasToken
+        ? 'A token is set (it is shown only when made). Other machines reach this only through remote access.'
+        : 'No token yet: make one to turn the webhook on.';
+    $('#triggers-status').innerHTML = `Last check ${ago(t.lastPoll?.at)}${t.lastPoll ? ` (${t.lastPoll.issues} started, ${t.lastPoll.commands} comments passed on)` : ''} · ${t.startedToday} started in the last day${t.lastError ? `<br><span class="error">${esc(t.lastError.message)}</span>` : ''}
+      ${t.recent.length ? `<ul class="trig-recent">${t.recent.slice(0, 6).map((r) => `<li>${ago(r.at)}: <a href="#${r.agent}">${esc(r.name)}</a> from ${esc(r.source)}${r.url ? ` <span class="hint">${esc(r.url)}</span>` : ''}</li>`).join('')}</ul>` : ''}`;
+  }
+
+  const patch = () => ({
+    github: { enabled: f.gh_enabled.checked, label: f.gh_label.value.trim(), everyMin: Number(f.gh_everyMin.value) || 5, comment: f.gh_comment.checked, repos: f.gh_repos.value, owners: f.gh_owners.value },
+    prCommands: { enabled: f.pc_enabled.checked, prefix: f.pc_prefix.value.trim() || '/agent' },
+    webhook: { enabled: f.wh_enabled.checked, repos: f.wh_repos.value },
+    maxPerDay: Number(f.maxPerDay.value),
+  });
+
+  const error = (msg) => {
+    $('#triggers-error').hidden = !msg;
+    $('#triggers-error').textContent = msg ?? '';
+  };
+
+  async function open() {
+    error(null);
+    fill(await api('GET', '/triggers'));
+    if (!dlg.open) dlg.showModal();
+  }
+
+  f.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    try {
+      fill(await api('PUT', '/triggers', patch()));
+      error(null);
+      toast('Triggers saved');
+    } catch (err) {
+      error(err.message);
+    }
+  });
+  $('#triggers-newtoken').onclick = async () => {
+    if (state?.webhook.hasToken && !confirm('Make a new token? The old one stops working.')) return;
+    try {
+      const r = await api('PUT', '/triggers', { ...patch(), webhook: { ...patch().webhook, enabled: true, newToken: true } });
+      fill(r, r.token);
+    } catch (err) {
+      error(err.message);
+    }
+  };
+  $('#triggers-poll').onclick = async () => {
+    try {
+      const r = await api('POST', '/triggers/poll');
+      fill(r);
+      toast(`${r.issues} started, ${r.commands} comments passed on`);
+    } catch (err) {
+      error(err.message);
+    }
+  };
+  $('#triggers-close').onclick = () => dlg.close();
+  return { open };
+}

package/src/assistant.js

@@ -16,10 +16,12 @@ export const SOURCES = {
   ci: "the person's own open GitHub pull requests whose checks fail",
   comments: 'new comments and mentions on Jira issues the person owns',
   slack: 'Slack messages to the person (direct messages and mentions) that ask for work',
+  linear: 'Linear issues newly assigned to the person',
 };
 export const ASSISTANT_DEFAULTS = {
   everyMin: 15,
-  sources: Object.keys(SOURCES),
+  // Linear only when chosen: most people use Jira or Linear, not both.
+  sources: Object.keys(SOURCES).filter((k) => k !== 'linear'),
   maxPerDay: 10,
   maxRunning: 5,
   permissionMode: 'auto',
@@ -61,6 +63,14 @@ export function assistantPrompt(s, dir, bin = `node ${BIN}`) {
         `Start the request with the issue link: the agent is then named after the issue key, and the daemon refuses a second agent for the same key.`,
     );
   }
+  if (s.sources.includes('linear')) {
+    how.push(
+      `Linear, new assignments: with your Linear tools, find open issues assigned to the person that were created or assigned since your last check (on the first check, the last 2 days). ` +
+        `For each one you haven't handled, start an agent: ${am} add @<project> "<the issue link> <a one-line summary of what to do>". ` +
+        `Start the request with the issue link (https://linear.app/<team>/issue/<KEY>/…): the agent is then named after the issue key, and the daemon refuses a second agent for the same key. ` +
+        `New comments on issues that already have an agent: pass them on with ${am} tell, as for Jira.`,
+    );
+  }
   if (s.sources.includes('comments')) {
     how.push(
       `Jira, comments and mentions: find new comments on issues the person owns or is mentioned in, since your last check. ` +
@@ -92,12 +102,12 @@ export function assistantPrompt(s, dir, bin = `node ${BIN}`) {
     `Watch:\n${watch}`,
     `Each time you get a message starting with "Check now", do one check of every source above, act, record it, and wait for the next message. Don't loop or sleep on your own.`,
     `How:\n${how.map((h, i) => `${i + 1}. ${h}`).join('\n')}`,
-    `Projects: ${am} project ls shows the projects and their shortcuts. Pick the project whose repository matches the work (the Jira project, the GitHub repository). ` +
+    `Projects: ${am} project ls shows the projects and their shortcuts. Pick the project whose repository matches the work (the Jira or Linear project, the GitHub repository). ` +
       `If no project fits, use --repo <git URL> when you know the repository; if you don't know where the work belongs, don't start an agent: list it under "Needs you" in the activity file.`,
     `Limits: the daemon allows at most ${s.maxPerDay} new agents a day and ${s.maxRunning} of yours running at once, and refuses a second agent for the same issue. When ${am} add is refused, don't retry it in this check: record the reason.`,
     `Memory: keep ${path.join(dir, 'handled.json')} as a JSON object from item keys (a Jira key, a PR URL, "<key>#comment-<id>", a Slack message link) to { "at": time, "action": "started <agent id>" | "told <agent id>" | "skipped: why" }. Read it at the start of each check and add what you handled, so you never act on the same item twice. Keep "lastCheck" in it too.`,
     `Activity: after each check, append a short entry to ${path.join(dir, 'activity.md')}: a "## <date and time>" heading, then one line per action ("Started OPS-7 (agent 3fa2b1) in @cc: fix the login timeout", "Told 3fa2b1 about a new comment on OPS-7"), and a "Needs you" list for anything you couldn't decide. Write "Nothing new." when nothing came in. AI Agent Manager shows this file to the person.`,
-    `Never merge, approve, close, reassign or comment on anything in Jira, GitHub or Slack, and never send messages as the person. Reading, and starting or telling agents, is all you do.`,
+    `Never merge, approve, close, reassign or comment on anything in Jira, Linear, GitHub or Slack, and never send messages as the person. Reading, and starting or telling agents, is all you do.`,
     s.notes ? `The person's notes for you:\n${s.notes}` : '',
   ]
     .filter(Boolean)

package/src/budgets.js

@@ -0,0 +1,166 @@
+// Spending limits, from the cost Claude Code records for each session (Codex and Antigravity
+// record none). Per agent: at 80% you get an alert; at the limit the agent's session is closed
+// and it won't start again until its budget is raised. Per day: once today's spend reaches the
+// limit, no new agents start (or resume) until tomorrow or a higher limit; running ones go on.
+// A built-in policy enforces both, so every way of starting an agent is covered.
+
+export const BUDGET_DEFAULTS = { perAgentUsd: null, perDayUsd: null, warnAt: 0.8 };
+const err = (status, message) => Object.assign(new Error(message), { status });
+const usd = (n) => `$${Number(n).toFixed(2)}`;
+
+/** Settings from config.json's "budgets": dollar limits (null = none) and the alert fraction. */
+export function budgetSettings(config = {}) {
+  const c = { ...BUDGET_DEFAULTS, ...config.budgets };
+  const money = (v) => (v === null || v === undefined || v === '' ? null : Number.isFinite(Number(v)) && Number(v) > 0 ? Math.round(Number(v) * 100) / 100 : null);
+  const w = Number(c.warnAt);
+  return { perAgentUsd: money(c.perAgentUsd), perDayUsd: money(c.perDayUsd), warnAt: Number.isFinite(w) && w > 0 && w < 1 ? w : BUDGET_DEFAULTS.warnAt };
+}
+
+/** What an agent's sessions cost so far, as Claude Code recorded it. */
+export function costOf(agent) {
+  return (agent.sessions ?? []).reduce((sum, s) => sum + (Number(s.cost?.usd) || 0), 0);
+}
+
+export const dayKey = (t = new Date()) => {
+  const d = new Date(t);
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+};
+
+export class Budgets {
+  constructor({ manager, store, config = {}, notifier = null, log = (m) => console.log(`[agentmgr] ${m}`) }) {
+    this.manager = manager;
+    this.store = store;
+    this.config = config;
+    this.notifier = notifier;
+    this.log = log;
+    store.data.spend ??= { days: {}, seen: {} };
+    this.startedAt = Date.now();
+    // Today's spend counts from now: what agents cost before limits existed isn't today's.
+    this.seed();
+    manager.plugins.api('budgets', config).policy((action, details) => this.policy(action, details));
+    this.timer = setInterval(() => this.tick(), (config.budgetCheckSec ?? 60) * 1000);
+    this.timer.unref?.();
+  }
+
+  close() {
+    clearInterval(this.timer);
+  }
+
+  get settings() {
+    return budgetSettings(this.config);
+  }
+
+  get ledger() {
+    return this.store.data.spend;
+  }
+
+  seed() {
+    for (const a of this.store.list()) if (this.ledger.seen[a.id] === undefined) this.ledger.seen[a.id] = costOf(a);
+  }
+
+  limitOf(agent) {
+    return agent.budgetUsd ?? this.settings.perAgentUsd;
+  }
+
+  today() {
+    return this.ledger.days[dayKey()] ?? { total: 0, byAgent: {} };
+  }
+
+  policy(action, details) {
+    if (action !== 'agent.start' && action !== 'agent.create') return undefined;
+    const s = this.settings;
+    if (s.perDayUsd && this.today().total >= s.perDayUsd) {
+      return { allow: false, reason: `Today's spend (${usd(this.today().total)}) reached the daily limit of ${usd(s.perDayUsd)}; raise it in Budgets or wait until tomorrow` };
+    }
+    if (action === 'agent.start') {
+      const agent = this.store.get(details.agent?.id);
+      const limit = agent && this.limitOf(agent);
+      if (limit && costOf(agent) >= limit) {
+        return { allow: false, reason: `${agent.name} has spent ${usd(costOf(agent))} of its ${usd(limit)} budget; raise its budget (Edit) to continue` };
+      }
+    }
+    return undefined;
+  }
+
+  /** Count new spend into today, warn near a limit, close agents that reached theirs. */
+  tick() {
+    const s = this.settings;
+    const key = dayKey();
+    const day = (this.ledger.days[key] ??= { total: 0, byAgent: {} });
+    let changed = false;
+    for (const agent of this.store.list()) {
+      const cost = costOf(agent);
+      // An agent new since start counts from zero; one from before limits existed, from now.
+      const before = this.ledger.seen[agent.id] ?? (Date.parse(agent.createdAt) >= this.startedAt ? 0 : cost);
+      if (cost > before) {
+        const d = cost - before;
+        day.total = Math.round((day.total + d) * 10_000) / 10_000;
+        day.byAgent[agent.id] = Math.round(((day.byAgent[agent.id] ?? 0) + d) * 10_000) / 10_000;
+        changed = true;
+      }
+      if (this.ledger.seen[agent.id] !== cost) {
+        this.ledger.seen[agent.id] = cost;
+        changed = true;
+      }
+      const limit = this.limitOf(agent);
+      if (!limit) continue;
+      if (cost >= limit && !agent.budgetHit) {
+        this.manager.patch(agent.id, { budgetHit: new Date().toISOString() });
+        if (this.manager.runtimes.get(agent.id)?.pty) this.manager.stop(agent.id).catch(() => {});
+        this.notifier?.send?.('budget', agent, `reached its ${usd(limit)} budget (${usd(cost)} spent) and was closed. Raise its budget to continue.`);
+        this.log(`budgets: ${agent.name} reached its ${usd(limit)} budget; closed`);
+      } else if (cost >= limit * s.warnAt && cost < limit && agent.budgetWarned !== limit) {
+        this.manager.patch(agent.id, { budgetWarned: limit });
+        this.notifier?.send?.('budget', agent, `has spent ${usd(cost)} of its ${usd(limit)} budget.`);
+      }
+    }
+    if (s.perDayUsd && day.total >= s.perDayUsd && !day.alerted) {
+      day.alerted = true;
+      changed = true;
+      this.log(`budgets: today's spend ${usd(day.total)} reached the daily limit ${usd(s.perDayUsd)}`);
+      this.notifier?.send?.('budget', { id: '', name: 'Daily limit' }, `reached: today's agent spend is ${usd(day.total)} of ${usd(s.perDayUsd)}. No new agents start until tomorrow or a higher limit.`);
+    }
+    // Keep 90 days of history.
+    for (const k of Object.keys(this.ledger.days).sort().slice(0, -90)) delete this.ledger.days[k];
+    if (changed) this.store.save();
+  }
+
+  update(patch = {}) {
+    for (const k of ['perAgentUsd', 'perDayUsd']) {
+      const v = patch[k];
+      if (v !== undefined && v !== null && v !== '' && !(Number(v) > 0)) throw err(400, `${k} must be a positive number of dollars, or empty for no limit`);
+    }
+    const next = budgetSettings({ budgets: { ...this.config.budgets, ...patch } });
+    this.config.budgets = next;
+    // A higher limit lifts the stop on agents now under it.
+    for (const a of this.store.list()) {
+      const limit = this.limitOf(a);
+      if (a.budgetHit && (!limit || costOf(a) < limit)) this.manager.patch(a.id, { budgetHit: null });
+    }
+    return next;
+  }
+
+  status() {
+    this.tick();
+    const s = this.settings;
+    const today = this.today();
+    const names = Object.fromEntries(this.store.list().map((a) => [a.id, a.name]));
+    const days = Object.entries(this.ledger.days)
+      .sort(([a], [b]) => (a < b ? 1 : -1))
+      .slice(0, 14)
+      .map(([day, d]) => ({ day, total: d.total }));
+    const agents = this.store
+      .list()
+      .map((a) => ({ id: a.id, name: a.name, cost: Math.round(costOf(a) * 100) / 100, limit: this.limitOf(a), own: a.budgetUsd ?? null, hit: a.budgetHit ?? null, today: today.byAgent[a.id] ?? 0 }))
+      .filter((a) => a.cost > 0 || a.own)
+      .sort((x, y) => y.cost - x.cost)
+      .slice(0, 50);
+    return {
+      ...s,
+      today: { total: Math.round(today.total * 100) / 100, top: Object.entries(today.byAgent).sort(([, a], [, b]) => b - a).slice(0, 5).map(([id, c]) => ({ id, name: names[id] ?? id, cost: Math.round(c * 100) / 100 })) },
+      days,
+      agents,
+      note: 'Costs are what Claude Code records for each session (the API price, even on a subscription plan). Codex and Antigravity record none.',
+    };
+  }
+}