@sergeychuvayev/claude-fleet 0.4.0 → 0.6.0

package/README.md

@@ -405,3 +405,40 @@ MIT. See [LICENSE](LICENSE).
 <div align="center">
 <sub>Screenshots use synthetic sessions generated for the purpose. Fleet is not affiliated with Anthropic.</sub>
 </div>
+
+### Configurable teams and durable tasks
+
+In **New agent**, choose **Software delivery** to give a brief to a Manager backed by
+Product, Developer, Reviewer and QA roles. Choose **Customize team…** to save your own
+team: rename/add/remove roles, write their instructions, select a Claude model per role,
+and choose allowed tools. Built-in teams are copied; existing custom teams can be edited.
+The original Bug fix preset remains available for existing workflows.
+
+One role is the manager and at least one separate role is a required verifier. A third
+role owns the work. Fleet adds delegation and operator-question tools to the manager;
+workers report back to it. Manager roles cannot use the shell or edit tools. Verifiers
+cannot use direct edit tools; Bash, when enabled for tests, remains a general-purpose
+shell governed by the initiative's approval mode, not a read-only sandbox.
+
+Each initiative snapshots its team and works in its own Git worktree. Template edits
+apply to new initiatives. The Manager creates tasks with owners, acceptance criteria and
+dependencies through Fleet's task tool. The initiative inspector shows the roster,
+task states, assignments and returned reports. Verification comes from actual subagent
+reports, including each required verifier's PASS/FAIL; the Manager cannot mark a task
+verified itself. A failed review returns work for repair and invalidates the previous
+attempt's reviews. “Verified” records the configured agents' verdicts for that attempt,
+not a guarantee that their evaluation is correct or that later work cannot regress it.
+
+Delegations run sequentially in the shared initiative worktree. After an interruption,
+the saved task board survives and unfinished delegations are marked interrupted. Message
+the Manager to resume. The initial limits are three implementation attempts per task and
+$10 in reported SDK usage; **Adjust limits** changes them explicitly while idle. The SDK
+budget is an execution cutoff, not a billing guarantee: usage is reported at turn end,
+and a killed runtime may not report its final spend. Each turn also has a 100-turn SDK
+limit and bounded continuation reminders.
+
+Custom teams live in `teams.json` under Fleet's state directory; task history and team
+snapshots live with the initiative in `sessions.json`. This version supports models
+available through the Claude Agent SDK, up to eight roles per team, and 100 tasks per
+initiative. It finishes at a local branch ready for review; it does not automatically
+publish or merge changes.

package/managed.js

@@ -8,6 +8,8 @@ const { gitBranch, turnSummary, toolTarget } = require('./fleet')
 const { askReason, normaliseMode, MODES, DEFAULT_MODE } = require('./permissions')
 const { stateDir } = require('./paths')
 const { getTeam, compile } = require('./teams')
+const { TeamStore } = require('./team-store')
+const tasks = require('./tasks')
 const worktrees = require('./worktree')
 
 const ACTIVE = new Set(['starting', 'running', 'approval', 'stopping'])
@@ -36,6 +38,9 @@ const MAX_TOOL_INPUT = 2000
 const MAX_TOOL_RESULT = 6000
 // Tool names whose result is the point of the block; others are summarised by their input.
 const QUIET_RESULT = new Set(['TodoWrite', 'Write', 'Edit', 'NotebookEdit'])
