ai-agentmanager 1.0.2 → 1.2.1

package/public/index.html

@@ -22,6 +22,8 @@
       </div>
       <div class="top-actions">
         <input id="filter" type="search" placeholder="Filter agents" aria-label="Filter agents" />
+        <button id="assistant-btn" title="An always-on session that finds new work and starts agents for it">Assistant <span id="assistant-dot" class="assistant-dot" hidden></span></button>
+        <button id="cleanup-btn" title="Close agents idle for a while, and delete old closed ones">Clean up</button>
         <button id="alerts-btn" class="local-only" title="Slack alerts when an agent needs you">Alerts</button>
         <button id="remote-btn" class="local-only" title="Open AI Agent Manager from your phone">Remote access</button>
         <button id="ask-btn" title="A general Claude session with no repo or folder">Ask Claude</button>
@@ -38,6 +40,13 @@
         </div>
         <div id="agents-view">
           <div class="counts" id="counts"></div>
+          <div class="recent-bar" id="recent-bar" hidden>
+            <label class="recent-switch" title="Hide agents created before then (they're still there; turn this off to see them)">
+              <input type="checkbox" id="recent-on"> Created in the last
+            </label>
+            <input type="number" id="recent-days" min="1" max="3650" value="7" aria-label="Days"> days
+            <span class="spacer"></span><span id="recent-hidden"></span>
+          </div>
           <ul id="agent-list" class="agent-list" aria-label="Agents"></ul>
         </div>
         <div id="backlog-view" hidden></div>
@@ -192,6 +201,7 @@
           <label class="check"><input type="radio" name="when" value="now" checked /> Start now</label>
           <label class="check"><input type="radio" name="when" value="backlog" /> Queue in backlog</label>
           <label class="check" title="Several agents try the same intent; compare and keep the best"><input type="radio" name="when" value="race" /> Race variants</label>
+          <label class="check" title="Agents in roles solve one problem: analyze, critique, implement, test, review"><input type="radio" name="when" value="team" /> Team</label>
           <label class="check">Priority
             <select name="priority" aria-label="Priority">
               <option value="0">P0 urgent</option>
@@ -211,6 +221,48 @@
             <input name="testCommand" placeholder="npm test" />
           </label>
         </div>
+        <div class="team-only" hidden>
+          <p class="hint">An analyst writes the analysis and critics challenge it until they agree; then an implementer builds it, a tester tests it and a reviewer approves it or sends it back. The reviewer also lists what the request asks for that isn't built yet; the team then asks you whether to run a gap round for it. The team stops for you when the reviewer approves, or if they can't agree. No repository yet? Leave the repository and folder empty (or give a new folder) and the team starts a new project. Tip: pick <b>Accept edits</b> or <b>Auto</b> as the permission mode, or the agents stop to ask before each edit or command.</p>
+          <label>
+            How the team runs
+            <select name="teamMode">
+              <option value="lead" selected>One lead session; the roles are its sub-agents</option>
+              <option value="agents">Separate agents, one per role (any engine)</option>
+            </select>
+          </label>
+          <div class="row">
+            <label>
+              Critics
+              <select name="critics">
+                <option value="0">None</option>
+                <option value="1" selected>1</option>
+                <option value="2">2</option>
+              </select>
+            </label>
+            <label>
+              Test command <span class="hint">optional; a hint for the tester</span>
+              <input name="teamTest" placeholder="npm test" />
+            </label>
+          </div>
+          <div class="row three">
+            <label>
+              Analysis rounds <span class="hint">before it stops for you</span>
+              <input name="maxRounds" type="number" min="1" max="10" placeholder="3" />
+            </label>
+            <label>
+              Build rounds <span class="hint">fix rounds per request</span>
+              <input name="maxLoops" type="number" min="1" max="10" placeholder="3" />
+            </label>
+            <label>
+              Gap rounds without asking <span class="hint">0: it asks you first</span>
+              <input name="gapRounds" type="number" min="0" max="10" placeholder="0" />
+            </label>
+          </div>
+          <label>
+            Models by role <span class="hint">optional, e.g. <code>analyst=opus reviewer=opus</code>; others use the model above</span>
+            <input name="roleModels" placeholder="analyst=opus reviewer=opus" />
+          </label>
+        </div>
         <label class="check now-only">
           <input type="checkbox" name="start" checked />
           Launch immediately
@@ -292,6 +344,17 @@
       </div>
     </dialog>
 
