The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Swarm: a step's agents talk to the task's owner after their step ends; no idle notice for step-only agents; the Engineer reports by Done (#2535)
0xken15615626874764
diff --git a/backend/src/superTabs/commands.ts b/backend/src/superTabs/commands.tsindex 608a08b11..5067159f3 100644--- a/backend/src/superTabs/commands.ts+++ b/backend/src/superTabs/commands.ts@@ -2547,7 +2547,11 @@ export function applyCommand(original: SuperTabState, actor: Actor, input: Comma// In a task, an agent holding one of its open steps reaches the task's owner instead (task steps design).const owner = ownerOf(state, group)const ownerHere = actor.kind === 'agent' && owner && owner !== actor.agentId && holdsStepOf(state, group.id, actor.agentId) ? owner : null- const memberToLead = actor.kind === 'agent' && !command.agentOnly && !addressed.length && assigned !== actor.agentId && ownerHere ? [ownerHere]+ // In a step, any agent but the coordinator talks to the task's owner: its own agent after its work ended too (a lost or+ // done step's agent, 2026-11-02, reached the PM).+ const stepTold = actor.kind === 'agent' && isStep(group) && actor.agentId !== group.leadId ? taskOwner(state, group) : null+ const ownerInStep = actor.kind === 'agent' && stepTold && stepTold !== actor.agentId ? stepTold : null+ const memberToLead = actor.kind === 'agent' && !command.agentOnly && !addressed.length && assigned !== actor.agentId && (ownerHere ?? ownerInStep) ? [(ownerHere ?? ownerInStep)!]: actor.kind === 'agent' && !command.agentOnly && !addressed.length && assigned !== actor.agentId && group.leadId&& group.leadId !== actor.agentId && group.agentIds.includes(group.leadId) ? [group.leadId] : []// Buddy thread sessions (buddySessions.ts): a session thread's replies reach its session alone and stay in its thread; thediff --git a/backend/src/superTabs/instructions.test.ts b/backend/src/superTabs/instructions.test.tsindex b46e3030d..298871038 100644--- a/backend/src/superTabs/instructions.test.ts+++ b/backend/src/superTabs/instructions.test.ts@@ -45,6 +45,8 @@ describe('the built-in template', () => {expect(TEMPLATE_WORKFLOW).toContain('run `mine`')expect(TEMPLATE_WORKFLOW).toContain('read `task GROUP`')expect(TEMPLATE_WORKFLOW).toContain('read the thread before acting on it')+ // Ken, 2026-11-02: an Engineer posted "review and test pass" and then set Done, two messages for one event.+ expect(TEMPLATE_WORKFLOW).toContain('that status is how the PM hears, once')expect(TEMPLATE_WORKFLOW).toContain('The PM reads `mine` for progress, not `status`.')expect(TEMPLATE_WORKFLOW.split('\n').filter(l => /^\d+\. /.test(l))).toHaveLength(11)})diff --git a/backend/src/superTabs/instructionsTemplate.ts b/backend/src/superTabs/instructionsTemplate.tsindex 504f37718..ab201659d 100644--- a/backend/src/superTabs/instructionsTemplate.ts+++ b/backend/src/superTabs/instructionsTemplate.ts@@ -54,7 +54,9 @@ export const TEMPLATE_WORKFLOW = `## Workflowasks for two reviews gets two review steps.3. Findings go straight to the Engineer. The Engineer fixes them and asks the same Reviewer or Tester again in the samestep; it adds no new step for a second round.-4. When the review passes, and the test passes where there is one, the Engineer tells the PM once.+4. When the review passes, and the test passes where there is one, the Engineer sets its task done with the pull request+ and the evidence in its result: that status is how the PM hears, once. It sends the PM no other message besides a task+ that needs a person: no progress notes, no "ready for review", no separate "done" message.5. The PM checks CI on the pull requests that passed, merges them, and tells the people who asked.6. A task that needs a person, or a machine that is down, goes to the PM at once, by name.7. Idle Engineers are stopped. Reviewers and Testers are kept while the work they checked is open.diff --git a/backend/src/superTabs/steps.test.ts b/backend/src/superTabs/steps.test.tsindex ada3e9dfe..28c244123 100644--- a/backend/src/superTabs/steps.test.ts+++ b/backend/src/superTabs/steps.test.ts@@ -9,6 +9,7 @@ import { createSuperTab, type Actor, type AgentConfiguration } from './model.js'import { extracted } from './parts/write.js'import { stepSleeps } from './steps.js'import { reportedAs } from './projectUpdates.js'+import { idleNotices } from './tidy.js'const owner: Extract<Actor, { kind: 'person' }> = { kind: 'person', userId: 'owner', email: '[email protected]' }const config: AgentConfiguration = { engine: 'codex', model: 'test-model', effort: 'high', contextWindow: 200000, engineVersion: 'fixture' }@@ -318,3 +319,38 @@ describe('a linked task opened without a step name', () => {expect(reportedAs(f.state, f.group(id))).toBe(`#${f.group(id).number} (step Test: PR #2514 of #${f.group(f.task).number})`)})})++// Ken, 2026-11-02: in 20 minutes the PM got 23 messages; about half were agents' posts it had nothing to do with.+describe('the PM is not told what a step\'s agent says to its task', () => {+ it('a step agent that lost its step still reaches the owner, in the step', () => {+ const f = stepsFixture()+ const id = f.step('Review')+ const rev = f.add('rev', id)+ f.run({ type: 'work.assign', conversationId: id, agentId: rev }, f.as(f.dev))+ f.run({ type: 'work.status', conversationId: id, assignmentId: f.group(id).assignment!.id, status: 'done', result: 'Passed' } as Command, f.as(rev))+ const posted = f.run({ type: 'message.send', conversationId: id, text: 'Re-read the new head: still passes.', replyTo: null, recipientIds: [] } as Command, f.as(rev)).messages+ expect(posted.map(m => m.recipients)).toEqual([[f.dev]])+ })+ it('an agent whose step is done still reaches the owner, in the task', () => {+ const f = stepsFixture()+ const id = f.step('Review')+ const rev = f.add('rev', id)+ f.run({ type: 'work.assign', conversationId: id, agentId: rev }, f.as(f.dev))+ f.run({ type: 'work.status', conversationId: id, assignmentId: f.group(id).assignment!.id, status: 'done', result: 'Passed' } as Command, f.as(rev))+ const posted = f.run({ type: 'message.send', conversationId: f.task, text: 'Both re-checks pass.', replyTo: null, recipientIds: [] } as Command, f.as(rev)).messages+ expect(posted.map(m => m.recipients)).toEqual([[f.dev]])+ })+ it('the PM is not told a step-only agent is idle', () => {+ const f = stepsFixture()+ const id = f.step('Review')+ const rev = f.add('rev', id)+ f.run({ type: 'work.assign', conversationId: id, agentId: rev }, f.as(f.dev))+ f.run({ type: 'work.status', conversationId: id, assignmentId: f.group(id).assignment!.id, status: 'done', result: 'Passed' } as Command, f.as(rev))+ f.run({ type: 'work.status', conversationId: f.task, assignmentId: f.group(f.task).assignment!.id, status: 'done', result: 'Merged' } as Command, f.as(f.dev))+ const project = f.state.projects![0]!.id+ const notices = idleNotices(f.state, project, f.now + 60 * 60_000, new Set()).map(n => n.source?.agentId)+ // The Engineer, idle with its task done, is still told: an idle Engineer is stopped.+ expect(notices).toContain(f.dev)+ expect(notices).not.toContain(rev)+ })+})diff --git a/backend/src/superTabs/steps.ts b/backend/src/superTabs/steps.tsindex 7b862ca19..f5c7bda88 100644--- a/backend/src/superTabs/steps.ts+++ b/backend/src/superTabs/steps.ts@@ -54,6 +54,14 @@ export function taskOwner(state: SuperTabState, step: Conversation): string | nureturn task ? ownerOf(state, task) : null}-/** Whether [agentId] holds an open step of task [taskId]. */+/** Whether [agentId] holds or held a step of task [taskId], open or finished: its posts there are about that step's work+ * (Ken, 2026-11-02: a Reviewer's "both re-checks pass", after its step was done, reached the PM). */export const holdsStepOf = (state: SuperTabState, taskId: string, agentId: string): boolean =>- stepsOf(state, taskId).some(s => activeWork(s) && s.assignment!.agentId === agentId)+ stepsOf(state, taskId).some(s => s.assignment?.agentId === agentId)++/** Whether [agentId] has held steps only, never a task, in the groups loaded: a Reviewer or Tester the instructions keep,+ * whatever its role is called, so its idle time is no news for the coordinator. */+export const onlyStepsHeld = (groups: readonly Conversation[], agentId: string): boolean => {+ const held = groups.filter(g => g.assignment?.agentId === agentId)+ return held.length > 0 && held.every(isStep)+}diff --git a/backend/src/superTabs/tidy.ts b/backend/src/superTabs/tidy.tsindex b9a5dbe58..dbf4b5171 100644--- a/backend/src/superTabs/tidy.ts+++ b/backend/src/superTabs/tidy.ts@@ -1,3 +1,4 @@+import { onlyStepsHeld } from './steps.js'import { isBuddy } from './buddies.js'import { agentDisplayName } from './agentNames.js'import { activeWork, stableId, type Agent, type Conversation, type MessageDraft, type SuperTabState } from './model.js'@@ -58,6 +59,9 @@ export function idleNotices(state: SuperTabState, projectId: string, now: number|| agentProjectId(state, target) !== projectId || waitingToResume(state, target)) continueconst groups = groupsOf(state, target)if (groups.some(activeWork)) continue+ // A Reviewer or Tester, by what it worked on: the instructions keep it while the work it checked is open (Ken,+ // 2026-11-02: "Tester has had no open task" twice in 8 minutes, nothing for the PM to do).+ if (onlyStepsHeld(groups, target.id)) continueconst since = idleSince(target, groups)if (since === undefined || now - since < IDLE_NOTICE_MS || target.idleNoticedAt === since) continuetarget.idleNoticedAt = sincediff --git a/docs/swarms.md b/docs/swarms.mdindex 16cc993f6..0f6a9d1a4 100644--- a/docs/swarms.md+++ b/docs/swarms.md@@ -1130,7 +1130,10 @@ lease, attempts, costs and checks; readers show it inside its task.coordinator; an unnamed post from its agent, in the step or in the task, doestoo. The owner is the task's assignee while that agent is in the Swarm, itsown work done or not (a late verdict is still its to act on); with none, the- coordinator hears them.+ coordinator hears them. Any agent's unnamed post in a step, and in a task from+ an agent that held one of its steps (open or done), goes to the owner too. An+ agent that has held only steps is never reported idle: the instructions keep+ Reviewers and Testers.- **Closing**: a step archives and sleeps with its task, never on its own clock;archiving a task cancels its open steps and tells their agents.- **Reading**: `status` prints steps under their task; `mine` and `task GROUP`