@sergeychuvayev/claude-fleet 0.4.0 → 0.5.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'])
@@ -65,12 +67,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 +152,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 +180,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 +282,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('Initiative budget reached. Increase the budget 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 +334,7 @@ class ManagedSessions extends EventEmitter {
       run.finished = true
       this.cancelApprovals(s.id,'The agent stopped before this request was answered.')
       try { run.query?.close() } catch {}
+      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 +344,16 @@ 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') {
+        d.activity=(event.message.content || []).filter(b=>b.type==='tool_use').map(b=>b.name).join(', ') || d.activity
+        d.model=event.message.model || d.model
+        const output=(event.message.content || []).filter(b=>b.type==='text').map(b=>b.text).join('\n')
+        if (output) d.output=output.slice(0,24000)
+      }
+    }
     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 +383,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 +412,22 @@ 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)
     entry.truncated = result.length > MAX_TOOL_RESULT
     entry.result = block.is_error || !QUIET_RESULT.has(entry.tool) ? result.slice(0,MAX_TOOL_RESULT) : null
   }
+  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 budget between the amount already spent 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 +448,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 +522,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.5.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

@@ -103,7 +103,7 @@ 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>`
+    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')}${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>`
   }).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)

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,21 @@ 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 h4{margin-bottom:6px;color:var(--muted)}.initiative-handoff pre{white-space:pre-wrap;overflow-wrap:anywhere;font:11px/1.7 var(--mono);max-height:300px;overflow:auto}.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%}@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}

package/public/teams.js

@@ -0,0 +1,125 @@
+'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>Initiative budget · USD<input data-team-field="budgetUsd" type="number" min="0.1" max="1000" step="0.1" value="${draft.workflow.budgetUsd}"></label></div><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}
+  }
+  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>$${(s.costUsd || 0).toFixed(2)} / $${s.limits?.budgetUsd ?? s.teamSnapshot.workflow.budgetUsd}</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=>`<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></summary><h4>Assignment</h4><pre>${escape(d.prompt)}</pre><h4>Report to ${escape(s.teamSnapshot.manager)}</h4><pre>${escape(d.report || 'Waiting for the agent’s report.')}</pre></details>`).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>Budget · USD<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="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'
@@ -95,7 +95,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 +121,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 +135,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 +143,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 +170,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 +199,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('Budget 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) }