+    <dialog id="team-dialog" class="doc-dialog">
+      <div class="doc-head">
+        <h2 id="team-title">Team</h2>
+        <span class="spacer"></span>
+        <button type="button" id="team-stop" class="small ghost" title="Close the team's agents; nothing is deleted">Stop team</button>
+        <button type="button" id="team-delete" class="small ghost" title="Forget this team">Forget team</button>
+        <button type="button" id="team-close" class="small ghost">Close</button>
+      </div>
+      <div id="team-body" class="race-body team-body"></div>
+    </dialog>
+
     <dialog id="race-dialog" class="doc-dialog">
       <div class="doc-head">
         <h2 id="race-title">Race</h2>
@@ -321,6 +384,7 @@
           <label class="check"><input type="checkbox" name="ev_stuck" /> seems stuck (same failure, undoing its edits, no progress)</label>
           <label class="check"><input type="checkbox" name="ev_conflict" /> changes the same files as another agent</label>
           <label class="check"><input type="checkbox" name="ev_question" /> asks a question in the inbox</label>
+          <label class="check"><input type="checkbox" name="ev_assistant" /> is started by the assistant for new work</label>
           <label class="check"><input type="checkbox" name="ev_waiting" /> finished its turn and is idle after <input name="waitingDelaySec" type="number" min="0" class="num" />s</label>
           <label class="check"><input type="checkbox" name="skipWhenWatching" /> not while I have its terminal open</label>
           <label class="check"><input type="checkbox" name="includeIntent" /> include the intent text in the message</label>
@@ -337,6 +401,98 @@
       </form>
     </dialog>
 