+// A delegation can run a sub-agent through an unbounded number of tool calls; capped here
+// so a long-running one cannot grow the session file without limit.
+const MAX_DELEGATION_STEPS = 200
 function fail(message, status = 400) { const error = new Error(message); error.status = status; throw error }
 function text(value, name, max) {
   if (typeof value !== 'string' || !value.trim() || value.length > max) fail(`${name} must contain 1–${max} characters.`)
@@ -65,12 +70,14 @@ class ManagedSessions extends EventEmitter {
     this.lock = path.join(directory, 'server.lock')
     this.acquireLock()
     try {
+      this.teams = new TeamStore(directory)
       if (fs.existsSync(this.file)) {
         const data = JSON.parse(fs.readFileSync(this.file, 'utf8'))
         if (data.version !== 1 || !Array.isArray(data.sessions)) throw new Error('Unsupported session store format')
         for (const s of data.sessions) {
           if (!s.id || !Array.isArray(s.messages)) throw new Error('Invalid saved session')
           if (ACTIVE.has(s.status)) { s.status = 'stopped'; s.error = 'Fleet restarted. Send a message to continue this conversation.' }
+          tasks.interrupt(s)
           s.approvals = []
           s.currentTool = null
           for (const m of s.messages) if (m.role === 'tool' && m.status === 'running') m.status = 'interrupted'
@@ -148,7 +155,7 @@ class ManagedSessions extends EventEmitter {
       permissionMode:'default', approvalMode:s.approvalMode || DEFAULT_MODE, selectedModel:s.selectedModel || '', messages:s.messages.filter(m=>m.role!=='tool').length, links:linksFromMessages(s.messages), approvals:s.approvals.length,
       turn:turnSummary(managedEvents(s.messages), { working: ACTIVE.has(s.status) && s.status !== 'approval' }),
       error:s.error, currentTool:s.currentTool, resumeCmd:s.sessionId ? `claude --resume ${s.sessionId}` : null,
-      kind:s.kind || 'agent', teamId:s.teamId || null, teamName:s.teamName || null,
+      kind:s.kind || 'agent', teamId:s.teamId || null, teamName:s.teamName || null, taskProgress:tasks.progress(s),
       worktreeBranch:s.worktree?.branch || null, costUsd:s.costUsd || 0,
     }))
   }
@@ -176,12 +183,12 @@ class ManagedSessions extends EventEmitter {
     this.checkCapacity()
     // A team turns this conversation into an initiative: the manager takes the main thread
     // and the work happens on a branch of its own rather than in the operator's checkout.
-    const team = body.teamId ? getTeam(text(body.teamId,'Team',60)) : null
+    const team = body.teamId ? this.teams.get(text(body.teamId,'Team',60)) : null
     if (body.teamId && !team) fail('That team does not exist.')
     if (team && resume) fail('A resumed conversation cannot be given a team.',409)
     const id = randomUUID()
     const worktree = team ? worktrees.create({cwd,id,name}) : null
-    const s = {id,sessionId:resume,name,cwd:worktree ? worktree.path : cwd,createRequestId:rid,createdAt:Date.now(),updatedAt:Date.now(),status:'idle',approvalMode:normaliseMode(body.approvalMode),selectedModel:modelChoice(body.model),messages:[],approvals:[],model:null,contextTokens:null,error:null,currentTool:null,requestIds:[],kind:team ? 'initiative' : 'agent',teamId:team?.id || null,teamName:team?.name || null,worktree}
+    const s = {id,sessionId:resume,name,cwd:worktree ? worktree.path : cwd,createRequestId:rid,createdAt:Date.now(),updatedAt:Date.now(),status:'idle',approvalMode:normaliseMode(body.approvalMode),selectedModel:modelChoice(body.model),messages:[],approvals:[],model:null,contextTokens:null,error:null,currentTool:null,requestIds:[],kind:team ? 'initiative' : 'agent',teamId:team?.id || null,teamName:team?.name || null,teamSnapshot:team ? structuredClone(team) : null,taskBoard:team?.workflow ? {tasks:[],delegations:[]} : null,worktree}
     this.sessions.set(s.id,s)
     try { this.send(s.id,{message:prompt,images:body.images,requestId:rid}) }
     catch (error) { this.sessions.delete(s.id); if (worktree) worktrees.remove(worktree); throw error }
@@ -278,8 +285,41 @@ class ManagedSessions extends EventEmitter {
       // `agent` puts the manager on the main thread, so the operator's messages reach it and
       // nobody else; `agents` is where the Agent tool resolves the rest of the team from.
       // Both compose with the claude_code preset above, which keeps the built-in tools.
-      const team = getTeam(s.teamId)
-      if (team) Object.assign(options, compile(team))
+      const team = s.teamSnapshot || getTeam(s.teamId)
+      if (team) {
+        Object.assign(options, compile(team))
+        if (s.selectedModel) options.agents[team.manager].model=s.selectedModel
+      }
+      if (team?.workflow) {
+        const remaining=(s.limits?.budgetUsd ?? team.workflow.budgetUsd)-(s.costUsd || 0)
+        if (remaining<=0) throw new Error('Usage cap reached. Increase the cap explicitly before continuing.')
+        options.maxBudgetUsd=remaining
+        options.maxTurns=100
+        options.mcpServers={fleet:await tasks.sdkServer(s,()=>this.changed(s,true))}
+        options.hooks={
+          PreToolUse:[{hooks:[async input=>{
+            if (!['Agent','Task'].includes(input.tool_name)) return {}
+            const before=structuredClone(s.taskBoard)
+            let applied=false
+            try {
+              const delegation=tasks.start(s,input.tool_use_id,input.tool_input)
+              applied=true
+              const task=s.taskBoard.tasks.find(t=>t.id===delegation.taskId)
+              this.changed(s,true)
+              return {hookSpecificOutput:{hookEventName:'PreToolUse',updatedInput:{...input.tool_input,prompt:input.tool_input.prompt+`\n\nFleet acceptance criteria:\n${task.criteria.map(c=>'- '+c).join('\n')}\nReturn PASS or FAIL with evidence if you are verifying. Do not edit source while verifying.`}}}
+            } catch(error) {if(applied)s.taskBoard=before;return {hookSpecificOutput:{hookEventName:'PreToolUse',permissionDecision:'deny',permissionDecisionReason:error.message}}}
+          }]}],
+          Stop:[{hooks:[async ()=>{
+            const unfinished=s.taskBoard.tasks.filter(t=>!['verified','blocked'].includes(t.status) && t.attempt<(s.limits?.maxAttempts ?? team.workflow.maxAttempts))
+            if (unfinished.length && (run.continuations || 0)<2) {
+              run.continuations=(run.continuations || 0)+1
+              return {decision:'block',reason:'Fleet tasks remain unfinished. Read the board and continue implementation/verification, or record a concrete blocker before stopping.'}
+            }
+            return {}
+          }]}],
+          SubagentStart:[{hooks:[async input=>{run.agentRoles ||= new Map();run.agentRoles.set(input.agent_id,input.agent_type);return {}}]}],
+        }
+      }
       if (process.env.CLAUDE_FLEET_EXECUTABLE) options.pathToClaudeCodeExecutable = process.env.CLAUDE_FLEET_EXECUTABLE
       run.query = await this.queryFactory({prompt,options})
       if (run.stopping) { run.query.close(); return }
@@ -297,6 +337,12 @@ class ManagedSessions extends EventEmitter {
       run.finished = true
       this.cancelApprovals(s.id,'The agent stopped before this request was answered.')
       try { run.query?.close() } catch {}
+      // Only a delegation that is itself still running was actually interrupted here; a
+      // delegation that already finished may carry a step whose tool_result simply never
+      // arrived, and flipping that step to "interrupted" next to a completed delegation
+      // would misreport a race as a stop.
+      if (s.taskBoard) for (const d of s.taskBoard.delegations) if (d.status === 'running') for (const step of d.steps || []) if (step.status === 'running') step.status = 'interrupted'
+      tasks.interrupt(s)
       for (const entry of run.tools?.values() || []) if (entry.status === 'running') entry.status = 'interrupted'
       if (run.stopping) s.status='stopped'
       else if (s.status !== 'error') s.status='idle'
@@ -306,7 +352,24 @@ class ManagedSessions extends EventEmitter {
     }
   }
   event(s,run,event) {
-    if (event.session_id) s.sessionId=event.session_id
+    if (event.session_id && !event.parent_tool_use_id) s.sessionId=event.session_id
+    if (s.taskBoard && event.parent_tool_use_id) {
+      const d=s.taskBoard.delegations.find(d=>d.id===event.parent_tool_use_id)
+      if (d && event.type==='assistant') {
+        const content=event.message.content || []
+        d.activity=content.filter(b=>b.type==='tool_use').map(b=>b.name).join(', ') || d.activity
+        d.model=event.message.model || d.model
+        const output=content.filter(b=>b.type==='text').map(b=>b.text).join('\n')
+        if (output) d.output=output.slice(0,24000)
+        // The one place a sub-agent's own tool calls are kept at all: as steps on its
+        // delegation, never as messages (every branch above stays guarded by
+        // `!event.parent_tool_use_id`). No input, no result; those belong to d.report.
+        for (const block of content) if (block.type==='tool_use') this.stepStarted(d,block)
+      }
+      if (d && event.type==='user') {
+        for (const block of event.message?.content || []) if (block.type==='tool_result') this.stepFinished(d,block)
+      }
+    }
     if (event.type === 'system' && event.subtype === 'init') { s.model=event.model; s.status='running' }
     if (event.type === 'stream_event' && !event.parent_tool_use_id) {
       if (event.event.type === 'message_start') { run.assistant=null; run.streamText='' }
@@ -336,6 +399,7 @@ class ManagedSessions extends EventEmitter {
       for (const block of event.message?.content || []) if (block.type==='tool_result') this.toolFinished(s,run,block)
     }
     if (event.type === 'tool_progress') s.currentTool=event.tool_name
+    if (s.taskBoard && event.type==='system' && event.subtype==='task_notification' && event.tool_use_id && event.status!=='completed') tasks.finish(s,event.tool_use_id,event.summary,true)
     if (event.type === 'result') {
       run.result=true
       if (event.is_error) { s.status='error'; s.error=event.errors?.join('\n') || event.result || 'Claude could not finish this turn.' }
@@ -364,9 +428,46 @@ class ManagedSessions extends EventEmitter {
     entry.status = block.is_error ? 'error' : 'done'
     entry.ms = Date.now()-entry.at
     const result = resultText(block.content)
+    if (s.taskBoard) {
+      tasks.finish(s,block.tool_use_id,result,!!block.is_error)
+      // The delegation just reached a terminal status. A step whose own tool_result
+      // never arrived from the sub-agent can no longer resolve on its own, by
+      // definition; left as "running" it would look like a live step under a
+      // finished delegation, so it gets its own terminal label instead.
+      const d=s.taskBoard.delegations.find(d=>d.id===block.tool_use_id)
+      if (d && d.status!=='running') for (const step of d.steps || []) if (step.status==='running') step.status='unreported'
+    }
     entry.truncated = result.length > MAX_TOOL_RESULT
     entry.result = block.is_error || !QUIET_RESULT.has(entry.tool) ? result.slice(0,MAX_TOOL_RESULT) : null
   }
+  // A sub-agent's tool call becomes a step on its delegation rather than a conversation
+  // entry: name, target, status and timing only, so the operator can see what happened
+  // without the console ever rendering it.
+  stepStarted(d,block) {
+    if (!block.id) return
+    d.steps ||= []
+    if (d.steps.some(step=>step.id===block.id)) return
+    d.steps.push({id:block.id,tool:block.name || 'Tool',target:toolTarget(block.name,block.input),status:'running',at:Date.now(),ms:null})
+    if (d.steps.length > MAX_DELEGATION_STEPS) { d.steps=d.steps.slice(-MAX_DELEGATION_STEPS); d.stepsTruncated=true }
+  }
+  stepFinished(d,block) {
+    const step=d.steps?.find(step=>step.id===block.tool_use_id)
+    if (!step || step.status!=='running') return
+    step.status=block.is_error ? 'error' : 'done'
+    step.ms=Date.now()-step.at
+  }
+  setLimits(id,body) {
+    const s=this.get(id)
+    if (!s.teamSnapshot?.workflow) fail('This initiative does not have configurable limits.')
+    if (this.runs.has(id)) fail('Stop the manager before changing its limits.',409)
+    const {budgetUsd,maxAttempts}=body
+    if (!Number.isFinite(budgetUsd) || budgetUsd<0.1 || budgetUsd>1000 || budgetUsd<(s.costUsd || 0)) fail('Choose a usage cap between the amount already used and $1,000 (minimum $0.10).')
+    if (!Number.isInteger(maxAttempts) || maxAttempts<1 || maxAttempts>10) fail('Choose 1–10 attempts per task.')
+    const previous=s.limits
+    s.limits={budgetUsd,maxAttempts}
+    try {this.changed(s,true)} catch(error) {s.limits=previous;throw error}
+    return s
+  }
   setModelChoice(id,body) {
     const s=this.get(id)
     s.selectedModel=modelChoice(body.model)
@@ -387,7 +488,7 @@ class ManagedSessions extends EventEmitter {
     if (!reason) return Promise.resolve({behavior:'allow',updatedInput:input})
     return new Promise(resolve => {
       const id=randomUUID()
-      const approval={id,tool,input,at:Date.now(),reason,description:context.title || context.decisionReason || null,role:roleAsking(s,context)}
+      const approval={id,tool,input,at:Date.now(),reason,description:context.title || context.decisionReason || null,role:run.agentRoles?.get(context.agentID) || roleAsking(s,context)}
       let settled=false
       const finish=result=>{
         if(settled)return
@@ -461,7 +562,7 @@ class ManagedSessions extends EventEmitter {
 // from the delegation that is in flight. With two delegations running at once that is
 // ambiguous, and an honest null beats a confident guess at the wrong role.
 function roleAsking(s,context) {
-  const team = getTeam(s.teamId)
+  const team = s.teamSnapshot || getTeam(s.teamId)
   if (!team) return null
   // No agentID means the request came from the main thread, which is the manager by
   // definition. The role name comes from the team rather than a literal, because a future

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sergeychuvayev/claude-fleet",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "A local control room for Claude Code sessions",
   "keywords": [
     "claude",
@@ -37,7 +37,9 @@
     "teams.js",
     "theme.js",
     "update.js",
-    "worktree.js"
+    "worktree.js",
+    "team-store.js",
+    "tasks.js"
   ],
   "scripts": {
     "start": "node bin/claude-fleet.js start",
@@ -57,7 +59,8 @@
     "@anthropic-ai/claude-agent-sdk": "0.3.177",
     "dompurify": "^3.4.15",
     "highlight.js": "^11.12.0",
-    "marked": "^18.0.13"
+    "marked": "^18.0.13",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "esbuild": "^0.28.2"

package/public/app.js

@@ -13,17 +13,28 @@ const age = timestamp => {
   return secs < 60 ? `${secs}s` : secs < 3600 ? `${Math.floor(secs/60)}m` : secs < 86400 ? `${Math.floor(secs/3600)}h` : `${Math.floor(secs/86400)}d`
 }
 let snapshot = null, filter = 'all', selected = null, pending = false, toastTimer
+// A delegation row nested under a team session. Keyed on the delegation id, never on
+// its position or status, so a sub-agent finishing does not move the operator's focus.
+let selectedChild = null, childDetail = null, childDetailFor = null, childDetailError = null, childRequest = 0, lastChildId = null
+const DELEGATION_LABEL = { running: 'Working', completed: 'Done', failed: 'Failed', interrupted: 'Interrupted' }
+const DELEGATION_BADGE = { running: 'busy', completed: 'idle', failed: 'hot', interrupted: 'stale' }
+const STEP_LABEL = { running: 'Running', done: 'Done', error: 'Failed', interrupted: 'Interrupted', unreported: 'Unreported' }
+const formatModel = m => m ? String(m).replace('claude-', '') : 'Model pending'
+// A child row shares its data-session with the parent that owns it, so the session
+// id alone is not a unique row key: folding in data-delegation is what tells a
+// delegation row apart from its parent when the list redraws underneath focus.
+const rowFocusKey = b => b.dataset.delegation ? `${b.dataset.session}::${b.dataset.delegation}` : b.dataset.session || b.dataset.filter
 function update(id, html) {
   const el = $(id)
   if (!el || el.innerHTML === html) return
   const active = document.activeElement
-  const focusKey = el.contains(active) ? active.dataset.session || active.dataset.filter : null
+  const focusKey = el.contains(active) ? rowFocusKey(active) : null
   const top = el.scrollTop
   const responseTop = el.querySelector('.response')?.scrollTop || 0
   el.innerHTML = html
   el.scrollTop = top
   if (el.querySelector('.response')) el.querySelector('.response').scrollTop = responseTop
-  if (focusKey) [...el.querySelectorAll('button')].find(b => b.dataset.session === focusKey || b.dataset.filter === focusKey)?.focus({ preventScroll: true })
+  if (focusKey) [...el.querySelectorAll('button')].find(b => rowFocusKey(b) === focusKey)?.focus({ preventScroll: true })
 }
 function status(s) {
   // A Fleet conversation resumed in a terminal is driven there, whatever Fleet last recorded.
@@ -77,6 +88,33 @@ function markSeen(k, at) {
 }
 const hasUnseen = s => !!s.lastActivity && key(s) !== selected && (seen[key(s)] || 0) < s.lastActivity
 
+// A Task-tool sub-agent never gets a process of its own, so this is the only row it
+// ever gets: nested under the session that ran it, for as long as that session lives.
+function childRowHtml(s, d) {
+  const cls = DELEGATION_BADGE[d.status] || ''
+  const label = DELEGATION_LABEL[d.status] || d.status
+  return `<button class="session session-child" data-session="${esc(key(s))}" data-delegation="${esc(d.id)}" aria-pressed="${selectedChild === d.id}" aria-controls="detail"><span><span class="session-top"><span class="badge ${cls}"><span class="dot"></span>${esc(label)}</span><span class="session-name">⑂ ${esc(d.role)}</span></span><span class="session-title">${esc(formatModel(d.model))}</span></span><span class="session-context"></span></button>`
+}
+// An initiative that runs long enough accumulates delegations without bound; the
+// row list stays a list, not a scrollbar of its own, by showing only the tail.
+const CHILD_ROW_LIMIT = 20
+const childRowsHtml = s => {
+  const all = s.delegations || []
+  const recent = all.length > CHILD_ROW_LIMIT ? all.slice(-CHILD_ROW_LIMIT) : all
+  // The parent row has already handed its aria-pressed to session-ancestor, so a
+  // selected delegation that aged out of the tail must still be drawn here, however
+  // old it is, or nothing in the list reads as selected at all.
+  const selectedOutside = selectedChild && !recent.some(d => d.id === selectedChild) ? all.find(d => d.id === selectedChild) : null
+  const shown = selectedOutside ? [selectedOutside, ...recent] : recent
+  const earlier = all.length - shown.length
+  // The list is oldest-first, so what got cut is the oldest end of it: the marker
+  // belongs ahead of the rows that survived, not trailing the newest one. It is a
+  // plain, non-interactive node in the reading order — no role, no aria-hidden — so
+  // it is announced once when it appears rather than looping as a live region or
+  // vanishing from every screen reader that ignores an injected one.
+  return (earlier ? `<div class="session-child-more">+${earlier} earlier</div>` : '') + shown.map(d => childRowHtml(s, d)).join('')
+}
+
 function render() {
   if (!snapshot) return
   const {sessions, total} = snapshot
@@ -103,12 +141,32 @@ function render() {
   renderArchiveBar(live.filter(s => s.state === 'dead'), archived.length)
   update('session-list', shown.length ? shown.map(s => {
     const p = percent(s)
-    return `<button class="session" data-session="${esc(key(s))}" aria-pressed="${selected === key(s)}" aria-controls="detail" title="${hasUnseen(s) ? 'New output since you last opened this' : ''}"><span><span class="session-top">${hasUnseen(s) ? '<span class="unseen" aria-label="New output"></span>' : ''}${status(s)}<span class="session-name">${esc((s.managed ? 'FLEET · ' : '') + (s.name || s.shortId || 'Unnamed session'))}</span>${spawnCounts.get(s.pid) ? `<span class="spawn-badge" title="Running ${spawnCounts.get(s.pid)} background session(s)">⑂ ${spawnCounts.get(s.pid)}</span>` : ''}${s.background ? `<span class="spawn-owner" title="Started by ${esc(s.spawnedByName || 'a program')}, not from a terminal">via ${esc(s.spawnedByName || 'a program')}</span>` : ''}${s.archived ? '<span class="archived-tag" title="Archived. Hidden from your fleet, still on disk and still resumable.">archived</span>' : ''}</span>${s.kind === 'initiative' ? `<span class="initiative-tag">Initiative · ${esc(s.teamName || s.teamId || 'Team')}</span>` : ''}<span class="session-title">${esc(s.title || s.lastPrompt || 'Untitled session')}</span><span class="session-meta"><span>${esc(s.cwd?.split('/').filter(Boolean).pop() || 'No project')}</span><span class="branch">⑂ ${esc(s.branch || 'No branch')}</span>${s.links?.length ? `<span>↗ ${s.links.length}</span>` : ''}${money(s.costUsd) ? `<span class="session-cost" title="What this conversation has cost so far">${esc(money(s.costUsd))}</span>` : ''}</span>${turnRow(s)}</span><span class="session-context ${heat(p)}">${p === null ? '—' : Math.round(p)+'%'}<span class="mini-bar"><i class="${heat(p)}" style="width:${p || 0}%"></i></span><small>${age(s.lastActivity)} ago</small></span></button>`
+    const childSelectedHere = !!selectedChild && (s.delegations || []).some(d => d.id === selectedChild)
+    return `<button class="session${childSelectedHere ? ' session-ancestor' : ''}" data-session="${esc(key(s))}" aria-pressed="${selected === key(s) && !childSelectedHere}" aria-controls="detail" title="${hasUnseen(s) ? 'New output since you last opened this' : ''}"><span><span class="session-top">${hasUnseen(s) ? '<span class="unseen" aria-label="New output"></span>' : ''}${status(s)}<span class="session-name">${esc((s.managed ? 'FLEET · ' : '') + (s.name || s.shortId || 'Unnamed session'))}</span>${spawnCounts.get(s.pid) ? `<span class="spawn-badge" title="Running ${spawnCounts.get(s.pid)} background session(s)">⑂ ${spawnCounts.get(s.pid)}</span>` : ''}${s.background ? `<span class="spawn-owner" title="Started by ${esc(s.spawnedByName || 'a program')}, not from a terminal">via ${esc(s.spawnedByName || 'a program')}</span>` : ''}${s.archived ? '<span class="archived-tag" title="Archived. Hidden from your fleet, still on disk and still resumable.">archived</span>' : ''}</span>${s.kind === 'initiative' ? `<span class="initiative-tag">Initiative · ${esc(s.teamName || s.teamId || 'Team')}${s.taskProgress ? ` · ${s.taskProgress.verified}/${s.taskProgress.total} verified${s.taskProgress.blocked ? ` · ${s.taskProgress.blocked} need attention` : ''}` : ''}</span>` : ''}<span class="session-title">${esc(s.title || s.lastPrompt || 'Untitled session')}</span><span class="session-meta"><span>${esc(s.cwd?.split('/').filter(Boolean).pop() || 'No project')}</span><span class="branch">⑂ ${esc(s.branch || 'No branch')}</span>${s.links?.length ? `<span>↗ ${s.links.length}</span>` : ''}${money(s.costUsd) ? `<span class="session-cost" title="What this conversation has cost so far">${esc(money(s.costUsd))}</span>` : ''}</span>${turnRow(s)}</span><span class="session-context ${heat(p)}">${p === null ? '—' : Math.round(p)+'%'}<span class="mini-bar"><i class="${heat(p)}" style="width:${p || 0}%"></i></span><small>${age(s.lastActivity)} ago</small></span></button>${childRowsHtml(s)}`
   }).join('') : `<div class="empty">${filter === 'background' ? 'No background sessions right now.' : total ? 'No sessions match your filters.<br>Try another search or select All sessions.' : 'Your fleet is quiet.<br>Start a Claude Code session and it will appear here automatically.'}</div>`)
   const current = shown.find(s => key(s) === selected)
   if (current) markSeen(key(current), current.lastActivity)
-  renderDetail(current)
-  if (typeof selectControl === 'function') selectControl(current)
+  // A delegation belongs to whichever session is actually current; switching sessions,
+  // or the owning session dropping out of the current filter, clears a stale child pick.
+  const childId = selectedChild && current?.delegations?.some(d => d.id === selectedChild) ? selectedChild : null
+  selectedChild = childId
+  // A fresh fetch on every genuine transition, including back to a child left moments
+  // ago: childDetailFor otherwise still names it "loaded" even after its cache was
+  // cleared by the visit in between, and the view would be stuck on "Loading…".
+  if (childId !== lastChildId) {
+    lastChildId = childId
+    if (childId) { childDetail = null; childDetailFor = null; childDetailError = null; loadChildDetail(current.managedId, childId) }
+  }
+  if (childId) {
+    renderChildDetail(current, childId)
+    // A sub-agent is not addressable: clearing the control panel drops its composer
+    // and conversation from the DOM entirely, not merely hiding them.
+    if (typeof selectControl === 'function') selectControl(null)
+  } else {
+    renderDetail(current)
+    if (typeof selectControl === 'function') selectControl(current)
+  }
+  syncDetails()
 }
 // ── The archive ──────────────────────────────────────────────────────────────
 // Putting a session away hides its row and nothing else: the transcript stays in
@@ -163,6 +221,44 @@ function renderDetail(s) {
   const facts = [['Project',s.cwdShort],['Branch',s.branch],['Model',s.model?.replace('claude-','')],['Permissions',s.permissionMode || 'Default'],['Control',s.managed ? 'Fleet-managed' : s.alive ? 'Terminal · monitor only' : 'Saved · ready to continue'],['Session',s.sessionId]]
   update('detail-content', `<div class="detail-top"><span class="eyebrow">SESSION INSPECTOR</span>${status(s)}</div><h2>${esc(s.title || s.name || 'Untitled session')}</h2><div class="detail-name">${esc(s.name || s.shortId)} · Active ${age(s.lastActivity)} ago</div><div class="context-label"><span>Context window</span><span class="${heat(p)}">${p === null ? 'Not available' : `${tokens(s.contextTokens)} / ${tokens(s.contextLimit)} · ${Math.round(p)}%`}</span></div><div class="mini-bar"><i class="${heat(p)}" style="width:${p || 0}%"></i></div>${p >= 75 ? `<p class="note ${heat(p)}">${p >= 90 ? 'Context nearly full. Compaction may happen soon.' : 'Context is getting full.'}</p>` : ''}${s.managed ? '' : `<section class="detail-section"><h3>Latest response <span>${s.latestResponseAt ? age(s.latestResponseAt)+' ago' : ''}</span></h3><div class="response ${s.latestResponse ? '' : 'missing'}">${esc(s.latestResponse || 'No assistant response recorded yet.')}</div></section>`}${s.lastPrompt && !s.managed ? `<section class="detail-section"><h3>Latest request</h3><div class="response">${esc(s.lastPrompt)}</div></section>` : ''}<section class="detail-section"><h3>Linked work <span>From transcript</span></h3>${links.length ? `<div class="links">${links.map(l => `<a class="work-link" href="${esc(l.url)}" target="_blank" rel="noopener noreferrer" title="${esc(l.url)}">${l.kind === 'pr' ? '⑂' : '◩'} ${esc(l.label)} ↗</a>`).join('')}</div><p class="note" style="margin-top:9px">Recorded references, not live status.</p>` : '<p class="note">GitHub PR and Linear issue URLs appear here when mentioned in the conversation.</p>'}</section><section class="detail-section"><h3>Environment</h3><dl class="facts">${facts.map(([label,value]) => `<dt>${label}</dt><dd>${esc(value ?? '—')}</dd>`).join('')}</dl></section>${s.transcriptTruncated ? '<p class="note">Showing the most recent 6 MB of this transcript. Earlier responses and links may be absent.</p>' : ''}${s.archived ? '<p class="note archived-note">Archived. Hidden from your fleet, still on disk, still resumable and still searchable.</p>' : ''}<div class="detail-actions"><span class="subtle">${s.messages} recorded messages</span><span class="detail-buttons">${s.managed || !s.sessionId ? '' : `<button class="button" id="toggle-archive">${s.archived ? 'Restore' : 'Archive'}</button>`}${s.resumeCmd && !s.managed ? '<button class="button resume" id="copy-resume">Copy resume command ↗</button>' : ''}</span></div>`)
 }
+// A sub-agent's row: its mandate, its returned report and the steps it actually took.
+// Read only — there is no composer here and nothing that could send it more input.
+function renderChildDetail(s, delegationId) {
+  const compact = s.delegations?.find(d => d.id === delegationId)
+  if (!compact) return
+  const full = childDetailFor === delegationId ? childDetail : null
+  // The list poll and the session-detail fetch land independently; the list is the
+  // one running every couple of seconds, so its status is never staler than the
+  // detail fetch's, and the badge should never lag a row it sits right next to.
+  const state = compact.status
+  const cls = DELEGATION_BADGE[state] || ''
+  const label = DELEGATION_LABEL[state] || state
+  const steps = full?.steps || []
+  // Selecting a child tears down the console, so an approval sitting on the owning
+  // session would otherwise wait in total silence. A notice only: nothing here can
+  // answer it, so it just points the operator back to the row that can.
+  const approvalNotice = s.managedStatus === 'approval' ? `<p class="note child-approval-notice">${esc(s.name || s.title || 'This session')} needs your approval to continue. Select its row above to respond — this read-only view can’t.</p>` : ''
+  const stepsHtml = steps.length ? `<ol class="child-steps">${steps.map(step => `<li class="child-step" data-status="${esc(step.status)}"><span class="child-step-tool">${esc(step.tool)}</span>${step.target ? `<span class="child-step-target">${esc(step.target)}</span>` : ''}<span class="child-step-state">${esc(STEP_LABEL[step.status] || step.status)}</span><span class="child-step-time">${step.ms != null ? elapsed(step.ms) : step.status === 'running' ? 'running…' : ''}</span></li>`).join('')}</ol>` : `<p class="note">${full ? 'No tool steps recorded.' : 'Loading steps…'}</p>`
+  update('detail-content', `<div class="detail-top"><span class="eyebrow">SUB-AGENT · READ ONLY</span><span class="badge ${cls}"><span class="dot"></span>${esc(label)}</span></div>${approvalNotice}<h2>⑂ ${esc(compact.role)}</h2><div class="detail-name">${esc(formatModel(full?.model || compact.model))}</div><section class="detail-section"><h3>Mandate</h3><div class="response">${esc(full ? (full.prompt || 'No mandate recorded.') : 'Loading…')}</div></section><section class="detail-section"><h3>Steps${full?.stepsTruncated ? ' <span>Showing the most recent 200</span>' : ''}</h3>${stepsHtml}</section><section class="detail-section"><h3>Report to the manager</h3><div class="response ${full?.report ? '' : 'missing'}">${esc(full ? (full.report || 'Waiting for this agent’s report.') : 'Loading…')}</div></section>${childDetailError ? `<p class="note">${esc(childDetailError)}</p>` : ''}<p class="note">A sub-agent is not addressable on its own. This is a read-only report back to the manager.</p>`)
+}
+// The list payload only ever carries id/role/model/status for a delegation; its steps,
+// mandate and report live on the session detail route, fetched independently of the
+// manager's own control panel so viewing one never depends on that panel being mounted.
+async function loadChildDetail(managedId, delegationId) {
+  if (typeof api !== 'function') return
+  const requestId = ++childRequest
+  try {
+    const data = await api(`/api/managed/${managedId}`)
+    if (requestId !== childRequest || selectedChild !== delegationId) return
+    childDetail = data.session?.taskBoard?.delegations?.find(d => d.id === delegationId) || null
+    childDetailFor = delegationId
+    childDetailError = null
+  } catch (error) {
+    if (requestId === childRequest && selectedChild === delegationId) childDetailError = error.message || 'Could not load this delegation.'
+  } finally {
+    if (requestId === childRequest && selectedChild === delegationId) render()
+  }
+}
 // ── Modals ───────────────────────────────────────────────────────────────────
 // Ask and New agent are overlays, not panels that push the workspace down. One at
 // a time, Escape and backdrop close them, Tab stays inside, and focus returns to
@@ -219,8 +315,11 @@ document.addEventListener('click', async event => {
   const b = event.target.closest('button')
   if (!b) return
   if (b.dataset.filter) { filter = b.dataset.filter; render() }
-  if (b.dataset.session) {
-    selected = b.dataset.session; render()
+  if (b.dataset.delegation) {
+    selected = b.dataset.session; selectedChild = b.dataset.delegation; render()
+    if (matchMedia('(max-width:720px)').matches) $('detail').scrollIntoView({behavior:'instant',block:'start'})
+  } else if (b.dataset.session) {
+    selected = b.dataset.session; selectedChild = null; render()
     if (matchMedia('(max-width:720px)').matches) $('detail').scrollIntoView({behavior:'instant',block:'start'})
   }
   if (b.id === 'archive-sweep') return setArchived(sweepTargets().map(s => s.sessionId), true)
@@ -245,6 +344,12 @@ async function tick() {
     const data = await r.json()
     if (!Array.isArray(data.sessions) || !data.counts) throw new Error('Invalid response')
     snapshot = data; render()
+    // A selected delegation keeps polling its own steps and report at the same cadence
+    // as everything else, independent of whether the manager's own panel is mounted.
+    if (selectedChild) {
+      const owner = data.sessions.find(s => s.delegations?.some(d => d.id === selectedChild))
+      if (owner?.managedId) loadChildDetail(owner.managedId, selectedChild)
+    }
     // Other panels (the ask results) re-read the snapshot to refresh "open now" state.
     document.dispatchEvent(new CustomEvent('fleet-snapshot'))
     $('connection').textContent = 'Live connection'; $('connection-dot').className = 'dot busy'

package/public/control.js

@@ -29,14 +29,16 @@ function updateLaunchTeam() {
   $('launch-title').textContent=resumeSource ? 'Continue this conversation in Fleet.' : team ? 'Give your team a brief.' : 'Give your next task a home.'
   document.querySelector('label[for="launch-prompt"]').textContent=team ? 'Brief for the manager' : 'What are we working on?'
   document.querySelector('.launch-task-note').textContent=team ? `You talk to the ${team.manager || 'manager'}. They delegate to the team and bring the reports back here.` : 'Big ideas, small fixes. Every task starts here.'
-  $('launch-prompt').placeholder=team ? 'Describe the goal, boundaries, verification steps, and what a good result looks like.' : 'There’s something I’d love your help with…\n\nDescribe the task, what a good result looks like, and anything your agent should know.'
+  $('launch-prompt').placeholder=team ? 'Describe what you want to accomplish. Your manager will work out the tasks and bring back any questions.' : 'There’s something I’d love your help with…\n\nDescribe the task, what a good result looks like, and anything your agent should know.'
   if(!$('launch-submit').disabled) $('launch-submit').textContent=team ? 'Launch initiative ↗' : 'Launch agent ↗'
+  if($('customize-team')) $('customize-team').disabled=!!resumeSource || launchTeamsLoading || $('launch-submit').disabled
   $('launch-team').disabled=!!resumeSource || launchTeamsLoading || $('launch-submit').disabled
   $('launch-team-note').textContent=resumeSource ? 'Continuing with the existing agent.' : team ? [team.description, `Roles: ${team.roles.map(r=>r.name).join(', ')}.`].filter(Boolean).join(' ') : launchTeamsLoading ? 'Loading teams…' : launchTeams ? 'No team keeps this a single-agent conversation.' : 'Teams unavailable. Reopen this dialog to retry; single agents are still available.'
 }
 async function loadLaunchTeams() {
   if(!$('launch-team')) {
-    document.querySelector('.launch-fields').insertAdjacentHTML('afterbegin','<label for="launch-team">Team<select id="launch-team" name="teamId" aria-describedby="launch-team-note"><option value="">No team · single agent</option></select><span class="note" id="launch-team-note" role="status"></span></label>')
+    document.querySelector('.launch-fields').insertAdjacentHTML('afterbegin','<label for="launch-team">Team<select id="launch-team" name="teamId" aria-describedby="launch-team-note"><option value="">No team · single agent</option></select><span class="note" id="launch-team-note" role="status"></span></label><button type="button" class="button" id="customize-team">Customize team…</button>')
+    $('customize-team').addEventListener('click',()=>window.FleetTeams.open())
     $('launch-team').addEventListener('change',()=>{launchRequestId=null;updateLaunchTeam()})
   }
   if(launchTeams || launchTeamsLoading){updateLaunchTeam();return}
@@ -50,6 +52,7 @@ async function loadLaunchTeams() {
   finally {launchTeamsLoading=false;updateLaunchTeam()}
 }
 function openLaunch(source=null) {
+  window.FleetTeams?.reset()
   resumeSource=source
   $('launch-title').textContent=source ? 'Continue this conversation in Fleet.' : 'Give your next task a home.'
   if(source){$('launch-cwd').value=source.cwd || '';$('launch-form').elements.name.value=source.title || source.name || ''}
@@ -68,6 +71,7 @@ document.addEventListener('keydown', event => {
 $('launch-form').addEventListener('input',()=>{launchRequestId=null})
 $('launch-form').addEventListener('submit',async event=>{
   event.preventDefault()
+  if(window.FleetTeams?.isEditing()){window.FleetTeams.save();return}
   const button=$('launch-submit'); if(button.disabled)return
   button.disabled=true;button.textContent='Launching…';$('launch-error').hidden=true
   const form=event.currentTarget
@@ -81,7 +85,7 @@ $('launch-form').addEventListener('submit',async event=>{
     await tick();toast(form.elements.teamId?.value && !resumeSource ? 'Initiative launched' : 'Agent launched')
     if(matchMedia('(max-width:720px)').matches)$('detail').scrollIntoView({block:'start',behavior:'instant'})
   }catch(error){$('launch-error').textContent=error.message;$('launch-error').hidden=false}
-  finally{button.disabled=false;button.textContent='Launch agent ↗';form.querySelectorAll('input,textarea,select').forEach(el=>el.disabled=false);if($('launch-team'))updateLaunchTeam()}
+  finally{button.disabled=false;button.textContent='Launch agent ↗';form.querySelectorAll('input,textarea,select').forEach(el=>el.disabled=!!el.closest('#team-editor'));if($('launch-team'))updateLaunchTeam()}
 })
 function selectControl(session) {
   const next=session?.managedId || null
@@ -142,6 +146,7 @@ async function refreshControl() {
 }
 function renderControl() {
   const s=controlSession;if(!s || s.id!==controlId || !$('composer'))return
+  window.FleetTeams?.board(s)
   $('conversation-title').textContent=s.aiTitle || s.name
   $('agent-state').textContent=s.currentTool && s.status==='running' ? `Using ${s.currentTool}` : managedLabels[s.status]
   $('agent-state').className=`subtle ${s.status==='approval' ? 'stale' : ''}`

package/public/index.html

@@ -1,5 +1,5 @@
 <!doctype html>
-<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="color-scheme" content="dark"><title>Fleet — Claude Code control room</title><link rel="manifest" href="/manifest.webmanifest"><link rel="icon" href="/icons/fleet-192.png" type="image/png"><link rel="apple-touch-icon" href="/icons/fleet-192.png"><meta name="apple-mobile-web-app-capable" content="yes"><meta name="apple-mobile-web-app-title" content="Fleet"><link rel="stylesheet" href="/theme.css"><link rel="stylesheet" href="/styles.css"><script src="/vendor/libs.js" defer></script><script src="/app.js" defer></script><script src="/blocks.js" defer></script><script src="/control.js" defer></script><script src="/ask.js" defer></script></head>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="color-scheme" content="dark"><title>Fleet — Claude Code control room</title><link rel="manifest" href="/manifest.webmanifest"><link rel="icon" href="/icons/fleet-192.png" type="image/png"><link rel="apple-touch-icon" href="/icons/fleet-192.png"><meta name="apple-mobile-web-app-capable" content="yes"><meta name="apple-mobile-web-app-title" content="Fleet"><link rel="stylesheet" href="/theme.css"><link rel="stylesheet" href="/styles.css"><script src="/vendor/libs.js" defer></script><script src="/app.js" defer></script><script src="/blocks.js" defer></script><script src="/control.js" defer></script><script src="/teams.js" defer></script><script src="/ask.js" defer></script></head>
 <body><header class="topbar"><a class="brand" href="/" aria-label="Fleet home"><span class="brandmark">✳</span> fleet <span class="brand-sub">/ CLAUDE CODE</span></a><span class="app-version" id="app-version" title="The version of Fleet this server is running"></span><div class="connection"><span id="connection-dot" class="dot busy"></span><span id="connection">Connecting</span><span class="local">LOCAL CONTROL ROOM</span></div><div class="refresh-info"><button id="update-pill" class="button update-pill" hidden></button><span id="updated">Waiting for first snapshot</span><button id="refresh" class="button">↻ Refresh</button><button id="ask-sessions" class="button" aria-expanded="false" aria-controls="ask-backdrop" title="Ask a question across every session on this machine">⌕ Ask <kbd id="ask-shortcut">⌘K</kbd></button><button id="new-session" class="button resume" aria-expanded="false" aria-controls="launch-backdrop">＋ New agent</button></div></header>
 <main>
 <div id="error" class="error" role="status" hidden></div>

package/public/styles.css

@@ -465,3 +465,54 @@ body[data-modal]{overflow:hidden}
 
 .app-version{align-self:center;margin-left:8px;color:var(--muted);font-size:10px;letter-spacing:.04em;font-variant-numeric:tabular-nums}
 .session-cost{font-variant-numeric:tabular-nums}
+
+/* Configurable teams share the launch dialog and the Warp console palette. */
+.team-editor-head,.team-editor-actions{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:20px}
+.team-editor-head h3{margin:5px 0 8px;font-size:20px}.team-editor-head p{margin:0}.team-editor-head>.button{flex-shrink:0}
+.team-meta,.team-rules{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin:16px 0}.team-meta>label:last-child{grid-column:1/-1}
+.team-role-list{margin:20px 0}.team-role{border-top:1px solid var(--line)}.team-role:last-child{border-bottom:1px solid var(--line)}
+.team-role>summary{display:flex;gap:12px;align-items:center;cursor:pointer;padding:16px 0}.team-role>summary strong{min-width:100px;color:var(--text)}.team-role>summary span{flex:1;color:var(--muted);font-size:11px}.team-role>summary small{color:var(--accent)}
+.team-role-fields{display:grid;grid-template-columns:1fr 1fr;gap:14px;padding:0 0 20px}.team-wide{grid-column:1/-1}.team-role-fields textarea{font-family:var(--mono);font-size:12px}.team-role-kind,.team-tools{display:flex;flex-wrap:wrap;gap:16px;align-items:center}
+#team-editor .team-role-kind label,#team-editor .team-tools label{display:flex;flex-direction:row;align-items:center;gap:6px}#team-editor input[type=checkbox],#team-editor input[type=radio]{width:auto;min-height:20px;accent-color:var(--accent)}
+.team-role-kind button{margin-left:auto}.team-role-fields fieldset{margin:0;padding:12px;border:1px solid var(--line);border-radius:6px}.team-role-fields legend{font-size:11px;color:var(--muted);padding:0 6px}.team-editor-actions{margin:20px 0 0}
+#initiative-board{flex:none;border:1px solid var(--line);border-radius:8px;margin-bottom:10px;font-size:11px;overflow:hidden}
+#initiative-board>summary{display:flex;gap:12px;padding:12px;cursor:pointer;background:var(--panel)}#initiative-board>summary strong{margin-right:auto}#initiative-board>summary span{color:var(--muted);font-variant-numeric:tabular-nums}
+.initiative-body{max-height:38vh;overflow:auto;padding:12px}.initiative-roster{display:flex;align-items:center;gap:10px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:12px}.initiative-role{padding:5px 0}.initiative-role strong,.initiative-role small{display:block}.initiative-role small{margin-top:5px;color:var(--muted);font-size:10px}.initiative-role.is-active strong{color:var(--accent)}.team-connector{color:var(--faint)}
+.initiative-tasks{list-style:none;padding:0;margin:0}.initiative-tasks>li{padding:12px 0;border-bottom:1px solid var(--line)}.initiative-tasks summary{cursor:pointer;line-height:1.7}.initiative-tasks summary small{display:block;color:var(--muted)}.task-state{display:inline-block;color:var(--muted);margin-right:8px}.task-state[data-state=verified]{color:var(--busy)}.task-state[data-state=blocked],.task-state[data-state=changes_requested]{color:var(--stale)}.task-state[data-state=working]{color:var(--accent)}
+.initiative-tasks ul{padding-left:20px;line-height:1.8}.initiative-handoff{margin-top:10px;padding:8px 10px;background:var(--panel);border-radius:5px}.initiative-handoff summary span{color:var(--muted);margin-left:8px}.initiative-handoff summary small{display:inline;color:var(--muted);margin-left:8px;font-size:10px}.handoff-mandate,.handoff-report{margin-top:8px}.handoff-report{border-top:1px solid var(--line);padding-top:8px}.handoff-mandate>summary,.handoff-report>summary{cursor:pointer;color:var(--muted);font-size:10px;font-weight:600}.handoff-mandate>summary:focus-visible,.handoff-report>summary:focus-visible{outline:2px solid var(--accent);outline-offset:4px}.initiative-handoff pre{white-space:pre-wrap;overflow-wrap:anywhere;font:11px/1.7 var(--mono);max-height:300px;overflow:auto;margin-top:6px}.initiative-body>.note{margin:12px 0 0;font-size:10px}
+@media(max-width:720px){.team-editor-head{align-items:start}.team-meta,.team-rules,.team-role-fields{grid-template-columns:1fr}.team-role>summary{flex-wrap:wrap}.team-role>summary span{flex-basis:100%;order:3}.team-role>summary small{margin-left:auto}#initiative-board>summary{flex-wrap:wrap}.initiative-body{max-height:32vh}}
+#team-editor{padding:3px 32px 28px}.initiative-limits{display:flex;flex-wrap:wrap;align-items:end;gap:12px;margin-top:12px}.initiative-limits label{display:flex;flex-direction:column;gap:6px;color:var(--muted)}.initiative-limits input{width:110px;padding:8px;background:var(--bg);color:var(--text);border:1px solid var(--line);border-radius:5px}.initiative-limits .form-error{width:100%}.initiative-limits .note{width:100%;margin:12px 0 0}@media(max-width:720px){#team-editor{padding:0 20px 24px}.team-editor-head{flex-wrap:wrap}}
+.modal-launch.is-editing-team>.modal-head .modal-heading{display:none}.modal-launch.is-editing-team>.modal-head{justify-content:flex-end;padding-bottom:8px}.modal-launch.is-editing-team #team-editor{padding-top:0}
+
+/* A Task-tool sub-agent has no process of its own, so this nested row under the
+   session that ran it is the only place it ever shows up. */
+.session-child{padding-left:44px;background:color-mix(in oklab,var(--panel) 88%,var(--w-fg))}
+.session-child .session-name{color:var(--muted)}
+.session-child .session-title{font-size:11px;font-weight:400;color:var(--faint)}
+@media(max-width:1000px){.session-child{padding-left:34px}}
+/* Only one row reads as selected: a session holding a selected child is an ancestor,
+   not the selection itself, so it gets a quieter treatment and no accent bar. */
+.session-ancestor{background:#1a1f1e}
+.session-ancestor:hover{background:#1c2120}
+/* A long initiative is capped to its most recent delegations; this line names the
+   rest without pretending to be a row of its own. */
+.session-child-more{padding:9px 23px 9px 44px;color:var(--faint);font-size:10px;background:color-mix(in oklab,var(--panel) 88%,var(--w-fg))}
+@media(max-width:1000px){.session-child-more{padding-left:34px}}
+/* Its read-only report: steps, in the order Fleet saw them, each with what it touched. */
+.child-steps{list-style:none;margin:0;padding:0;font-size:11px}
+.child-step{display:flex;gap:10px;align-items:baseline;padding:7px 0;border-top:1px solid var(--line)}
+.child-step:first-child{border-top:0}
+.child-step-tool{font-weight:600;flex:none}
+.child-step-target{color:var(--muted);overflow-wrap:anywhere;flex:1;min-width:0}
+.child-step-state{color:var(--faint);flex:none}
+.child-step[data-status="running"] .child-step-state{color:var(--busy)}
+.child-step[data-status="error"] .child-step-state{color:var(--dead)}
+.child-step[data-status="interrupted"] .child-step-state{color:var(--stale)}
+/* Terminal, not in-progress: the delegation ended before this step ever reported
+   back, so it gets a cool, muted hue of its own rather than the plain "done" grey
+   or a transparency trick that would wash out against the panel. */
+.child-step[data-status="unreported"] .child-step-state{color:color-mix(in oklab,var(--w-blue) 56%,var(--w-fg))}
+.child-step-time{color:var(--faint);font-variant-numeric:tabular-nums;flex:none}
+/* Selecting a child hides the console, so a pending approval on the owning session
+   would otherwise go unnoticed; this is the one visible sign it is still waiting. */
+.child-approval-notice{color:var(--text);background:color-mix(in srgb,var(--stale) 14%,transparent);border:1px solid var(--stale);border-radius:6px;padding:10px 12px;margin-bottom:17px}

package/public/teams.js

@@ -0,0 +1,136 @@
+'use strict'
+// An isolated scope: Fleet's browser files are classic scripts.
+window.FleetTeams=(()=>{
+  let draft=null,tools=[],originalId=null,returnTeam=null
+  const escape=value=>esc(String(value ?? ''))
+  const field=(label,key,value,max=500)=>`<label>${label}<input data-team-field="${key}" value="${escape(value)}" maxlength="${max}" required></label>`
+  function mount() {
+    if(document.getElementById('team-editor'))return
+    const container=document.createElement('section')
+    container.id='team-editor';container.hidden=true;container.setAttribute('aria-label','Team editor')
+    container.innerHTML='<div class="team-editor-head"><div><span class="modal-eyebrow">YOUR TEAM, YOUR WAY</span><h3>Shape the team.</h3><p class="note">Choose the specialists. Fleet handles task tracking and independent verification.</p></div><button type="button" class="button" id="team-editor-back">Back to task</button></div><div id="team-editor-fields"></div><p id="team-editor-error" class="form-error" role="alert" hidden></p><div class="team-editor-actions"><button type="button" class="button" id="team-add-role">+ Add role</button><button type="button" class="button resume" id="team-save">Save team</button></div>'
+    document.getElementById('launch-form').append(container)
+    container.querySelector('#team-editor-back').addEventListener('click',()=>toggle(false))
+    container.querySelector('#team-add-role').addEventListener('click',()=>{try{read();if(Object.keys(draft.roles).length>=8)throw new Error('A team can have up to eight roles.');let key='specialist';while(draft.roles[key])key+='x';draft.roles[key]={description:'A specialist for this task',prompt:'Describe this specialist’s responsibility and expected output.',model:'sonnet',tools:['Read','Glob','Grep']};render()}catch(error){showError(error)}})
+    container.querySelector('#team-save').addEventListener('click',save)
+    container.querySelector('#team-editor-fields').addEventListener('change',event=>{if(['manager','reviewer'].includes(event.target.dataset.roleField))syncTools()})
+    container.querySelector('#team-editor-fields').addEventListener('click',event=>{
+      const button=event.target.closest('[data-remove-role]');if(!button)return
+      try{read();const key=button.dataset.removeRole;if(key===draft.manager)throw new Error('Choose another manager before removing this role.');delete draft.roles[key];draft.workflow.reviewers=draft.workflow.reviewers.filter(r=>r!==key);render()}catch(error){showError(error)}
+    })
+  }
+  function toggle(editing) {
+    const form=document.getElementById('launch-form')
+    form.noValidate=editing
+    document.querySelector('.modal-launch').classList.toggle('is-editing-team',editing)
+    for(const child of form.children)child.hidden=editing ? child.id!=='team-editor' : child.id==='team-editor' || child.id==='launch-error'
+    // Hidden editor fields must not participate in the launch form's validation.
+    document.querySelectorAll('#team-editor input,#team-editor textarea,#team-editor select').forEach(el=>el.disabled=!editing)
+    if(editing){syncTools();document.querySelector('#team-editor input')?.focus()}
+    else {document.getElementById('launch-team').value=returnTeam || '';updateLaunchTeam();document.getElementById('launch-prompt').focus()}
+  }
+  async function open() {
+    mount()
+    try {
+      const selected=document.getElementById('launch-team').value || 'delivery'
+      const [data,catalog]=await Promise.all([api(`/api/teams/${encodeURIComponent(selected)}`),api('/api/teams')])
+      tools=catalog.tools;draft=data.team;returnTeam=selected
+      const custom=catalog.teams.find(t=>t.id===selected)?.custom
+      originalId=custom ? selected:null
+      if(!custom){draft.id=`${draft.id}-custom`;while(catalog.teams.some(t=>t.id===draft.id))draft.id+='-copy';draft.name+= ' · custom'}
+      draft.workflow ||= {reviewers:['qa'],maxAttempts:3,budgetUsd:10}
+      for(const [name,role] of Object.entries(draft.roles))role.tools ||= tools.filter(t=>!(role.disallowedTools || []).includes(t) && (name!==draft.manager || ['Read','Glob','Grep','WebSearch','WebFetch'].includes(t)))
+      render();toggle(true)
+    } catch(error){toast(error.message)}
+  }
+  function render() {
+    document.getElementById('team-editor-error').hidden=true
+    const roles=Object.entries(draft.roles)
+    document.getElementById('team-editor-fields').innerHTML=`<div class="team-meta">${field('Team name','name',draft.name,80)}${field('Team ID','id',draft.id,60)}${field('Purpose','description',draft.description,500)}</div><div class="team-rules"><label>Repair attempts per task<input data-team-field="maxAttempts" type="number" min="1" max="10" value="${draft.workflow.maxAttempts}"></label><label>Usage cap · API-rate equivalent<input data-team-field="budgetUsd" type="number" min="0.1" max="1000" step="0.1" value="${draft.workflow.budgetUsd}"></label></div><p class="note">The usage cap is not a bill. It’s the API-rate equivalent the SDK reports, accumulated across the whole initiative; on a Claude subscription nothing is charged. Reaching the cap still stops the run.</p><p class="note">One manager talks to you. Verification roles check every task; at least one separate worker does the work. Shell access permits commands and is governed by your approval mode.</p><div class="team-role-list">${roles.map(([key,role],index)=>`<details class="team-role" data-role-key="${escape(key)}" ${index===0 ? 'open':''}><summary><strong>${escape(key)}</strong><span>${escape(role.description)}</span><small>${escape(role.model)}</small></summary><div class="team-role-fields"><label>Role ID<input data-role-field="id" value="${escape(key)}" maxlength="40" required></label><label>Model<input data-role-field="model" value="${escape(role.model || 'inherit')}" list="team-model-options" maxlength="80" required></label><label class="team-wide">Purpose<input data-role-field="description" value="${escape(role.description)}" maxlength="500" required></label><label class="team-wide">Instructions<textarea data-role-field="prompt" rows="6" maxlength="12000" required>${escape(role.prompt)}</textarea></label><div class="team-role-kind team-wide"><label><input type="radio" name="team-manager-role" data-role-field="manager" ${key===draft.manager ? 'checked':''}> Manager</label><label><input type="checkbox" data-role-field="reviewer" ${draft.workflow.reviewers.includes(key) ? 'checked':''}> Required verifier</label><button type="button" class="button" data-remove-role="${escape(key)}">Remove role</button></div><fieldset class="team-wide"><legend>Allowed tools</legend><div class="team-tools">${tools.map(tool=>`<label><input type="checkbox" data-tool="${escape(tool)}" ${(role.tools || []).includes(tool) ? 'checked':''}> ${escape(tool)}</label>`).join('')}</div></fieldset></div></details>`).join('')}</div><datalist id="team-model-options"><option value="opus"><option value="sonnet"><option value="haiku"><option value="inherit"></datalist>`
+    document.querySelector('[data-team-field="id"]').readOnly=!!originalId
+    syncTools()
+  }
+  function syncTools() {
+    for(const row of document.querySelectorAll('#team-editor [data-role-key]')) {
+      const manager=row.querySelector('[data-role-field="manager"]').checked
+      const verifier=row.querySelector('[data-role-field="reviewer"]').checked
+      for(const el of row.querySelectorAll('[data-tool]')) {
+        el.disabled=(manager && !['Read','Glob','Grep','WebSearch','WebFetch'].includes(el.dataset.tool)) || (verifier && ['Write','Edit','MultiEdit','NotebookEdit'].includes(el.dataset.tool))
+        if(el.disabled)el.checked=false
+      }
+    }
+  }
+  function read() {
+    const next={roles:{},workflow:{reviewers:[]}}
+    for(const el of document.querySelectorAll('[data-team-field]')) {
+      const key=el.dataset.teamField
+      if(['maxAttempts','budgetUsd'].includes(key))next.workflow[key]=Number(el.value)
+      else next[key]=el.value.trim()
+    }
+    for(const row of document.querySelectorAll('#team-editor [data-role-key]')) {
+      const value=key=>row.querySelector(`[data-role-field="${key}"]`)
+      const id=value('id').value.trim()
+      if(!/^[a-z][a-z0-9-]{0,39}$/.test(id) || ['constructor','prototype','__proto__'].includes(id))throw new Error('Role IDs need lowercase letters, numbers and hyphens.')
+      if(Object.hasOwn(next.roles,id))throw new Error(`Role ID “${id}” is used twice.`)
+      next.roles[id]={description:value('description').value.trim(),prompt:value('prompt').value.trim(),model:value('model').value.trim(),tools:[...row.querySelectorAll('[data-tool]:checked')].map(el=>el.dataset.tool)}
+      if(value('manager').checked)next.manager=id
+      if(value('reviewer').checked)next.workflow.reviewers.push(id)
+    }
+    draft=next
+  }
+  function showError(error){const el=document.getElementById('team-editor-error');el.textContent=error.message;el.hidden=false}
+  async function save() {
+    const button=document.getElementById('team-save');button.disabled=true
+    try {
+      read();const {team}=await api('/api/teams',draft)
+      const catalog=await api('/api/teams');launchTeams=catalog.teams
+      const select=document.getElementById('launch-team');select.replaceChildren(new Option('No team · single agent',''))
+      for(const t of launchTeams)select.add(new Option(t.name,t.id))
+      returnTeam=team.id;launchRequestId=null;toggle(false);toast('Team saved. Ready for your task.')
+    } catch(error){showError(error)}finally{button.disabled=false}
+  }
+  // The model actually reported by a delegation wins; a role's configured model is
+  // only a fallback for a delegation that has not reported one yet (still running,
+  // or resumed before its first assistant event).
+  const handoffModel=(s,d)=>d.model || s.teamSnapshot.roles[d.role]?.model || ''
+  // Assignment and report each get their own collapsed <details>, keyed into the same
+  // data-evidence disclosure tracking as the task and handoff they live inside.
+  function handoffHtml(s,d,opened) {
+    const model=handoffModel(s,d)
+    const mandateId=`${d.id}-mandate`,reportId=`${d.id}-report`
+    return `<details class="initiative-handoff" data-evidence="${d.id}" ${opened.has(d.id) ? 'open':''}><summary>${escape(s.teamSnapshot.manager)} → ${escape(d.role)} <span>${escape(d.status)}${d.activity && d.status==='running' ? ' · '+escape(d.activity):''}</span>${model ? `<small>${escape(model)}</small>`:''}</summary><details class="handoff-mandate" data-evidence="${mandateId}" ${opened.has(mandateId) ? 'open':''}><summary>Assignment</summary><pre>${escape(d.prompt)}</pre></details><details class="handoff-report" data-evidence="${reportId}" ${opened.has(reportId) ? 'open':''}><summary>Report to ${escape(s.teamSnapshot.manager)}</summary><pre>${escape(d.report || 'Waiting for the agent’s report.')}</pre></details></details>`
+  }
+  function board(s) {
+    let panel=document.getElementById('initiative-board')
+    if(!s.teamSnapshot?.workflow){panel?.remove();return}
+    if(!panel){panel=document.createElement('details');panel.id='initiative-board';panel.open=true;document.getElementById('conversation').before(panel);panel.addEventListener('click',event=>{if(event.target.closest('[data-adjust-limits]'))adjustLimits(s.id)})}
+    const b=s.taskBoard || {tasks:[],delegations:[]},done=b.tasks.filter(t=>t.status==='verified').length
+    const signature=JSON.stringify([b,s.status,s.costUsd,s.teamSnapshot,s.limits])
+    if(panel.fleetSignature===signature)return
+    const opened=new Set([...panel.querySelectorAll('details[open][data-evidence]')].map(el=>el.dataset.evidence))
+    const scrollTop=panel.querySelector('.initiative-body')?.scrollTop || 0
+    const focused=document.activeElement?.closest('[data-evidence]')?.dataset.evidence
+    panel.fleetSignature=signature
+    const active=b.delegations.find(d=>d.status==='running')
+    panel.innerHTML=`<summary><strong>${escape(s.teamName)}</strong><span>${done}/${b.tasks.length} verified</span><span title="API-rate equivalent the SDK reports. Not billed on a Claude subscription; the run still stops here.">$${(s.costUsd || 0).toFixed(2)} / $${s.limits?.budgetUsd ?? s.teamSnapshot.workflow.budgetUsd} cap</span></summary><div class="initiative-body"><div class="initiative-roster" aria-label="Team and active agent">${Object.entries(s.teamSnapshot.roles).map(([name,r])=>`<div class="initiative-role ${(active?.role || (isWorking(s) ? s.teamSnapshot.manager:null))===name ? 'is-active':''}"><strong>${escape(name)}</strong><small>${escape(name===s.teamSnapshot.manager && s.selectedModel ? s.selectedModel : r.model)}${name===s.teamSnapshot.manager ? ' · your contact':active?.role===name ? ' · working':''}</small></div>`).join('<span class="team-connector" aria-hidden="true">·</span>')}</div>${b.tasks.length ? `<ol class="initiative-tasks">${b.tasks.map(t=>`<li><details data-evidence="${t.id}" ${opened.has(t.id) ? 'open':''}><summary><span class="task-state" data-state="${escape(t.status)}">${escape(t.status.replaceAll('_',' '))}</span><strong>${escape(t.title)}</strong><small>${escape(t.owner)} · attempt ${t.attempt}</small></summary><ul>${t.criteria.map(c=>`<li>${escape(c)}</li>`).join('')}</ul>${t.blocker ? `<p class="form-error">${escape(t.blocker)}</p>`:''}${t.dependencies.length ? `<p class="note">After: ${t.dependencies.map(id=>escape(b.tasks.find(t=>t.id===id)?.title || id)).join(', ')}</p>`:''}${b.delegations.filter(d=>d.taskId===t.id).map(d=>handoffHtml(s,d,opened)).join('')}</details></li>`).join('')}</ol>`:'<p class="note">The manager is shaping your brief. Tasks and handoffs will appear here as work begins.</p>'}<button type="button" class="button" data-adjust-limits ${isWorking(s) ? 'disabled':''}>Adjust limits</button><p class="note">Verified means all configured verifiers returned passing reports for that task’s attempt. Expand a task to inspect the evidence.</p></div>`
+    panel.querySelector('.initiative-body').scrollTop=scrollTop
+    if(focused)panel.querySelector(`[data-evidence="${CSS.escape(focused)}"]>summary`)?.focus({preventScroll:true})
+    const composer=document.getElementById('message-input');composer.placeholder=`Message ${s.teamSnapshot.manager}…`
+  }
+  async function adjustLimits(id){
+    const s=controlSession;if(!s || s.id!==id)return
+    const panel=document.getElementById('initiative-board')
+    if(panel.querySelector('.initiative-limits'))return
+    const box=document.createElement('div');box.className='initiative-limits'
+    box.innerHTML=`<label>Usage cap · API-rate equivalent<input type="number" data-limit="budgetUsd" min="0.1" max="1000" step="0.1" value="${s.limits?.budgetUsd ?? s.teamSnapshot.workflow.budgetUsd}"></label><label>Attempts per task<input type="number" data-limit="maxAttempts" min="1" max="10" value="${s.limits?.maxAttempts ?? s.teamSnapshot.workflow.maxAttempts}"></label><button type="button" class="button">Save limits</button><p class="note">Not a bill: the SDK reports this as an API-rate equivalent, and a Claude subscription is charged nothing. The cap still stops the run.</p><p class="form-error" role="alert" hidden></p>`
+    panel.querySelector('.initiative-body').append(box)
+    box.querySelector('input').focus()
+    box.querySelector('button').addEventListener('click',async event=>{
+      event.target.disabled=true
+      try{const limits=Object.fromEntries([...box.querySelectorAll('[data-limit]')].map(el=>[el.dataset.limit,Number(el.value)]));await api(`/api/managed/${id}/limits`,limits);await refreshControl();toast('Limits saved. Message the manager to continue.')}
+      catch(error){const el=box.querySelector('p');el.textContent=error.message;el.hidden=false;event.target.disabled=false}
+    })
+  }
+  function reset(){if(document.getElementById('team-editor'))toggle(false)}
+  return {open,board,reset,save,isEditing:()=>!!document.getElementById('team-editor') && !document.getElementById('team-editor').hidden}
+})()

package/server.js

@@ -12,7 +12,7 @@ const { SearchJobs, warm: warmSearch, WINDOW_DAYS: SEARCH_DAYS } = require('./se
 const { Archive } = require('./archive.js')
 const { Updater } = require('./update.js')
 const { defaultCwd } = require('./paths.js')
-const { listTeams } = require('./teams.js')
+const { TOOL_OPTIONS } = require('./team-store.js')
 const { openDashboard } = require('./open.js')
 const { version: VERSION } = require('./package.json')
 const HOST = '127.0.0.1'
@@ -71,6 +71,13 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
       // that over Fleet's first-prompt slice, and keep it for the detail view too.
       const aiTitle=transcriptFor(s.sessionId)?.title
       if(aiTitle){s.title=aiTitle;try{manager.get(s.managedId).aiTitle=aiTitle}catch{}}
+      // A Task-tool sub-agent has no PID and never gets its own row, so the left panel
+      // needs just enough per-delegation state to draw a nested one. Prompts, reports
+      // and steps stay off this polled payload; the detail route carries those.
+      try {
+        const raw=manager.get(s.managedId)
+        if(raw.taskBoard?.delegations?.length) s.delegations=raw.taskBoard.delegations.map(d=>({id:d.id,role:d.role,model:d.model || raw.teamSnapshot?.roles?.[d.role]?.model || null,status:d.status}))
+      } catch {}
     }
     const sessions=[...managed,...external].sort((a,b)=>{
       const rank=s=>s.managedStatus==='approval'?0:s.state==='busy'?1:s.state==='idle'?2:s.state==='stale'?3:4
@@ -95,7 +102,7 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
   async function body(req, limit = 65536) {
     if (!(req.headers['content-type'] || '').startsWith('application/json')) throw Object.assign(new Error('JSON content type is required.'),{status:415})
     let size=0, chunks=[]
-    for await(const chunk of req){size+=chunk.length;if(size>limit) throw Object.assign(new Error(limit > 65536 ? 'Attachments are too large for one message.' : 'Request is too large.'),{status:413});chunks.push(chunk)}
+    for await(const chunk of req){size+=chunk.length;if(size>limit) throw Object.assign(new Error(limit > 256000 ? 'Attachments are too large for one message.' : 'Request is too large.'),{status:413});chunks.push(chunk)}
     let data
     try{data=JSON.parse(Buffer.concat(chunks).toString('utf8'))}catch{throw Object.assign(new Error('Invalid JSON.'),{status:400})}
     if(!data || typeof data!=='object' || Array.isArray(data)) throw Object.assign(new Error('Expected a JSON object.'),{status:400})
@@ -121,7 +128,8 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
         if(storageError && url.pathname!=='/api/update' && !/^\/api\/managed\/[\w-]+\/stop$/.test(url.pathname)) return json(res,503,{error:storageError})
         // Only the two endpoints that carry a message accept image-sized bodies.
         const carriesMessage=url.pathname==='/api/managed' || /^\/api\/managed\/[\w-]+\/messages$/.test(url.pathname)
-        const data=await body(req, carriesMessage ? 40 * 1024 * 1024 : 65536)
+        const data=await body(req, carriesMessage ? 40 * 1024 * 1024 : url.pathname==='/api/teams' ? 256000 : 65536)
+        if(url.pathname==='/api/teams') return json(res,200,{team:manager.teams.save(data)})
         if(url.pathname==='/api/managed') return json(res,201,{session:manager.detail(manager.create(data).id)})
         // Keyword hits come back at once; the answer is fetched by id while Claude reads them.
         if(url.pathname==='/api/search') return json(res,201,{job:search.start(data)})
@@ -134,7 +142,7 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
           if(restart) setTimeout(()=>{restart().catch(error=>console.error(error.message))},250).unref()
           return json(res,200,{update:{...update,restarting:!!restart}})
         }
-        const match=url.pathname.match(/^\/api\/managed\/([\w-]+)\/(messages|stop|mode|model|close|approvals\/([\w-]+))$/)
+        const match=url.pathname.match(/^\/api\/managed\/([\w-]+)\/(messages|stop|mode|model|limits|close|approvals\/([\w-]+))$/)
         if(!match) return json(res,404,{error:'Unknown action.'})
         const [,id,action,approvalId]=match
         if(action==='close') return json(res,200,{closed:await manager.remove(id)})
@@ -142,6 +150,7 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
         else if(action==='stop') manager.stop(id)
         else if(action==='mode') manager.setMode(id,data)
         else if(action==='model') manager.setModelChoice(id,data)
+        else if(action==='limits') manager.setLimits(id,data)
         else manager.decide(id,approvalId,data)
         return json(res,200,{session:manager.detail(id)})
       }
@@ -168,7 +177,9 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
         return res.end(themeCss(currentTheme()))
       }
       if(url.pathname==='/api/models') return json(res,200,{models:manager.models || MODEL_FALLBACK})
-      if(url.pathname==='/api/teams') return json(res,200,{teams:listTeams()})
+      if(url.pathname==='/api/teams') return json(res,200,{teams:manager.teams.list(),tools:TOOL_OPTIONS})
+      const teamRoute=url.pathname.match(/^\/api\/teams\/([a-z][a-z0-9-]*)$/)
+      if(teamRoute) {const team=manager.teams.get(teamRoute[1]);return json(res,team ? 200:404,team ? {team}:{error:'Team not found.'})}
       if(url.pathname==='/api/sessions') return json(res,200,getSnapshot())
       if(url.pathname==='/api/events') {
         if(clients.size>=20) return json(res,429,{error:'Too many dashboard connections.'})
@@ -195,7 +206,7 @@ function createApp({manager = new ManagedSessions({externalSessions:()=>collect(
         if(holder) session.openElsewhere=holder
         return json(res,200,{session})
       }
-      const files={'/':'index.html','/index.html':'index.html','/styles.css':'styles.css','/app.js':'app.js','/control.js':'control.js','/blocks.js':'blocks.js','/ask.js':'ask.js','/vendor/libs.js':path.join('vendor','libs.js'),'/icons/fleet-192.png':path.join('icons','fleet-192.png'),'/icons/fleet-512.png':path.join('icons','fleet-512.png')}
+      const files={'/':'index.html','/index.html':'index.html','/styles.css':'styles.css','/app.js':'app.js','/control.js':'control.js','/blocks.js':'blocks.js','/ask.js':'ask.js','/teams.js':'teams.js','/vendor/libs.js':path.join('vendor','libs.js'),'/icons/fleet-192.png':path.join('icons','fleet-192.png'),'/icons/fleet-512.png':path.join('icons','fleet-512.png')}
       const file=files[url.pathname]
       if(!file) return json(res,404,{error:'Not found.'})
       const data=await fs.promises.readFile(path.join(PUBLIC,file))

package/tasks.js

@@ -0,0 +1,102 @@
+'use strict'
+const {randomUUID}=require('node:crypto')
+const fail=message=>{throw new Error(message)}
+const idFrom=prompt=>typeof prompt==='string' ? prompt.match(/^Fleet task: ([\w-]+)\s*$/m)?.[1] : null
+function ledger(s) {return s.taskBoard ||= {tasks:[],delegations:[]}}
+function taskFor(s,id) {const task=ledger(s).tasks.find(t=>t.id===id);if(!task)fail('Task not found. Read the Fleet task board.');return task}
+function act(s,input) {
+  const board=ledger(s)
+  if (input.action==='list') return board
+  if (input.action==='create') {
+    if (board.tasks.length>=100) fail('This initiative has reached its 100-task limit.')
+    const owner=input.owner,team=s.teamSnapshot
+    if (!Object.hasOwn(team.roles,owner) || owner===team.manager || team.workflow.reviewers.includes(owner)) fail('Choose a worker role as owner, separate from manager and verification roles.')
+    if (typeof input.title!=='string' || !input.title.trim() || input.title.length>200) fail('Task title must contain 1–200 characters.')
+    if (!Array.isArray(input.criteria) || !input.criteria.length || input.criteria.length>20 || input.criteria.some(c=>typeof c!=='string' || !c.trim() || c.length>2000)) fail('Supply 1–20 concrete acceptance criteria.')
+    const dependencies=input.dependencies || []
+    if (!Array.isArray(dependencies) || dependencies.length>100) fail('Invalid dependencies.')
+    for (const id of dependencies) taskFor(s,id)
+    const task={id:randomUUID(),title:input.title.trim(),owner,criteria:input.criteria,dependencies:[...new Set(dependencies)],status:'pending',attempt:0,reviews:{},createdAt:Date.now()}
+    board.tasks.push(task);return task
+  }
+  if (input.action==='block') {
+    const task=taskFor(s,input.taskId)
+    if (task.status==='verified') fail('This task is already verified. Create a follow-up for additional work.')
+    if (board.delegations.some(d=>d.taskId===task.id && d.status==='running')) fail('Wait for the running delegation before blocking this task.')
+    if (typeof input.reason!=='string' || !input.reason.trim() || input.reason.length>2000) fail('Explain the blocker in 1–2,000 characters.')
+    task.status='blocked';task.blocker=input.reason;return task
+  }
+  fail('Unknown task action.')
+}
+function start(s,toolId,input) {
+  const board=ledger(s),task=taskFor(s,idFrom(input.prompt)),role=input.subagent_type,team=s.teamSnapshot
+  if (board.delegations.some(d=>d.id===toolId)) return board.delegations.find(d=>d.id===toolId)
+  if (input.run_in_background || input.resume) fail('Use a fresh foreground delegation so Fleet can track its evidence.')
+  if (role!==task.owner && !team.workflow.reviewers.includes(role)) fail('Delegate to the task owner or one of its verification roles.')
+  if (board.delegations.some(d=>d.status==='running')) fail('Wait for the current delegation: this initiative shares one worktree.')
+  if (task.dependencies.some(id=>taskFor(s,id).status!=='verified')) fail('Complete this task’s dependencies first.')
+  if (role===task.owner) {
+    if (task.attempt>=(s.limits?.maxAttempts ?? team.workflow.maxAttempts)) fail('Repair attempt limit reached. Report the blocker to the operator.')
+    // A worker can touch shared code; prior verification must be refreshed. Reject
+    // changes once dependents began, rather than silently invalidating their inputs.
+    if (board.tasks.some(t=>t.dependencies.includes(task.id) && t.attempt>0)) fail('A dependent task has already started. Create a follow-up task for new work.')
+    task.attempt++;task.reviews={};task.status='working';task.blocker=null
+  } else {
+    if (task.status!=='review') fail('The owner must complete implementation before independent verification.')
+    if (task.reviews[role]?.verdict==='PASS') fail('This role already verified the current attempt.')
+  }
+  const d={id:toolId,taskId:task.id,role,attempt:task.attempt,status:'running',startedAt:Date.now(),prompt:String(input.prompt).slice(0,24000),report:null}
+  board.delegations.push(d)
+  return d
+}
+function unwrapReport(report) {
+  const text=String(report || '')
+  if (!text.startsWith('[Subagent hand-back]')) return text
+  const marker='The report follows:\n'
+  const offset=text.indexOf(marker)
+  if (offset<0) return text
+  const lines=[]
+  for (const line of text.slice(offset+marker.length).split('\n')) {
+    if (!line.startsWith('  ')) break
+    lines.push(line.slice(2))
+  }
+  return lines.length ? lines.join('\n') : text
+}
+
+function finish(s,toolId,report,error=false) {
+  const d=ledger(s).delegations.find(d=>d.id===toolId)
+  if (!d || d.status!=='running') return
+  d.report=String(error ? report : d.output || unwrapReport(report)).slice(0,24000);d.status=error ? 'failed':'completed';d.finishedAt=Date.now()
+  const task=taskFor(s,d.taskId)
+  if (error) {task.status='blocked';task.blocker='Delegation failed. Read the report before retrying.';return}
+  if (d.role===task.owner) {task.status='review';return}
+  const verdict=d.report.trim().replace(/^\*\*/, '').match(/^(PASS|FAIL)\b/)?.[1]
+  const evidence=d.report.replace(/^\s*\*{0,2}(PASS|FAIL)\*{0,2}[\s:—-]*/, '').trim()
+  task.reviews[d.role]={verdict:verdict==='PASS' && evidence.length>=20 ? 'PASS':'FAIL',delegationId:d.id,attempt:d.attempt}
+  if (task.reviews[d.role].verdict==='FAIL') {task.status='changes_requested';return}
+  if (s.teamSnapshot.workflow.reviewers.every(r=>task.reviews[r]?.verdict==='PASS')) task.status='verified'
+}
+function interrupt(s) {
+  if (!s.taskBoard) return
+  for (const d of s.taskBoard.delegations) if (d.status==='running') {
+    d.status='interrupted';d.finishedAt=Date.now()
+    const task=taskFor(s,d.taskId);task.status='blocked';task.blocker='Execution interrupted. Ask the manager to resume.'
+  }
+}
+function progress(s) {
+  if (!s.taskBoard) return null
+  const tasks=s.taskBoard.tasks
+  return {total:tasks.length,verified:tasks.filter(t=>t.status==='verified').length,blocked:tasks.filter(t=>['blocked','changes_requested'].includes(t.status)).length}
+}
+async function sdkServer(s,changed) {
+  const {createSdkMcpServer,tool}=await import('@anthropic-ai/claude-agent-sdk')
+  const {z}=require('zod/v4')
+  return createSdkMcpServer({name:'fleet',version:'1.0.0',tools:[tool('tasks','Read the durable task board; create scoped tasks with criteria and dependencies; record blockers. Fleet records verification from actual agent reports.',{
+    action:z.enum(['list','create','block']),title:z.string().optional(),owner:z.string().optional(),criteria:z.array(z.string()).optional(),dependencies:z.array(z.string()).optional(),taskId:z.string().optional(),reason:z.string().optional(),
+  },async input=>{
+    const before=structuredClone(s.taskBoard)
+    try {const result=act(s,input);changed();return {content:[{type:'text',text:JSON.stringify(result)}]}}
+    catch(error){s.taskBoard=before;return {isError:true,content:[{type:'text',text:error.message}]}}
+  })]})
+}
+module.exports={ledger,act,start,finish,interrupt,progress,sdkServer,idFrom}

package/team-store.js

@@ -0,0 +1,70 @@
+'use strict'
+const fs = require('node:fs')
+const path = require('node:path')
+const { randomUUID } = require('node:crypto')
+const { TEAMS } = require('./teams')
+
+const TOOL_OPTIONS = ['Read','Glob','Grep','Bash','Write','Edit','MultiEdit','NotebookEdit','WebSearch','WebFetch']
+const bad = message => { throw Object.assign(new Error(message), {status:400}) }
+function string(value, label, max) {
+  if (typeof value !== 'string' || !value.trim() || value.length > max) bad(`${label} must contain 1–${max} characters.`)
+  return value.trim()
+}
+function validateTeam(input) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) bad('A team is required.')
+  const id=string(input.id,'Team ID',60)
+  if (!/^[a-z][a-z0-9-]*$/.test(id) || ['constructor','prototype','__proto__'].includes(id)) bad('Use a lowercase team ID with letters, numbers and hyphens.')
+  const name=string(input.name,'Team name',80), description=string(input.description,'Team description',500)
+  if (!input.roles || typeof input.roles!=='object' || Array.isArray(input.roles)) bad('Roles must be an object.')
+  const entries=Object.entries(input.roles)
+  if (entries.length<3 || entries.length>8) bad('A team needs 3–8 roles, including its manager.')
+  const manager=string(input.manager,'Manager role',40), roles={}
+  for (const [key,role] of entries) {
+    if (!/^[a-z][a-z0-9-]{0,39}$/.test(key) || ['constructor','prototype','__proto__'].includes(key)) bad('Role IDs must use lowercase letters, numbers and hyphens.')
+    if (!role || typeof role!=='object') bad(`Invalid role: ${key}`)
+    const model=string(role.model || 'inherit',`${key} model`,80)
+    if (!/^[\w.:[\]-]+$/.test(model)) bad(`Invalid model for ${key}.`)
+    if (!Array.isArray(role.tools) || role.tools.some(t=>!TOOL_OPTIONS.includes(t))) bad(`Choose supported tools for ${key}.`)
+    roles[key]={description:string(role.description,`${key} purpose`,500),prompt:string(role.prompt,`${key} instructions`,12000),model,tools:[...new Set(role.tools)]}
+  }
+  if (!Object.hasOwn(roles,manager)) bad('Choose an existing role as manager.')
+  if (!Array.isArray(input.workflow?.reviewers) || !input.workflow.reviewers.length) bad('Choose at least one independent verification role.')
+  const reviewers=[...new Set(input.workflow.reviewers)]
+  if (reviewers.some(r=>typeof r!=='string' || !Object.hasOwn(roles,r) || r===manager)) bad('Verification roles must exist and cannot be the manager.')
+  if (!entries.some(([r])=>r!==manager && !reviewers.includes(r))) bad('Include a worker role separate from the verification roles.')
+  const maxAttempts=input.workflow.maxAttempts ?? 3, budgetUsd=input.workflow.budgetUsd ?? 10
+  if (!Number.isInteger(maxAttempts) || maxAttempts<1 || maxAttempts>10) bad('Attempts must be between 1 and 10.')
+  if (typeof budgetUsd!=='number' || !Number.isFinite(budgetUsd) || budgetUsd<0.1 || budgetUsd>1000) bad('Usage cap must be between $0.10 and $1,000.')
+  // Manager is a coordinator. Verification can run commands but cannot use edit tools.
+  roles[manager].tools=roles[manager].tools.filter(t=>['Read','Glob','Grep','WebSearch','WebFetch'].includes(t))
+  for (const key of reviewers) roles[key].tools=roles[key].tools.filter(t=>!['Write','Edit','MultiEdit','NotebookEdit'].includes(t))
+  return {id,name,description,manager,roles,workflow:{reviewers,maxAttempts,budgetUsd}}
+}
+function summary(team) {
+  return {id:team.id,name:team.name,description:team.description,manager:team.manager,custom:!!team.custom,roles:Object.entries(team.roles).map(([name,r])=>({name,description:r.description,model:r.model || null}))}
+}
+class TeamStore {
+  constructor(directory) {
+    this.file=path.join(directory,'teams.json')
+    this.custom=new Map()
+    try {
+      const saved=JSON.parse(fs.readFileSync(this.file,'utf8'))
+      if (saved.version!==1 || !Array.isArray(saved.teams) || saved.teams.length>50) throw new Error('Unsupported team store')
+      for (const raw of saved.teams) { const team=validateTeam(raw); if (Object.hasOwn(TEAMS,team.id) || this.custom.has(team.id)) throw new Error('Duplicate team ID'); this.custom.set(team.id,team) }
+    } catch (error) { if (error.code!=='ENOENT') throw new Error(`Cannot read Fleet teams: ${error.message}`) }
+  }
+  get(id) { const team=this.custom.get(id) || (Object.hasOwn(TEAMS,id) ? TEAMS[id] : null); return team ? structuredClone(team) : null }
+  list() { return [...Object.values(TEAMS),...[...this.custom.values()].map(t=>({...t,custom:true}))].map(summary) }
+  save(input) {
+    const team=validateTeam(input)
+    if (Object.hasOwn(TEAMS,team.id)) bad('Built-in teams are read-only. Save a copy with a new ID.')
+    if (!this.custom.has(team.id) && this.custom.size>=50) bad('Keep at most 50 custom teams.')
+    const next=new Map(this.custom);next.set(team.id,team)
+    const tmp=`${this.file}.${randomUUID()}.tmp`
+    try {fs.writeFileSync(tmp,JSON.stringify({version:1,teams:[...next.values()]}),{mode:0o600});fs.renameSync(tmp,this.file)}
+    finally {try{fs.unlinkSync(tmp)}catch{}}
+    this.custom=next
+    return structuredClone(team)
+  }
+}
+module.exports={TeamStore,validateTeam,TOOL_OPTIONS}

package/teams.js

@@ -171,9 +171,40 @@ const TEAMS = {
   },
 }
 
+const READ_TOOLS = ['Read','Glob','Grep','WebSearch','WebFetch']
+TEAMS.delivery = {
+  id:'delivery', name:'Software delivery',
+  description:'Turn a brief into scoped work, implementation, independent code review and QA.',
+  manager:'manager',
+  workflow:{reviewers:['reviewer','qa'],maxAttempts:3,budgetUsd:10},
+  roles:{
+    manager:{description:'Owns the goal, plans and delegates work, and talks to you.',prompt:'Read the project instructions and understand the goal. Use the product role when scope needs clarification. Create scoped tasks with testable acceptance criteria. Delegate implementation and independent verification, repair failures, and report evidence. Ask the operator only when a decision changes the scope or work cannot proceed.',model:'opus',tools:READ_TOOLS},
+    product:{description:'Defines scope and measurable acceptance criteria.',prompt:'Read the relevant project context. Produce a concise specification with scope, exclusions, acceptance criteria and edge cases. Return questions to the manager when a material product decision is missing. Do not edit files.',model:'opus',tools:READ_TOOLS},
+    developer:{description:'Implements scoped changes and fixes reported failures.',prompt:DEVELOPER,model:'sonnet',tools:[...READ_TOOLS,'Bash','Write','Edit','NotebookEdit']},
+    reviewer:{description:'Independently reviews correctness and maintainability.',prompt:'Review the actual changes against the task and repository conventions. Check correctness, regression risks, boundaries and error handling. Do not fix the implementation. Return PASS or FAIL followed by concrete evidence and actionable findings. You may run commands for verification; do not modify source files.',model:'opus',tools:[...READ_TOOLS,'Bash']},
+    qa:{description:'Verifies acceptance criteria with reproducible evidence.',prompt:QA,model:'sonnet',tools:[...READ_TOOLS,'Bash']},
+  },
+}
+const TASK_RULES = `
+
+Fleet owns the durable task board. Use mcp__fleet__tasks to read it and create tasks before delegating.
+Each task needs an owner, acceptance criteria and optional dependencies. All configured verification
+roles must verify each deliverable. Include a line "Fleet task: <task ID>" in EVERY Agent prompt.
+Invoke only the owner or a configured verification role. Work sequentially in this shared worktree.
+After the owner returns, delegate each verification role with the original criteria and actual work.
+Verification reports must start with PASS or FAIL and include evidence. A FAIL returns the task to
+its owner; repeat implementation and ALL verification roles. Fleet enforces the attempt limit.
+Do not use background agents. A completed conversation turn is not task completion. Keep going
+until every task is verified, a blocker needs operator input, or the budget/attempt limit is reached.
+The task board is restored on resume: read it before acting; never recreate completed work.
+You are the only role that speaks to the operator. Do not delegate to yourself. Do not edit code.
+Report blockers through the task tool and ask the operator yourself. Finish at a verified local
+branch; do not claim a PR was opened without a real PR URL. A budget limit requires operator action.
+`
+
 function getTeam(id) {
   if (!id) return null
-  return Object.prototype.hasOwnProperty.call(TEAMS, id) ? TEAMS[id] : null
+  return Object.prototype.hasOwnProperty.call(TEAMS, id) ? structuredClone(TEAMS[id]) : null
 }
 
 // What the UI needs to offer a choice. Prompts are large and of no use to the browser.
@@ -193,7 +224,17 @@ function listTeams() {
 function compile(team) {
   if (!team) return null
   if (!team.roles[team.manager]) throw new Error(`Team ${team.id} names a manager role that does not exist.`)
-  return { agent: team.manager, agents: { ...team.roles } }
+  if (!team.workflow) return { agent: team.manager, agents: { ...team.roles } }
+  const agents={}
+  for (const [name,role] of Object.entries(team.roles)) {
+    const manager=name===team.manager
+    agents[name]={...role,
+      tools:[...(role.tools || []),...(manager ? ['Agent','AskUserQuestion','mcp__fleet__tasks'] : [])],
+      disallowedTools:manager ? [...NO_EDITS,'Bash'] : [...NO_DELEGATION,'AskUserQuestion','mcp__fleet__tasks',...(team.workflow.reviewers.includes(name) ? NO_EDITS : [])],
+      prompt:role.prompt+(manager ? TASK_RULES : SUBAGENT_RULE),
+    }
+  }
+  return {agent:team.manager,agents}
 }
 
 module.exports = { TEAMS, getTeam, listTeams, compile, roleNames: team => Object.keys(team.roles) }