+    <dialog id="edit-dialog">
+      <form id="edit-form" method="dialog" class="alerts-body">
+        <h2>Edit agent</h2>
+        <label>Name <input name="name" required maxlength="80" /></label>
+        <label>Request <span class="hint">what the agent was asked to do</span>
+          <textarea name="intent" rows="4"></textarea>
+        </label>
+        <label class="check" id="edit-tell-row"><input type="checkbox" name="tell" /> Also tell the agent about the changed request</label>
+        <label id="edit-project-row">Project
+          <select name="project"></select>
+        </label>
+        <label id="edit-newproject-row" hidden>New project name <input name="newProject" maxlength="60" /></label>
+        <div class="row three">
+          <label>Priority
+            <select name="priority"><option value="0">P0 urgent</option><option value="1">P1 high</option><option value="2">P2 normal</option><option value="3">P3 low</option></select>
+          </label>
+          <label>Permission mode <select name="permissionMode"></select></label>
+          <label>Model <input name="model" placeholder="as configured" /></label>
+        </div>
+        <p class="hint" id="edit-hint">Moving changes only where the agent is listed; its code stays in its own repo and branch. Permission mode and model apply from its next launch.</p>
+        <p id="edit-error" class="error" hidden></p>
+        <div class="dialog-actions">
+          <span class="spacer"></span>
+          <button type="button" id="edit-close" class="ghost">Cancel</button>
+          <button class="primary">Save</button>
+        </div>
+      </form>
+    </dialog>
+
+    <dialog id="assistant-dialog">
+      <form id="assistant-form" method="dialog" class="alerts-body">
+        <h2>Assistant</h2>
+        <p class="hint">An always-on Claude session that works on your behalf. Every few minutes it checks for new work with its own Jira, GitHub and Slack tools, and starts an agent for each new item, or passes news to the agent already on it. It never merges, approves, comments or sends messages as you.</p>
+        <div id="assistant-status" class="assistant-status"></div>
+        <fieldset>
+          <legend>Watch</legend>
+          <label class="check"><input type="checkbox" name="src_jira" /> Jira issues newly assigned to me</label>
+          <label class="check"><input type="checkbox" name="src_comments" /> New comments and mentions on my Jira issues (passed to the agent on it)</label>
+          <label class="check"><input type="checkbox" name="src_reviews" /> GitHub pull requests waiting for my review</label>
+          <label class="check"><input type="checkbox" name="src_ci" /> Failing checks on my open pull requests</label>
+          <label class="check"><input type="checkbox" name="src_slack" /> Slack messages to me that ask for work</label>
+        </fieldset>
+        <div class="row three">
+          <label>Check every <span class="hint">minutes</span><input name="everyMin" type="number" min="1" /></label>
+          <label>New agents a day <span class="hint">at most</span><input name="maxPerDay" type="number" min="0" /></label>
+          <label>Running at once <span class="hint">at most</span><input name="maxRunning" type="number" min="0" /></label>
+        </div>
+        <label>Notes for the assistant <span class="hint">e.g. "Jira project OPS is the @cc repo; skip issues labeled design"</span>
+          <textarea name="notes" rows="3"></textarea>
+        </label>
+        <div id="assistant-activity" class="assistant-activity"></div>
+        <p id="assistant-error" class="error" hidden></p>
+        <div class="dialog-actions">
+          <button type="button" id="assistant-start" class="primary">Start</button>
+          <button type="button" id="assistant-check">Check now</button>
+          <button type="button" id="assistant-pause">Pause</button>
+          <button type="button" id="assistant-open" class="ghost">Open its session</button>
+          <span class="spacer"></span>
+          <button type="button" id="assistant-close" class="ghost">Close</button>
+          <button id="assistant-save">Save</button>
+        </div>
+      </form>
+    </dialog>
+
+    <dialog id="cleanup-dialog">
+      <form id="cleanup-form" method="dialog" class="alerts-body">
+        <h2>Clean up old agents</h2>
+        <p class="hint">Closing an agent ends its session; resume it any time. Deleting removes it from your list, with the worktree AI Agent Manager created (Claude's own transcripts stay). Never touched: agents marked <b>Keep</b>, agents working or setting up, and members of a team that is still going. Not deleted: agents with an open pull request, or with uncommitted changes or commits that aren't on any other branch.</p>
+        <label>Strategy
+          <select name="strategy">
+            <option value="close-delete">Close, then delete, automatically</option>
+            <option value="close">Close automatically; delete when I say</option>
+            <option value="manual">Nothing automatic; only when I run it</option>
+            <option value="off">Off</option>
+          </select>
+        </label>
+        <div class="row">
+          <label>Close after <span class="hint">days with no activity</span><input name="closeAfterDays" type="number" min="1" /></label>
+          <label>Delete after <span class="hint">days closed</span><input name="deleteAfterDays" type="number" min="1" /></label>
+        </div>
+        <div id="cleanup-plan" class="cleanup-plan"></div>
+        <p id="cleanup-error" class="error" hidden></p>
+        <div class="dialog-actions">
+          <button type="button" id="cleanup-run-close" title="Close the sessions that are due now">Close due now</button>
+          <button type="button" id="cleanup-run" class="danger" title="Close and delete what is due now">Close and delete due now</button>
+          <span class="spacer"></span>
+          <button type="button" id="cleanup-close" class="ghost">Close</button>
+          <button class="primary">Save</button>
+        </div>
+      </form>
+    </dialog>
+
     <dialog id="remote-dialog">
       <div class="remote-body">
         <h2>Remote access</h2>

package/public/style.css

@@ -142,6 +142,11 @@ body.term-max .layout { grid-template-columns: 1fr; }
 .row.when { align-items: center; }
 .row.when select { width: auto; margin-left: 6px; padding: 2px 6px; }
 .counts { display: flex; gap: 12px; padding: 10px 14px; font-size: 12px; color: var(--muted); border-bottom: 1px solid var(--border); }
+.recent-bar { display: flex; align-items: center; gap: 6px; padding: 6px 14px; font-size: 12px; color: var(--muted); border-bottom: 1px solid var(--border); flex-wrap: wrap; }
+.recent-bar .spacer { flex: 1; }
+.recent-switch { display: inline-flex; align-items: center; gap: 6px; cursor: pointer; white-space: nowrap; margin: 0; font-weight: normal; }
+.recent-switch input { width: auto; margin: 0; }
+.recent-bar input[type="number"] { width: 56px; flex: none; padding: 2px 6px; font-size: 12px; }
 .agent-list { list-style: none; margin: 0; padding: 0; }
 .agent-list li.project { border-bottom: 1px solid var(--border); }
 .project-head {
@@ -152,8 +157,10 @@ body.term-max .layout { grid-template-columns: 1fr; }
 .shortcut { flex: none; font: 600 11px/16px var(--mono); padding: 0 6px; border-radius: 4px; background: var(--accent); color: var(--accent-text); cursor: pointer; }
 .bl-head .shortcut { cursor: default; }
 .project-head .caret { width: 12px; color: var(--muted); flex: none; }
-.project-head .pname { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.project-head .pname { font-size: 16px; font-weight: 700; flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .project-head .pcounts { display: flex; gap: 6px; align-items: center; color: var(--muted); font-weight: 500; font-size: 12px; }
+.project-head .prun { color: var(--green); }
+.project-head .pcount { white-space: nowrap; }
 .project-head .pill { padding: 0 6px; }
 .project-agents { list-style: none; margin: 0; padding: 0; }
 .agent-list li.agent {
@@ -377,6 +384,21 @@ body.remote .local-only { display: none; }
 .alerts-body .check { display: flex; gap: 8px; align-items: center; font-size: 13px; }
 .alerts-body .check input[type=checkbox] { width: auto; }
 .alerts-body .num { width: 64px; padding: 2px 6px; }
+.assistant-dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-left: 4px; vertical-align: middle; background: var(--muted); }
+.assistant-dot.on { background: var(--green); }
+.assistant-dot.busy { background: var(--yellow); }
+.assistant-status { font-size: 13px; }
+.assistant-status p { margin: 4px 0; }
+.assistant-started { margin: 4px 0; padding-left: 18px; font-size: 13px; }
+.assistant-activity { font-size: 13px; max-height: 240px; overflow: auto; }
+.assistant-activity h4 { margin: 8px 0 4px; }
+.assistant-activity .md h1, .assistant-activity .md h2, .assistant-activity .md h3 { font-size: 13px; margin: 10px 0 2px; color: var(--muted); }
+.assistant-activity .md p, .assistant-activity .md ul { margin: 2px 0; }
+.tag.assistant { background: var(--panel-2); }
+.cleanup-plan { font-size: 13px; max-height: 260px; overflow: auto; }
+.cleanup-plan h4 { margin: 8px 0 4px; font-size: 13px; }
+.cleanup-plan ul { margin: 0; padding-left: 18px; }
+.cleanup-plan li .hint { margin-left: 6px; }
 #login-form { padding: 20px; display: grid; gap: 12px; }
 #login-form h2 { margin: 0; font-size: 17px; }
 
@@ -394,6 +416,8 @@ dialog::backdrop { background: rgba(0, 0, 0, .45); }
 #new-form label.check input { width: auto; }
 .hint { color: var(--muted); font-weight: 400; font-size: 12px; }
 .row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+.row.three { grid-template-columns: 1fr 1fr 1fr; }
+.team-gaps { max-height: 220px; overflow: auto; margin: 6px 0; font-size: 13px; }
 .dialog-actions { display: flex; justify-content: flex-end; gap: 8px; }
 .error { color: var(--red); margin: 0; font-size: 13px; }
 
@@ -423,7 +447,7 @@ dialog::backdrop { background: rgba(0, 0, 0, .45); }
   .splitter, .desk-only { display: none !important; }
   .sidebar { max-height: 38vh; border-right: 0; border-bottom: 1px solid var(--border); }
   .top-actions input { width: 130px; }
-  .row { grid-template-columns: 1fr; }
+  .row, .row.three { grid-template-columns: 1fr; }
   .brief-grid { grid-template-columns: 1fr; }
 }
 
@@ -573,3 +597,31 @@ pre.diff .meta { color: var(--muted); font-weight: 600; }
 
 .agent-list li.agent.idle { opacity: .62; }
 .agent-list li.agent.idle:hover, .agent-list li.agent.idle.selected { opacity: 1; }
+
+/* Agent teams */
+.bl-banner.team { border-color: color-mix(in srgb, var(--accent) 50%, var(--border)); }
+.team-steps { display: flex; flex-wrap: wrap; gap: 4px; align-items: center; font-size: 12px; }
+.team-step { padding: 3px 9px; border-radius: 999px; border: 1px solid var(--border); color: var(--muted); }
+.team-step.done { color: var(--green); border-color: color-mix(in srgb, var(--green) 45%, var(--border)); }
+.team-step.now { color: #fff; background: var(--accent); border-color: var(--accent); }
+.team-step.stop { color: #fff; background: var(--yellow, #c08a1e); border-color: transparent; }
+.team-arrow { color: var(--muted); }
+.team-gate { border: 1px solid var(--accent); border-radius: 6px; padding: 10px 12px; display: flex; flex-direction: column; gap: 8px; }
+.team-gate.blocked { border-color: var(--yellow, #c08a1e); }
+.team-gate textarea { width: 100%; }
+.team-timeline { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 6px; font-size: 13px; }
+.team-body > * { flex-shrink: 0; }
+.team-timeline li { display: grid; grid-template-columns: 160px 80px 1fr; gap: 8px; align-items: baseline; }
+.team-timeline .summary { color: var(--muted); }
+.verdict-word { font-weight: 600; }
+.verdict-word.good { color: var(--green); }
+.verdict-word.bad { color: var(--red); }
+.team-file { border: 1px solid var(--border); border-radius: 6px; padding: 8px 12px; max-height: 50vh; overflow: auto; }
+.need-kind.team { background: var(--accent); color: #fff; }
+.flag.role { font-size: 11px; padding: 0 5px; border: 1px solid var(--border); border-radius: 4px; color: var(--muted); }
+@media (max-width: 800px) { .team-timeline li { grid-template-columns: 1fr; gap: 2px; } }
+.team-ask { border: 1px solid var(--border); border-radius: 6px; padding: 10px 12px; display: flex; flex-direction: column; gap: 6px; }
+.team-ask textarea { width: 100%; }
+.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; }

package/src/assistant.js

@@ -0,0 +1,269 @@
+// The assistant: one always-on session that works on the person's behalf. Every few minutes the
+// daemon asks it to check for new work (newly assigned Jira issues, GitHub review requests,
+// failing checks on the person's PRs, new Jira comments, Slack messages) with its own tools, and
+// it starts agents for that work through agentmgr, or passes news to the agent already on it.
+// The daemon keeps the limits: a daily cap, a cap on its agents running at once, and no second
+// agent for the same issue.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { paths } from './config.js';
+import { leadingJiraKey } from './tracker.js';
+
+export const SOURCES = {
+  jira: 'Jira issues newly assigned to the person',
+  reviews: "GitHub pull requests where the person's review is requested",
+  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',
+};
+export const ASSISTANT_DEFAULTS = {
+  everyMin: 15,
+  sources: Object.keys(SOURCES),
+  maxPerDay: 10,
+  maxRunning: 5,
+  permissionMode: 'auto',
+  model: null,
+  notes: '',
+};
+const DAY = 86_400_000;
+const BIN = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'agentmgr.js');
+
+const err = (status, message) => Object.assign(new Error(message), { status });
+
+export const assistantDir = () => path.join(paths.home, 'assistant');
+
+/** Settings from config.json's "assistant", with defaults and sane bounds. */
+export function assistantSettings(config = {}) {
+  const c = { ...ASSISTANT_DEFAULTS, ...config.assistant };
+  const n = (v, d, lo, hi) => (Number.isFinite(Number(v)) && Number(v) >= lo ? Math.min(hi, Math.floor(Number(v))) : d);
+  const sources = Array.isArray(c.sources) ? c.sources.filter((s) => SOURCES[s]) : ASSISTANT_DEFAULTS.sources;
+  return {
+    everyMin: n(c.everyMin, ASSISTANT_DEFAULTS.everyMin, 1, 1440),
+    sources,
+    maxPerDay: n(c.maxPerDay, ASSISTANT_DEFAULTS.maxPerDay, 0, 500),
+    maxRunning: n(c.maxRunning, ASSISTANT_DEFAULTS.maxRunning, 0, 100),
+    permissionMode: typeof c.permissionMode === 'string' && c.permissionMode ? c.permissionMode : null,
+    model: typeof c.model === 'string' && c.model ? c.model : null,
+    notes: typeof c.notes === 'string' ? c.notes.slice(0, 4000) : '',
+  };
+}
+
+/** The assistant's standing instructions (appended to its system prompt on every launch). */
+export function assistantPrompt(s, dir, bin = `node ${BIN}`) {
+  const am = bin;
+  const watch = s.sources.map((k) => `- ${SOURCES[k]}`).join('\n');
+  const how = [];
+  if (s.sources.includes('jira')) {
+    how.push(
+      `Jira, new assignments: with your Jira / Atlassian tools, find unresolved 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: the agent is then named after the issue key, and the daemon refuses a second agent for the same key.`,
+    );
+  }
+  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. ` +
+        `If an agent is already working on that issue (its name is the issue key; see ${am} ls --json), pass the comment on: ${am} tell <agent id> "New comment on <key> from <author>: <the comment>". ` +
+        `A comment that asks for new work on an issue with no agent: start one as above. Otherwise just record it.`,
+    );
+  }
+  if (s.sources.includes('reviews')) {
+    how.push(
+      `GitHub reviews: gh search prs --review-requested=@me --state=open --json url,title,repository,updatedAt. ` +
+        `For each pull request you haven't handled, start a review agent in its project: ${am} add @<project> "Review <the PR link>: read the change, check out the branch if needed, and write the review as comments for the person to post. Don't approve, request changes or post anything yourself."`,
+    );
+  }
+  if (s.sources.includes('ci')) {
+    how.push(
+      `Failing checks: gh search prs --author=@me --state=open --json url,title,repository, then gh pr checks <url> for each. ` +
+        `For a pull request with failing checks: if an agent already works on it (${am} ls --json lists each agent's PRs), tell that agent: ${am} tell <agent id> "Checks fail on <PR link>: <which checks>. Find out why and fix it." ` +
+        `Otherwise start one: ${am} add @<project> "Checks fail on <PR link>: find out why and fix it on that branch."`,
+    );
+  }
+  if (s.sources.includes('slack')) {
+    how.push(
+      `Slack: with your Slack tools, read direct messages to the person and messages that mention them, since your last check. ` +
+        `When one clearly asks for work in a known project, start an agent for it and include the message link in the request. Don't reply in Slack; record what you did.`,
+    );
+  }
+  return [
+    `You are the person's assistant inside AI Agent Manager (agentmgr). You run all the time in the background and work on their behalf: you find new work and start agents for it, so the work is under way before they look. You don't do the work yourself.`,
+    `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). ` +
+      `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.`,
+    s.notes ? `The person's notes for you:\n${s.notes}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n\n');
+}
+
+export class Assistant {
+  constructor({ manager, store, config = {}, log = (m) => console.log(`[agentmgr] ${m}`) }) {
+    this.manager = manager;
+    this.store = store;
+    this.config = config;
+    this.log = log;
+    store.data.assistant ??= {};
+    this.timer = setInterval(() => this.tick(), 30_000);
+    this.timer.unref?.();
+  }
+
+  close() {
+    clearInterval(this.timer);
+  }
+
+  get settings() {
+    return assistantSettings(this.config);
+  }
+
+  get state() {
+    return this.store.data.assistant;
+  }
+
+  /** The assistant agent, if there is one. */
+  agent() {
+    const id = this.state.agentId;
+    const a = id && this.store.get(id);
+    return a?.kind === 'assistant' ? a : null;
+  }
+
+  /** Change settings; kept in config.json by the caller. Running sessions get them on the next launch. */
+  update(patch = {}) {
+    if (patch.sources !== undefined && (!Array.isArray(patch.sources) || patch.sources.some((s) => !SOURCES[s]))) {
+      throw err(400, `sources must be a list of: ${Object.keys(SOURCES).join(', ')}`);
+    }
+    for (const k of ['everyMin', 'maxPerDay', 'maxRunning']) {
+      if (patch[k] !== undefined && !(Number(patch[k]) >= (k === 'everyMin' ? 1 : 0))) throw err(400, `${k} must be ${k === 'everyMin' ? 1 : 0} or more`);
+    }
+    const next = assistantSettings({ assistant: { ...this.config.assistant, ...patch } });
+    this.config.assistant = next;
+    return next;
+  }
+
+  /** Create the assistant if needed and start it; the first check follows once it is ready. */
+  start() {
+    let a = this.agent();
+    if (!a) {
+      const s = this.settings;
+      fs.mkdirSync(assistantDir(), { recursive: true });
+      a = this.manager.create({ kind: 'assistant', name: 'Assistant', permissionMode: s.permissionMode || undefined, model: s.model || undefined, start: true });
+      this.state.agentId = a.id;
+      this.state.nextAt = new Date(Date.now() + 20_000).toISOString();
+      this.store.save();
+      this.log('assistant started');
+      return this.status();
+    }
+    this.state.paused = false;
+    this.state.nextAt ??= new Date(Date.now() + 20_000).toISOString();
+    this.store.save();
+    if (!this.manager.runtimes.get(a.id)?.pty) this.manager.start(a.id);
+    return this.status();
+  }
+
+  /** Stop checking and close the session (it keeps its memory; start resumes it). */
+  async pause() {
+    const a = this.agent();
+    this.state.paused = true;
+    this.store.save();
+    if (a && this.manager.runtimes.get(a.id)?.pty) await this.manager.stop(a.id);
+    return this.status();
+  }
+
+  /** Ask for a check now (queued until the session is idle). */
+  check({ by = 'person' } = {}) {
+    const a = this.agent();
+    if (!a) throw err(409, 'The assistant is not set up yet: start it first');
+    const last = this.state.lastCheckAt;
+    const n = (this.state.checks ?? 0) + 1;
+    const text = `Check now (check ${n}, ${new Date().toISOString()}${last ? `; last check ${last}` : '; first check'}${by === 'person' ? ', asked by the person' : ''}).`;
+    this.manager.tell(a.id, text, { source: 'assistant' });
+    this.state.checks = n;
+    this.state.lastCheckAt = new Date().toISOString();
+    this.state.nextAt = new Date(Date.now() + this.settings.everyMin * 60_000).toISOString();
+    this.store.save();
+    return this.status();
+  }
+
+  /** The scheduler: a check every everyMin minutes while the assistant is on and free. */
+  tick(t = Date.now()) {
+    const a = this.agent();
+    // Paused, or closed by hand: no checks until it is started again.
+    if (!a || this.state.paused || a.desired === 'stopped') return;
+    if (Date.parse(this.state.nextAt ?? 0) > t) return;
+    const rt = this.manager.runtimes.get(a.id);
+    // Busy with the last check, or a message still waiting to be typed in: try again shortly.
+    if (rt?.busy || this.manager.outbox.get(a.id)?.length) return;
+    if (!rt?.pty && a.status === 'preparing') return;
+    try {
+      this.check({ by: 'schedule' });
+    } catch (e) {
+      this.log(`assistant: ${e.message}`);
+    }
+  }
+
+  /** Agents the assistant started. */
+  started() {
+    const a = this.agent();
+    return a ? this.store.list().filter((x) => x.startedBy === a.id) : [];
+  }
+
+  /**
+   * Called before the assistant's own session creates agents: enforces the daily cap, the cap on
+   * its running agents, and one agent per issue. Returns the creation options to add.
+   */
+  admit(callerId, intents, opts = {}) {
+    const a = this.agent();
+    if (!a || callerId !== a.id) return {};
+    const s = this.settings;
+    const mine = this.started();
+    const today = mine.filter((x) => Date.now() - Date.parse(x.createdAt) < DAY).length;
+    if (today + intents.length > s.maxPerDay) throw err(429, `The assistant's limit is ${s.maxPerDay} new agents a day (${today} so far); not started`);
+    const running = mine.filter((x) => this.manager.runtimes.get(x.id)?.pty || x.status === 'preparing').length;
+    if (running + intents.length > s.maxRunning) throw err(429, `The assistant's limit is ${s.maxRunning} of its agents running at once (${running} now); not started`);
+    for (const intent of intents) {
+      const key = opts.name?.trim() || leadingJiraKey(intent);
+      const dup = key && this.store.list().find((x) => x.kind === 'task' && x.name.toLowerCase() === key.toLowerCase());
+      if (dup) throw err(409, `An agent for ${key} already exists: ${dup.name} (${dup.id}); tell it instead`);
+    }
+    return { startedBy: a.id };
+  }
+
+  activity({ chars = 20_000 } = {}) {
+    try {
+      const text = fs.readFileSync(path.join(assistantDir(), 'activity.md'), 'utf8');
+      return text.length > chars ? text.slice(text.indexOf('\n## ', text.length - chars) + 1 || text.length - chars) : text;
+    } catch {
+      return '';
+    }
+  }
+
+  status() {
+    const a = this.agent();
+    const rt = a && this.manager.runtimes.get(a.id);
+    const mine = this.started();
+    return {
+      ...this.settings,
+      agentId: a?.id ?? null,
+      on: Boolean(a && !this.state.paused),
+      running: Boolean(rt?.pty),
+      busy: Boolean(rt?.busy),
+      checks: this.state.checks ?? 0,
+      lastCheckAt: this.state.lastCheckAt ?? null,
+      nextAt: a && !this.state.paused ? (this.state.nextAt ?? null) : null,
+      startedToday: mine.filter((x) => Date.now() - Date.parse(x.createdAt) < DAY).length,
+      startedTotal: mine.length,
+      started: mine
+        .sort((x, y) => y.createdAt.localeCompare(x.createdAt))
+        .slice(0, 20)
+        .map((x) => ({ id: x.id, name: x.name, intent: x.intent, createdAt: x.createdAt })),
+      activity: this.activity(),
+    };
+  }
+}