@bastani/atomic 0.9.19-alpha.2 → 0.9.19-alpha.4

package/dist/modes/interactive/components/task-row.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-row.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/task-row.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAkB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAElE,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;AAC3F,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAC9D,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,cAAc,CAAC;IAClE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;AACvE,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,IAAqD;IAClF,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,eAAe,CACrB,CAAC,IAAI,CAAC,KAAK,IAAI,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAC7G,KAAK,CACL,CACD,CAAC;AACH,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,YAAoB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;AACvF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IAKpD,QAAQ,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,KAAK,WAAW;YACf,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC5D,KAAK,QAAQ;YACZ,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACvD,KAAK,WAAW;YACf,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC1D,KAAK,YAAY;YAChB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC3D,KAAK,cAAc;YAClB,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC/D,KAAK,QAAQ;YACZ,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACvD;YACC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,OAAO;QACN,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;QACvE,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS;QAC/F,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;KAC5G;SACC,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,KAAK,CAAC,CAAC;AACf,CAAC;AASD,MAAM,OAAO,OAAO;IAGnB,YAAY,IAAgB,EAAE,OAAO,GAAmB,EAAE;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IACD,UAAU,KAAU,CAAC;IACrB,MAAM,CAAC,KAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,CAAC;YACpF,CAAC,CAAC,SAAS,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;QACnF,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,CAAC,IAAgB,EAAE,EAAE,CACzC,eAAe,CACd,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAC1E,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CACzB,CAAC;QACH,MAAM,SAAS,GACd,IAAI,CAAC,OAAO,CAAC,SAAS;YACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAC1B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,CAC1F,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GACV,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;YACtB,GAAG;YACH,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QACxG,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9G,MAAM,MAAM,GACX,IAAI,IAAI,IAAI,CAAC,aAAa;YACzB,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE;YAC9F,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,YAAY,CAAC;QACpG,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3G,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACtG,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACxG,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC;YAC/G,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC,CAAC;YAC9F,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,QAAQ,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;gBAE3G,KAAK,CAAC,IAAI,CACT,KAAK,CAAC,EAAE,CACP,KAAK,EACL,IAAI,CAAC,aAAa;oBACjB,CAAC,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE;oBAC/F,CAAC,CAAC,0BAA0B,CAC7B,CACD,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,iDAAiD,CAAC,CAAC,CAAC;YAC/E,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAC/E,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CACzB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACb,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/F,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAChC,CAAC;QACF,IAAI,OAAO,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;gBACjC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,QAAQ,CAAC,OAAO,CACf,KAAK,CAAC,IAAI,CACT,eAAe,CACd,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAC7I,KAAK,CACL,CACD,CACD,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxF,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;CACD;AAED,SAAS,qBAAqB,CAAC,QAAiC;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;aACrE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,cAAc;YACrF,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9B,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACd,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { type Component, truncateToWidth } from \"@earendil-works/pi-tui\";\nimport { taskOutcomeStatus } from \"../../../core/tasks/command-output.js\";\nimport type { TaskRecord } from \"../../../core/tasks/contracts.js\";\nimport type { TaskActivity } from \"../../../core/tasks/owner-store.js\";\nimport { theme } from \"../theme/theme.js\";\nimport { keyHintIfBound as keyHint } from \"./keybinding-hints.js\";\n\n/** Control removal and truncation apply only to terminal display, never task identity. */\nexport function taskDisplayText(text: string): string {\n\treturn text.replace(/\\x1b\\[[0-?]*[ -/]*[@-~]/g, \"\").replace(/[\\x00-\\x1f\\x7f-\\x9f]/g, \" \");\n}\nexport function taskState(task: TaskRecord): string {\n\tif (task.execution.kind === \"settled\") return taskOutcomeStatus(task.execution.result, task.kind);\n\tif (task.execution.kind === \"cancelling\") return \"cancelling\";\n\tif (task.attention.kind === \"input-needed\") return \"input-needed\";\n\treturn task.execution.kind;\n}\nexport function taskLabel(task: TaskRecord): string {\n\treturn task.kind === \"command\" ? \"bash\" : (task.agentName ?? \"agent\");\n}\nexport function taskTitle(task: TaskRecord): string {\n\treturn task.title || taskLabel(task);\n}\nexport function taskModelText(task: Pick<TaskRecord, \"kind\" | \"model\" | \"thinking\">): string {\n\tif (task.kind !== \"agent\") return \"\";\n\treturn taskDisplayText(\n\t\t[task.model ?? \"model unavailable\", task.thinking ? `thinking ${task.thinking}` : \"thinking unavailable\"].join(\n\t\t\t\" · \",\n\t\t),\n\t);\n}\nexport function taskShortId(task: TaskRecord): string {\n\treturn createHash(\"sha256\").update(task.ref.taskId).digest(\"hex\").slice(0, 6);\n}\nexport function taskDuration(milliseconds: number): string {\n\tconst seconds = Math.max(0, Math.floor(milliseconds / 1000));\n\treturn seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${seconds % 60}s`;\n}\n\n/** One semantic status palette for inline rows, lists and detail headers. */\nexport function taskStatusAppearance(task: TaskRecord): {\n\tlabel: string;\n\ticon: string;\n\tcolor: \"accent\" | \"success\" | \"error\" | \"warning\" | \"muted\";\n} {\n\tswitch (taskState(task)) {\n\t\tcase \"completed\":\n\t\t\treturn { label: \"Completed\", icon: \"✓\", color: \"success\" };\n\t\tcase \"failed\":\n\t\t\treturn { label: \"Failed\", icon: \"✗\", color: \"error\" };\n\t\tcase \"cancelled\":\n\t\t\treturn { label: \"Stopped\", icon: \"✗\", color: \"warning\" };\n\t\tcase \"cancelling\":\n\t\t\treturn { label: \"Stopping\", icon: \"!\", color: \"warning\" };\n\t\tcase \"input-needed\":\n\t\t\treturn { label: \"Input needed\", icon: \"?\", color: \"warning\" };\n\t\tcase \"queued\":\n\t\t\treturn { label: \"Queued\", icon: \"○\", color: \"muted\" };\n\t\tdefault:\n\t\t\treturn { label: \"Running\", icon: \"∀\", color: \"accent\" };\n\t}\n}\n\nexport function taskMetricsText(task: TaskRecord): string {\n\tconst metrics = task.metrics;\n\treturn [\n\t\tmetrics?.elapsedMs === undefined ? \"\" : taskDuration(metrics.elapsedMs),\n\t\tmetrics?.tokenCount === undefined ? \"\" : `${metrics.tokenCount.toLocaleString(\"en-US\")} tokens`,\n\t\tmetrics?.toolCount === undefined ? \"\" : `${metrics.toolCount} ${metrics.toolCount === 1 ? \"tool\" : \"tools\"}`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\" · \");\n}\nexport type TaskRowOptions = {\n\texpanded?: boolean;\n\tduplicate?: boolean;\n\thint?: boolean;\n\tsiblings?: readonly TaskRecord[];\n\tactivity?: readonly TaskActivity[];\n\tactivityOmitted?: boolean;\n};\nexport class TaskRow implements Component {\n\tprivate readonly task: TaskRecord;\n\tprivate readonly options: TaskRowOptions;\n\tconstructor(task: TaskRecord, options: TaskRowOptions = {}) {\n\t\tthis.task = task;\n\t\tthis.options = options;\n\t}\n\tinvalidate(): void {}\n\trender(width: number): string[] {\n\t\tconst task = this.task;\n\t\tconst group = task.launchGroupId\n\t\t\t? this.options.siblings?.filter((item) => item.launchGroupId === task.launchGroupId)\n\t\t\t: undefined;\n\t\tconst index = group?.findIndex((item) => item.ref.taskId === task.ref.taskId) ?? -1;\n\t\tconst grouped = group !== undefined && index >= 0;\n\t\tconst rowWidth = Math.max(1, width - (grouped ? 2 : 0));\n\t\tconst state = taskState(task);\n\t\tconst live = task.execution.kind === \"running\" || task.execution.kind === \"queued\";\n\t\tconst badge = live && task.observation.kind !== \"none\" ? ` · ${task.observation.kind}` : \"\";\n\t\tconst { icon: glyph, color } = taskStatusAppearance(task);\n\t\tconst displayLabel = (item: TaskRecord) =>\n\t\t\ttruncateToWidth(\n\t\t\t\t`${taskDisplayText(taskLabel(item))}: ${taskDisplayText(taskTitle(item))}`,\n\t\t\t\tMath.max(1, rowWidth - 2),\n\t\t\t);\n\t\tconst duplicate =\n\t\t\tthis.options.duplicate ||\n\t\t\tthis.options.siblings?.some(\n\t\t\t\t(item) => item.ref.taskId !== task.ref.taskId && displayLabel(item) === displayLabel(task),\n\t\t\t);\n\t\tconst suffix = duplicate ? ` [${taskShortId(task)}]` : \"\";\n\t\tconst title =\n\t\t\ttheme.fg(color, glyph) +\n\t\t\t\" \" +\n\t\t\ttheme.bold(taskDisplayText(taskLabel(task))) +\n\t\t\ttheme.fg(\"muted\", `: ${taskDisplayText(taskTitle(task))}`);\n\t\tconst lines = [truncateToWidth(title, Math.max(1, rowWidth - suffix.length)) + theme.fg(\"dim\", suffix)];\n\t\tif (task.kind === \"agent\") lines.push(theme.fg(\"dim\", truncateToWidth(`  ${taskModelText(task)}`, rowWidth)));\n\t\tconst action =\n\t\t\tlive && task.currentAction\n\t\t\t\t? ` · ${taskDisplayText(task.currentAction.tool)} ${taskDisplayText(task.currentAction.text)}`\n\t\t\t\t: \"\";\n\t\tconst tools = task.metrics?.toolCount === undefined ? \"\" : ` · ${task.metrics.toolCount} tool uses`;\n\t\tconst duration = task.metrics?.elapsedMs === undefined ? \"\" : ` · ${taskDuration(task.metrics.elapsedMs)}`;\n\t\tlines.push(theme.fg(\"dim\", truncateToWidth(`  ${state}${badge}${tools}${duration}${action}`, width)));\n\t\tif (this.options.expanded) {\n\t\t\tlines.push(theme.fg(\"dim\", truncateToWidth(`  ${task.ref.taskId} · owner ${task.ref.ownerId}`, width)));\n\t\t\tif (task.metrics?.tokenCount !== undefined) lines.push(theme.fg(\"dim\", `  ${task.metrics.tokenCount} tokens`));\n\t\t\tlines.push(\"  Activity\");\n\t\t\tif (this.options.activityOmitted) lines.push(theme.fg(\"dim\", \"    Earlier activity omitted\"));\n\t\t\tconst retained = retainedActivityLines(this.options.activity ?? []);\n\t\t\tif (retained.length) lines.push(...retained.map((text) => theme.fg(\"dim\", `    ${taskDisplayText(text)}`)));\n\t\t\telse\n\t\t\t\tlines.push(\n\t\t\t\t\ttheme.fg(\n\t\t\t\t\t\t\"dim\",\n\t\t\t\t\t\ttask.currentAction\n\t\t\t\t\t\t\t? `    ${taskDisplayText(task.currentAction.tool)} ${taskDisplayText(task.currentAction.text)}`\n\t\t\t\t\t\t\t: \"    No retained activity\",\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\tlines.push(theme.fg(\"dim\", \"  /tasks to inspect transcript and task details\"));\n\t\t\tif (task.execution.kind === \"settled\" && task.execution.result.kind === \"failed\")\n\t\t\t\tlines.push(truncateToWidth(`    ${taskDisplayText(task.execution.result.message)}`, width));\n\t\t}\n\t\tconst rendered = lines.map(\n\t\t\t(line, row) =>\n\t\t\t\t(grouped ? theme.fg(\"dim\", row === 0 ? (index === group.length - 1 ? \"└─\" : \"├─\") : \"  \") : \"\") +\n\t\t\t\ttruncateToWidth(line, rowWidth),\n\t\t);\n\t\tif (grouped && index === 0) {\n\t\t\tconst labels = new Set(group.map(taskLabel));\n\t\t\tconst counts = new Map<string, number>();\n\t\t\tfor (const sibling of group) {\n\t\t\t\tconst state = taskState(sibling);\n\t\t\t\tcounts.set(state, (counts.get(state) ?? 0) + 1);\n\t\t\t}\n\t\t\trendered.unshift(\n\t\t\t\ttheme.bold(\n\t\t\t\t\ttruncateToWidth(\n\t\t\t\t\t\t`${labels.size === 1 ? taskDisplayText(taskLabel(task)) : \"Tasks\"} · ${[...counts].map(([state, count]) => `${count} ${state}`).join(\" · \")}`,\n\t\t\t\t\t\twidth,\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (this.options.hint !== false && (!grouped || index === group.length - 1)) {\n\t\t\tconst hint = keyHint(\"app.tools.expand\", this.options.expanded ? \"collapse\" : \"expand\");\n\t\t\tif (hint) rendered.push(theme.fg(\"dim\", hint));\n\t\t}\n\t\treturn rendered.map((line) => truncateToWidth(line, width));\n\t}\n}\n\nfunction retainedActivityLines(activity: readonly TaskActivity[]): string[] {\n\tconst lines: string[] = [];\n\tconst decoder = new TextDecoder();\n\tfor (const { report } of activity) {\n\t\tconst change = report.change;\n\t\tif (change.kind === \"action\") lines.push(`${change.tool} ${change.text}`);\n\t\telse if (change.kind === \"output\") {\n\t\t\tconst text = decoder.decode(Buffer.from(change.bytesBase64, \"base64\"), { stream: true });\n\t\t\tif (text) lines.push(`Retained output: ${text}`);\n\t\t} else if (change.kind === \"attention-set\" && change.attention.kind === \"input-needed\")\n\t\t\tlines.push(`Input needed: ${change.attention.prompt}`);\n\t}\n\tconst tail = decoder.decode();\n\tif (tail) lines.push(`Retained output: ${tail}`);\n\treturn lines;\n}\n"]}
+{"version":3,"file":"task-row.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/task-row.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { type Component, truncateToWidth } from \"@earendil-works/pi-tui\";\nimport { taskOutcomeStatus } from \"../../../core/tasks/command-output.js\";\nimport type { TaskRecord } from \"../../../core/tasks/contracts.js\";\nimport type { TaskActivity } from \"../../../core/tasks/owner-store.js\";\nimport { theme } from \"../theme/theme.js\";\nimport { keyHintIfBound as keyHint } from \"./keybinding-hints.js\";\n\n/** Control removal and truncation apply only to terminal display, never task identity. */\nexport function taskDisplayText(text: string): string {\n\treturn text.replace(/\\x1b\\[[0-?]*[ -/]*[@-~]/g, \"\").replace(/[\\x00-\\x1f\\x7f-\\x9f]/g, \" \");\n}\nexport function taskState(task: TaskRecord): string {\n\tif (\n\t\ttask.kind === \"agent\" &&\n\t\ttask.execution.kind === \"settled\" &&\n\t\ttask.execution.result.kind === \"cancelled\" &&\n\t\ttask.execution.result.cause === \"user\"\n\t)\n\t\treturn \"killed\";\n\tif (task.execution.kind === \"settled\") return taskOutcomeStatus(task.execution.result, task.kind);\n\tif (task.execution.kind === \"cancelling\") return \"cancelling\";\n\tif (task.attention.kind === \"input-needed\") return \"input-needed\";\n\treturn task.execution.kind;\n}\nexport function taskLabel(task: TaskRecord): string {\n\treturn task.kind === \"command\" ? \"bash\" : (task.agentName ?? \"agent\");\n}\nexport function taskTitle(task: TaskRecord): string {\n\treturn task.title || taskLabel(task);\n}\nexport function taskModelText(task: Pick<TaskRecord, \"kind\" | \"model\" | \"thinking\">): string {\n\tif (task.kind !== \"agent\") return \"\";\n\treturn taskDisplayText(\n\t\t[task.model ?? \"model unavailable\", task.thinking ? `thinking ${task.thinking}` : \"thinking unavailable\"].join(\n\t\t\t\" · \",\n\t\t),\n\t);\n}\nexport function taskShortId(task: TaskRecord): string {\n\treturn createHash(\"sha256\").update(task.ref.taskId).digest(\"hex\").slice(0, 6);\n}\nexport function taskDuration(milliseconds: number): string {\n\tconst seconds = Math.max(0, Math.floor(milliseconds / 1000));\n\treturn seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${seconds % 60}s`;\n}\n\n/** One semantic status palette for inline rows, lists and detail headers. */\nexport function taskStatusAppearance(task: TaskRecord): {\n\tlabel: string;\n\ticon: string;\n\tcolor: \"accent\" | \"success\" | \"error\" | \"warning\" | \"muted\";\n} {\n\tswitch (taskState(task)) {\n\t\tcase \"completed\":\n\t\t\treturn { label: \"Completed\", icon: \"✓\", color: \"success\" };\n\t\tcase \"failed\":\n\t\t\treturn { label: \"Failed\", icon: \"✗\", color: \"error\" };\n\t\tcase \"killed\":\n\t\t\treturn { label: \"Killed (non-resumable)\", icon: \"■\", color: \"warning\" };\n\t\tcase \"cancelled\":\n\t\t\treturn { label: \"Stopped\", icon: \"✗\", color: \"warning\" };\n\t\tcase \"cancelling\":\n\t\t\treturn { label: \"Stopping\", icon: \"!\", color: \"warning\" };\n\t\tcase \"input-needed\":\n\t\t\treturn { label: \"Input needed\", icon: \"?\", color: \"warning\" };\n\t\tcase \"queued\":\n\t\t\treturn { label: \"Queued\", icon: \"○\", color: \"muted\" };\n\t\tdefault:\n\t\t\treturn { label: \"Running\", icon: \"∀\", color: \"accent\" };\n\t}\n}\n\nexport function taskMetricsText(task: TaskRecord): string {\n\tconst metrics = task.metrics;\n\treturn [\n\t\tmetrics?.elapsedMs === undefined ? \"\" : taskDuration(metrics.elapsedMs),\n\t\tmetrics?.tokenCount === undefined ? \"\" : `${metrics.tokenCount.toLocaleString(\"en-US\")} tokens`,\n\t\tmetrics?.toolCount === undefined ? \"\" : `${metrics.toolCount} ${metrics.toolCount === 1 ? \"tool\" : \"tools\"}`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\" · \");\n}\nexport type TaskRowOptions = {\n\texpanded?: boolean;\n\tduplicate?: boolean;\n\thint?: boolean;\n\tsiblings?: readonly TaskRecord[];\n\tactivity?: readonly TaskActivity[];\n\tactivityOmitted?: boolean;\n};\nexport class TaskRow implements Component {\n\tprivate readonly task: TaskRecord;\n\tprivate readonly options: TaskRowOptions;\n\tconstructor(task: TaskRecord, options: TaskRowOptions = {}) {\n\t\tthis.task = task;\n\t\tthis.options = options;\n\t}\n\tinvalidate(): void {}\n\trender(width: number): string[] {\n\t\tconst task = this.task;\n\t\tconst group = task.launchGroupId\n\t\t\t? this.options.siblings?.filter((item) => item.launchGroupId === task.launchGroupId)\n\t\t\t: undefined;\n\t\tconst index = group?.findIndex((item) => item.ref.taskId === task.ref.taskId) ?? -1;\n\t\tconst grouped = group !== undefined && index >= 0;\n\t\tconst rowWidth = Math.max(1, width - (grouped ? 2 : 0));\n\t\tconst state = taskState(task) === \"killed\" ? \"killed (non-resumable)\" : taskState(task);\n\t\tconst live = task.execution.kind === \"running\" || task.execution.kind === \"queued\";\n\t\tconst badge = live && task.observation.kind !== \"none\" ? ` · ${task.observation.kind}` : \"\";\n\t\tconst { icon: glyph, color } = taskStatusAppearance(task);\n\t\tconst displayLabel = (item: TaskRecord) =>\n\t\t\ttruncateToWidth(\n\t\t\t\t`${taskDisplayText(taskLabel(item))}: ${taskDisplayText(taskTitle(item))}`,\n\t\t\t\tMath.max(1, rowWidth - 2),\n\t\t\t);\n\t\tconst duplicate =\n\t\t\tthis.options.duplicate ||\n\t\t\tthis.options.siblings?.some(\n\t\t\t\t(item) => item.ref.taskId !== task.ref.taskId && displayLabel(item) === displayLabel(task),\n\t\t\t);\n\t\tconst suffix = duplicate ? ` [${taskShortId(task)}]` : \"\";\n\t\tconst title =\n\t\t\ttheme.fg(color, glyph) +\n\t\t\t\" \" +\n\t\t\ttheme.bold(taskDisplayText(taskLabel(task))) +\n\t\t\ttheme.fg(\"muted\", `: ${taskDisplayText(taskTitle(task))}`);\n\t\tconst lines = [truncateToWidth(title, Math.max(1, rowWidth - suffix.length)) + theme.fg(\"dim\", suffix)];\n\t\tif (task.kind === \"agent\") lines.push(theme.fg(\"dim\", truncateToWidth(`  ${taskModelText(task)}`, rowWidth)));\n\t\tconst action =\n\t\t\tlive && task.currentAction\n\t\t\t\t? ` · ${taskDisplayText(task.currentAction.tool)} ${taskDisplayText(task.currentAction.text)}`\n\t\t\t\t: \"\";\n\t\tconst tools = task.metrics?.toolCount === undefined ? \"\" : ` · ${task.metrics.toolCount} tool uses`;\n\t\tconst duration = task.metrics?.elapsedMs === undefined ? \"\" : ` · ${taskDuration(task.metrics.elapsedMs)}`;\n\t\tlines.push(theme.fg(\"dim\", truncateToWidth(`  ${state}${badge}${tools}${duration}${action}`, width)));\n\t\tif (this.options.expanded) {\n\t\t\tlines.push(theme.fg(\"dim\", truncateToWidth(`  ${task.ref.taskId} · owner ${task.ref.ownerId}`, width)));\n\t\t\tif (task.metrics?.tokenCount !== undefined) lines.push(theme.fg(\"dim\", `  ${task.metrics.tokenCount} tokens`));\n\t\t\tlines.push(\"  Activity\");\n\t\t\tif (this.options.activityOmitted) lines.push(theme.fg(\"dim\", \"    Earlier activity omitted\"));\n\t\t\tconst retained = retainedActivityLines(this.options.activity ?? []);\n\t\t\tif (retained.length) lines.push(...retained.map((text) => theme.fg(\"dim\", `    ${taskDisplayText(text)}`)));\n\t\t\telse\n\t\t\t\tlines.push(\n\t\t\t\t\ttheme.fg(\n\t\t\t\t\t\t\"dim\",\n\t\t\t\t\t\ttask.currentAction\n\t\t\t\t\t\t\t? `    ${taskDisplayText(task.currentAction.tool)} ${taskDisplayText(task.currentAction.text)}`\n\t\t\t\t\t\t\t: \"    No retained activity\",\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\tlines.push(theme.fg(\"dim\", \"  /tasks to inspect transcript and task details\"));\n\t\t\tif (task.execution.kind === \"settled\" && task.execution.result.kind === \"failed\")\n\t\t\t\tlines.push(truncateToWidth(`    ${taskDisplayText(task.execution.result.message)}`, width));\n\t\t}\n\t\tconst rendered = lines.map(\n\t\t\t(line, row) =>\n\t\t\t\t(grouped ? theme.fg(\"dim\", row === 0 ? (index === group.length - 1 ? \"└─\" : \"├─\") : \"  \") : \"\") +\n\t\t\t\ttruncateToWidth(line, rowWidth),\n\t\t);\n\t\tif (grouped && index === 0) {\n\t\t\tconst labels = new Set(group.map(taskLabel));\n\t\t\tconst counts = new Map<string, number>();\n\t\t\tfor (const sibling of group) {\n\t\t\t\tconst state = taskState(sibling);\n\t\t\t\tcounts.set(state, (counts.get(state) ?? 0) + 1);\n\t\t\t}\n\t\t\trendered.unshift(\n\t\t\t\ttheme.bold(\n\t\t\t\t\ttruncateToWidth(\n\t\t\t\t\t\t`${labels.size === 1 ? taskDisplayText(taskLabel(task)) : \"Tasks\"} · ${[...counts].map(([state, count]) => `${count} ${state}`).join(\" · \")}`,\n\t\t\t\t\t\twidth,\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (this.options.hint !== false && (!grouped || index === group.length - 1)) {\n\t\t\tconst hint = keyHint(\"app.tools.expand\", this.options.expanded ? \"collapse\" : \"expand\");\n\t\t\tif (hint) rendered.push(theme.fg(\"dim\", hint));\n\t\t}\n\t\treturn rendered.map((line) => truncateToWidth(line, width));\n\t}\n}\n\nfunction retainedActivityLines(activity: readonly TaskActivity[]): string[] {\n\tconst lines: string[] = [];\n\tconst decoder = new TextDecoder();\n\tfor (const { report } of activity) {\n\t\tconst change = report.change;\n\t\tif (change.kind === \"action\") lines.push(`${change.tool} ${change.text}`);\n\t\telse if (change.kind === \"output\") {\n\t\t\tconst text = decoder.decode(Buffer.from(change.bytesBase64, \"base64\"), { stream: true });\n\t\t\tif (text) lines.push(`Retained output: ${text}`);\n\t\t} else if (change.kind === \"attention-set\" && change.attention.kind === \"input-needed\")\n\t\t\tlines.push(`Input needed: ${change.attention.prompt}`);\n\t}\n\tconst tail = decoder.decode();\n\tif (tail) lines.push(`Retained output: ${tail}`);\n\treturn lines;\n}\n"]}

package/docs/background-tasks.md

@@ -35,7 +35,7 @@ The agent can choose foreground-first or background observation for each authori
 
 If the task finishes during observation, the call returns its terminal result instead. Automatic backgrounding is **observation expiry**, not a slow-task failure, a restart, or a second execution. Use foreground-first observation for a dependency and background observation for independent work. If a dependency yields, wait for its actual completion before using the result.
 
-Shell `budgetMs` accepts finite non-negative milliseconds; zero means no observation delay. It is only valid for foreground observation. A trusted SDK host can override the usual budgets or select `tasks.wait.kind: "until-settled"`; omitted foreground budgets then wait until settlement. Explicit per-call budgets still take precedence.
+Shell `budgetMs` accepts finite non-negative milliseconds; zero means no observation delay. On command launches it belongs inside a foreground `wait`; existing-task `action: "wait"` calls take it at the top level. A trusted SDK host can override the usual budgets or select `tasks.wait.kind: "until-settled"`; omitted foreground budgets then wait until settlement. Explicit per-call budgets still take precedence.
 
 Native observation timers run independently of JavaScript. A zero-budget wait can already be backgrounded by the time a caller reads the next task snapshot, even before JavaScript awaits the result. Synchronous wait registration does not guarantee a visible foreground interval. The elapsed result still identifies the same wait and task; execution continues.
 
@@ -94,6 +94,8 @@ subagent({ action: "status", id: taskId })
 
 Do not launch a duplicate just to retrieve its result. Use the task ID returned at launch. IDs are scoped to the session or workflow stage that owns them.
 
+Foreground subagent launches and explicit `action: "wait"` calls also yield when user steering or an Intercom ask/send is admitted to the waiting parent, in main chat or a live workflow stage. The message stays in the normal delivery queue so the parent can handle it and reply. This releases only observation: children keep running under the same task IDs, and other owners' waits are unaffected.
+
 ### Completion messages
 
 Completion creates a shaded notification card in the owning chat without depending on a model reply. It uses the chat theme's card background and padding, with a colored outcome, the agent or shell name, and an available result preview:
@@ -166,6 +168,29 @@ bash({ command: "npm run check" })
 
 The shell execution timeout is separate: `timeout` is seconds and defaults to 300, with a maximum of 3600. It continues counting after backgrounding. Choose a timeout appropriate for the command; reducing `budgetMs` does not shorten or extend it. Use the returned task ID to inspect or stop the existing task through `/tasks`. Background completion notifies the parent automatically, so there is no need to launch the command again to collect its result.
 
+Observe an existing task without running its command again:
+
+```ts
+bash({ action: "wait", id: taskId, budgetMs: 1000 })
+powershell({ action: "wait", id: taskId, budgetMs: 1000 })
+```
+
+Use the original task ID from the same owning session or workflow stage. Omit `budgetMs` to use the owner's command observation policy, or pass `0` to poll. A wait returns retained output and a yielded or settled observation; settled results include available exit and failure details. While running, successive yielded waits advance through retained output in bounded pages, including after a session reload. A caught-up wait returns no output until more arrives. Settled waits return all retained output again, subject to labelled gaps and truncation, so they may repeat output you have already seen.
+
+Do not combine `action: "wait"` with `command`, `timeout`, `wait`, `env`, `cwd`, or `pty`. Existing-task waits require a supported task owner, even with custom execution adapters. Unknown or foreign IDs are rejected. Cancelling a wait or admitting user/Intercom messages releases observation only, not the command. Waiting never extends the original execution timeout or the owner's lifetime.
+
+### Stop a shell task from a tool call
+
+Use the `kill` tool with the exact task ID returned by `bash` or `powershell`, whether it launched explicitly in the background or automatically yielded:
+
+```ts
+kill({ id: taskId })
+```
+
+The same command works in main and workflow-stage chat. It selects the existing owned shell task; do not supply a process ID, shell name, or another owner's task ID. Unknown, malformed, foreign-owner, and subagent IDs are rejected. `/tasks` stop controls remain available.
+
+The response includes `taskId`, `decision`, `execution`, and `cleanup`. `cancellation-requested` means cancellation was requested, not that termination or cleanup has finished. A repeated call preserves that decision while reporting current state. `already-settled` means the task finished before cancellation and keeps its original outcome. Confirm `execution.kind: "settled"` and `cleanup.kind: "reaped"` before treating termination and cleanup as complete. Cleanup failures remain errors, not successful stops. Output and completion notifications remain available; killing a task does not erase its history.
+
 Shell completions use the same shaded card as subagents, with a retained output preview and available exit code. Nonzero shell exits are shown as failures even though the process itself reached a terminal state. Cancellation shows Stopped. The card and below-prompt count update in the owning main or workflow-stage chat.
 
 Native Windows owned shells use supervised pipes or ConPTY, with Job Object containment before execution resumes and confirmed cleanup. If containment cannot be established, launch is refused rather than falling back to unsupervised execution. The legacy Windows WSL `bash.exe` stdin transport remains unsupported for owned launch because Windows jobs cannot supervise Linux guest processes. Running Atomic inside WSL uses the normal POSIX/Bash path.
@@ -174,7 +199,11 @@ Bash calls inside subagent sessions retain their existing execution paths. Witho
 
 ## Lifetime and scope
 
-Background means independent of the current observation, not independent of its owner. Pausing main chat or a workflow-node chat aborts the foreground turn only; already-running background agents and shells keep their identities, output, and later completion. Closing a session cancels its session-owned work. Workflow-stage tasks belong to the stage generation: detaching a pane, pausing, or ending a single model turn does not cancel them. Closing that generation does, without cancelling sibling stages. Closing `/tasks` only disposes the view. Explicit `/tasks` stop and declared execution timeouts remain separate controls.
+Background means independent of the current observation, not independent of its owner. **Pausing main chat** aborts the foreground turn only; its background agents and shells keep running. Detaching a workflow pane, ending a model turn, or closing `/tasks` also leaves owned background work alone.
+
+**Pausing a workflow stage** blocks new task launches immediately and cancels that stage generation's active and admitted queued agents and commands. Queued agents are cancelled before active cancellations free execution slots. Command setup already in flight may briefly start a shell during the pause transition; pause waits for those admissions, cancels the resulting shells, and confirms resource cleanup before completing. A successful pause leaves no owned active or queued executions. Cancellation or cleanup failures are reported instead of confirming pause. Main-chat tasks, sibling stages, and future stage generations are unaffected by a stage-scoped pause.
+
+Pause does not close the stage's message generation: queued user and Intercom messages remain held for resume. Resume permits fresh launches but never resurrects cancelled executions; retained task results remain inspectable. Closing a session or stage generation still cancels its remaining owned work. Explicit `/tasks` stop and declared execution timeouts remain separate controls.
 
 On native Windows, Suspend opens a PowerShell subshell rather than freezing Atomic. Exit the subshell to restore the same session; owned background tasks continue while it is open.
 

package/docs/compaction.md

@@ -108,6 +108,26 @@ Configure defaults in `~/.atomic/agent/settings.json` or `.atomic/settings.json`
 
 `reserveTokens` controls the automatic threshold that decides when compaction runs; it is not converted into a classifier line ratio. Manual calls can pass parameter overrides through the SDK.
 
+### Per-model budgets
+
+Use `compaction.modelOverrides` to set `reserveTokens` and/or `preserve_recent` for an exact `"provider/modelId"` key. For example:
+
+```json
+{
+  "compaction": {
+    "reserveTokens": 16384,
+    "preserve_recent": 2,
+    "modelOverrides": {
+      "anthropic/claude-sonnet-4-5": { "reserveTokens": 32768, "preserve_recent": 4 }
+    }
+  }
+}
+```
+
+Each field falls back independently to the ordinary setting, then its built-in default. Keys are case-sensitive and do not support wildcards or reasoning suffixes. Both fields require non-negative safe integers. The active session model selects the budgets for manual, automatic, overflow, and post-tool compaction; switching models changes the next resolution, while borrowing a fallback planner does not. Explicit manual parameters take precedence over resolved defaults.
+
+Atomic intentionally differs from upstream pi: the recent-history override is an exact message count (`preserve_recent`), not a token budget (`keepRecentTokens`). Verbatim line reconstruction, `compression_ratio`, and `query` are unchanged; the latter two and `enabled` remain ordinary settings. See [Settings](/settings#compaction) for merge and validation details.
+
 ## When compaction runs
 
 - **Manual:** `/compact`, `ctx.compact()`, `session.compact()`, or RPC `{ "type": "compact" }`.

package/docs/computer-use.md

@@ -0,0 +1,390 @@
+---
+title: "Computer use"
+description: "Use desktop apps, browsers, and terminals with Atomic on macOS, Linux, and Windows."
+---
+
+# Computer use
+
+Atomic can work in applications, not just edit code. Computer-use automation, or CUA, can create a Blender scene, build a presentation, edit a video, operate a desktop app, or move work between applications. Browser and terminal automation cover related tasks with more direct controls.
+
+This guide explains tool selection, setup, and safe operation. To test a software change and attach the results to a PR, see [Verification and evidence](/workflows/verification).
+
+Jump to [application scripting](#application-scripting-and-apis), [desktop CUA](#desktop-automation-with-pyautogui-and-uv), [browser automation](#browser-automation-with-playwright-cli), [terminal automation](#terminal-automation-with-herdr), or [creative workflows](#creative-work-and-cua-workflows). Platform setup: [macOS](#macos), [Linux](#linux), [Windows](#windows).
+
+## Choose the right tool
+
+Start with the result you need, not the application you could click through. If a library, CLI, or supported API can produce that result directly, a short script is often simpler and more token-efficient than repeated screenshots and UI actions. Use computer use when the task needs visual judgment, a UI-only operation, or verification of the interface itself. Saving tokens is useful, but not at the expense of the requested behavior or output quality.
+
+| Task | Preferred tool | When to use something else |
+| --- | --- | --- |
+| Create or edit files, such as presentations, documents, spreadsheets, or media | **A file library or CLI** | Use an app API or UI when the library cannot preserve required features, or when you need rendering or visual adjustments. |
+| Interactive terminal or TUI | **Herdr** | Use tmux on macOS/Linux or native Windows psmux when Herdr cannot be used. Ordinary shell commands need no multiplexer. |
+| Browser page or web application | **playwright-cli** | Use desktop CUA for browser chrome or OS dialogs that browser automation cannot reach. Keep existing Playwright test suites for repeatable tests. |
+| Desktop application or work across apps | **PyAutoGUI, run with uv** | Use native accessibility tools, application scripting, or a CLI when they make the task easier, safer, or more reliable. |
+
+You can combine tools without driving the whole task through a desktop. Generate a presentation with `python-pptx`, then inspect rendered slides for layout problems. Use Blender's Python API to generate repeated objects, then PyAutoGUI for adjustments in the visible editor. Use browser DOM controls rather than desktop clicks for a web form. For a supported web-service operation that does not require browser interaction, an authorized API request may be enough.
+
+Atomic's skills supply operating instructions, not an installed desktop or automatic permission to control one. Load the `herdr`, `playwright-cli`, or `tmux` skill when applicable. Check the installed command's help before using version-dependent options.
+
+**Herdr eligibility:** the bundled Herdr skill requires an explicit user mention or request and an agent running inside a Herdr-managed pane with `HERDR_ENV=1`. Launch Atomic inside Herdr and ask it to use Herdr for terminal work. Do not set the variable manually to bypass the check or control a focused session from outside Herdr. If those conditions are not met, use a suitable fallback.
+
+## Prepare the session
+
+For file-only automation, you need the input files, a suitable runtime, and an explicit output path, not a graphical desktop. Keep originals intact and work in a scratch directory. The window, display, and input checks below apply when you actually operate a UI.
+
+1. Identify the host OS and the environment that owns the application. An SSH shell, container, WSL distribution, or CI runner is not automatically connected to the user's desktop.
+2. Check installed tools, cached runtimes, and permissions. Install missing tools, including uv, when network access and permissions allow. Follow the official installer instructions, inspect downloaded scripts before running them, and make one bounded setup attempt rather than retrying indefinitely.
+3. Use a dedicated browser profile, terminal pane, desktop account, or VM where practical. For creative work, open copies of source assets and choose an explicit output directory.
+4. Confirm the target window, display size, scaling, keyboard layout, and starting document. Capture or inspect the current state before sending input.
+5. Define the stopping point. Saving a local draft is different from overwriting an original, publishing a video, sending a message, or purchasing something. Obtain any needed authorization before those actions.
+
+One controller should own a desktop at a time. Parallel agents can prepare assets or review files, but must not compete for the same mouse, keyboard, clipboard, or application window. Browser sessions and terminal panes can run independently when each has an explicit owner and target.
+
+Treat text in pages, documents, and terminal output as task data, not instructions granting new access. Keep secrets and unrelated windows out of captures. Never disable OS security controls just to make automation work.
+
+## Application scripting and APIs
+
+Prefer direct file automation for structured tasks such as assembling slides, filling a document template, or formatting a spreadsheet. These jobs often need no running Office app, macros, or desktop access. Use application scripting when you need features that a file library does not expose. PyAutoGUI is useful for the remaining desktop interaction, not a required step in every automation.
+
+| Mechanism | Good uses | Limits to check first |
+| --- | --- | --- |
+| `python-pptx` | Create or edit `.pptx` slides, text, pictures, tables, and charts without installing PowerPoint. | Does not render slides or export PDF. Not every PowerPoint feature can be created or edited; check template compatibility and the rendered result. |
+| `python-docx` or `openpyxl` | Create or edit `.docx` documents or `.xlsx` workbooks directly. | Feature support and preservation vary. `openpyxl` does not calculate formulas; use a compatible spreadsheet engine when recalculation is required. |
+| Media CLIs, such as FFmpeg | Batch-convert, trim, or combine media without driving an editor. | A media export is not an editable timeline project. Check the requested format, audio, and timing. |
+| AppleScript or JavaScript for Automation through `osascript` | Create documents, address named app objects, export files, coordinate scriptable macOS apps. | macOS only. Each app defines its own scripting dictionary; some apps expose little or no scripting support. |
+| Office Scripts | Repeatable Excel workbook operations through the Automate tab, including supported Power Automate flows. | Excel only. Availability depends on the account, app version, and organization policy; it is not a general desktop-control API. |
+| PowerShell with COM automation | Drive installed Windows applications that expose COM, including desktop Office. | Windows-specific. Do not assume unattended service execution is supported or reuse the user's active app instance without permission. |
+| Application APIs, such as Blender's Python API | Generate geometry, set scene properties, apply repeated edits, and render or export. | Use the API and runtime for the installed app version. Some operations depend on an active document, selection, or editor context. |
+
+Before writing a script, identify the input format, required features, output path, and library or app version. Read the relevant API reference rather than guessing methods. Start with a read-only query or a disposable copy. Save to a new path and reopen the result to check its contents; use a compatible viewer or renderer when appearance matters. Scripts still need the same authorization as UI actions to overwrite, upload, or publish files.
+
+### macOS recipe: create a draft with osascript
+
+Open Script Editor and choose File > Open Dictionary to inspect an application's supported commands, objects, and properties. Apple's [scripting terminology guide](https://developer.apple.com/library/archive/documentation/LanguagesUtilities/Conceptual/MacAutomationScriptingGuide/AboutScriptingTerminology.html) explains how to read the dictionary. App scripting addresses document objects directly; `System Events` UI scripting instead drives accessible interface controls and needs Accessibility permission.
+
+Save this as `create-note.applescript`:
+
+```applescript
+on run argv
+    if (count of argv) is not 1 then error "Pass the draft text as one argument."
+    set draftText to item 1 of argv
+    tell application "TextEdit"
+        set draft to make new document with properties {text:draftText}
+        activate
+        return (text of draft) as text
+    end tell
+end run
+```
+
+Run it from a macOS shell:
+
+```sh
+osascript create-note.applescript "Draft outline for the presentation"
+```
+
+This creates a new, unsaved TextEdit document and returns its text to the shell. It does not overwrite a file. Check the returned text and inspect the document, then save to an agreed destination if required. macOS may ask permission for the launching app to control TextEdit; let the user grant it.
+
+Pass content as arguments rather than interpolating it into executable script text. For longer content, have the script read an explicit input file. JavaScript for Automation is another macOS option, invoked with `osascript -l JavaScript script.js`; it uses Apple's automation objects, not a browser DOM or Node.js APIs. Use whichever language fits the app's documentation and existing scripts.
+
+### PowerPoint recipe: create a draft with python-pptx
+
+Use [python-pptx](https://python-pptx.readthedocs.io/en/latest/user/quickstart.html) to assemble a `.pptx` directly instead of creating slides through desktop clicks or VBA. It runs on macOS, Linux, and Windows without PowerPoint or a graphical session.
+
+Save this as `create_deck.py` in a scratch directory:
+
+```python
+from pathlib import Path
+
+from pptx import Presentation
+
+deck = Presentation()
+title_slide = deck.slides.add_slide(deck.slide_layouts[0])
+title_slide.shapes.title.text = "Quarterly review"
+title_slide.placeholders[1].text = "Draft for discussion"
+
+summary = deck.slides.add_slide(deck.slide_layouts[1])
+summary.shapes.title.text = "Next steps"
+body = summary.placeholders[1].text_frame
+body.text = "Review the results"
+body.add_paragraph().text = "Agree on next quarter's priorities"
+
+output = Path("quarterly-review-draft.pptx")
+with output.open("xb") as stream:
+    deck.save(stream)
+print(f"Created {output.resolve()}")
+```
+
+Run it from that directory with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv run --no-project --with python-pptx python create_deck.py
+```
+
+`--no-project` keeps this one-off task separate from an unrelated Python project. uv may download Python and dependencies on the first run. The script creates two slides and refuses to overwrite an existing output file. Choose a new filename for another draft.
+
+This example uses the layouts and placeholder IDs in the library's default template. For a branded deck, load a copy of your `.pptx` template with `Presentation("template.pptx")` and inspect its layouts and placeholders before adapting the script. Do not assume their indices match the default template. See [working with presentations](https://python-pptx.readthedocs.io/en/latest/user/presentations.html) and [using placeholders](https://python-pptx.readthedocs.io/en/latest/user/placeholders-using.html).
+
+Reopen the saved deck to check slide count and text. Then view it in PowerPoint, LibreOffice Impress, or another compatible renderer to check clipping, fonts, and layout. `python-pptx` does not render slides or export PDF; use a compatible application for those steps. A successful save is not a visual check. If no renderer is available, hand off the draft and state that its appearance remains unchecked.
+
+For similar file-based tasks, use [python-docx](https://python-docx.readthedocs.io/en/latest/) for Word documents or [openpyxl](https://openpyxl.readthedocs.io/en/stable/) for Excel workbooks. Check feature support before editing a complex existing file. Use an app's own API when a library cannot make the required change, rather than forcing a lossy conversion. If an approved task requires macros, inspect the code and follow the organization's macro policy; never weaken security settings to run it.
+
+### Office Scripts, app runtimes, and file tools
+
+For Excel on the web or a supported desktop installation with the Automate tab, consider Office Scripts. Record a small action or create a script there, then use the `ExcelScript` workbook API for repeatable edits. These TypeScript scripts are not VBA and do not run as ordinary Node.js scripts. Check [Office Scripts versus VBA](https://learn.microsoft.com/en-us/office/dev/scripts/resources/vba-differences) for platform, licensing, and API differences. Creating a Power Automate flow can introduce scheduled runs and cloud access; do so only when that automation is part of the request.
+
+Use an application's own scripting runtime when it supplies the API. For example, Blender scripts normally run through Blender's Python Console, Text Editor, or command line. A plain uv Python environment does not automatically have the running application's `bpy` module or scene. With Blender on PATH, an existing `input.blend`, and a reviewed `scene-script.py`, a batch invocation is:
+
+```sh
+blender --background input.blend --python-exit-code 1 --python scene-script.py
+```
+
+Argument order matters. This loads the scene before running the script, and `--python-exit-code 1` makes a script exception produce a nonzero process exit. The script must explicitly save or export any intended output to a new path; exiting successfully does not imply a saved scene. See the [Blender Python quickstart](https://docs.blender.org/api/current/info_quickstart.html) and [command-line reference](https://docs.blender.org/manual/en/latest/advanced/command_line/arguments.html). Use uv for external orchestration or file-processing scripts, and Blender's runtime for Blender operations.
+
+For file-only work, a library can avoid opening the application at all. Know what it preserves: [openpyxl does not calculate Excel formulas](https://openpyxl.readthedocs.io/en/stable/simple_formulae.html), and a deck created with [python-pptx](https://python-pptx.readthedocs.io/en/latest/) still needs a layout check for clipping, fonts, and missing media. For video, FFmpeg can handle batch transforms while an editor's own scripting API can retain timeline structure. Check installed API/version or edition limits before assuming an editor exposes scripting.
+
+Combine these approaches only where they help. Generate content with a script, inspect it in a viewer, and use CUA if it needs visual adjustments or UI-only export controls. You do not need a desktop interaction just to prove that a file script ran. If the task is specifically to verify a menu, dialog, or user flow, exercise that interface too; an API call is not proof that the GUI path works.
+
+## Desktop automation with PyAutoGUI and uv
+
+[PyAutoGUI](https://pyautogui.readthedocs.io/en/latest/) controls the real mouse and keyboard and captures screenshots. It does not understand the application by itself. Atomic must inspect the screen or another reliable state source between actions.
+
+Prefer [uv](https://docs.astral.sh/uv/) to manage Python and the script's dependencies. If `uv --version` fails because uv is missing, install it using the instructions for your OS below. An existing Python environment is a fallback when uv installation is blocked, not a reason to change an unrelated repository's dependencies.
+
+### Run an isolated script
+
+Save the following as `desktop_probe.py` in a scratch directory. It takes a screenshot and reports geometry without clicking or typing:
+
+```python
+from pathlib import Path
+
+import pyautogui as gui
+
+gui.FAILSAFE = True
+gui.PAUSE = 0.25
+
+output = Path("artifacts")
+output.mkdir(exist_ok=True)
+print(f"Screen: {gui.size()}; pointer: {gui.position()}")
+gui.screenshot().save(output / "desktop-before.png")
+```
+
+Run it from that directory:
+
+```sh
+uv run --no-project --with pyautogui --with pillow python desktop_probe.py
+```
+
+`--no-project` avoids discovering or syncing an unrelated Python project. uv can download a Python runtime and dependencies if needed, so this first run may require network access. OS screenshot and accessibility dependencies still need separate setup. For a reusable script, declare dependencies in [inline script metadata](https://docs.astral.sh/uv/guides/scripts/#declaring-script-dependencies), pin versions, and use uv's script locking support. Keep scratch environments and captures out of the application's repository unless they belong in the deliverable.
+
+Open the captured image and confirm it shows the intended desktop. A successful import is not proof that screenshots or input work. Test a harmless action in a disposable document before running a longer sequence.
+
+### Observe, act, and check
+
+- Use short action sequences. Inspect the result after opening a menu, changing focus, or switching applications.
+- Prefer named accessibility controls or application APIs where available. If using coordinates, derive them from the current screen rather than an old screenshot.
+- Keep the target on the primary monitor. PyAutoGUI's multi-monitor support is limited. Retina and DPI scaling can make screenshot pixels differ from input coordinates; compare screenshot dimensions with `gui.size()` before clicking.
+- `gui.write()` sends keystrokes to the focused window and is not a general Unicode text-insertion API. For non-ASCII content, prefer app scripting or a controlled clipboard paste. Clipboard contents may be sensitive, so preserve and restore them when appropriate.
+- For image matching, crop to the relevant region and use fixtures from the same theme and scaling. Handle a missing image as a failed observation, not a reason to click a default location. PyAutoGUI's `confidence` option requires OpenCV in the Python environment.
+- Wait for an observable result with a deadline. A fixed sleep alone does not prove a render, export, or save has finished.
+
+See PyAutoGUI's [keyboard controls](https://pyautogui.readthedocs.io/en/latest/keyboard.html), [mouse controls](https://pyautogui.readthedocs.io/en/latest/mouse.html), and [screenshot functions](https://pyautogui.readthedocs.io/en/latest/screenshot.html) for API details.
+
+### Stop and recover safely
+
+Keep `FAILSAFE` enabled and leave a pause between calls. Moving the pointer to a corner of the primary monitor causes a subsequent PyAutoGUI call to raise `FailSafeException`. Keep a separate way to interrupt the automation process available too.
+
+Prefer complete actions such as `press`, `hotkey`, and `click` over holding input across several steps. If a script must hold a key or mouse button, track what it holds and release it in cleanup. An interrupt or failsafe can itself prevent PyAutoGUI cleanup calls. Stop the script, check for held input, and release it manually or through a safe native mechanism before resuming. Do not disable the failsafe in order to keep clicking.
+
+After a timeout or interruption, inspect the current document and any output files. A save or export may have completed even if its acknowledgement was lost. Do not repeat destructive actions blindly.
+
+## Browser automation with playwright-cli
+
+For tasks that require browser interaction, prefer [playwright-cli](https://github.com/microsoft/playwright-cli) for websites and web apps on all three desktop platforms. Its snapshots expose page structure and element references, so automation can use actual controls rather than screen coordinates. For data retrieval or batch operations, consider a supported API first when it meets the request and you have permission to use it.
+
+### Setup and first session
+
+Load the `playwright-cli` skill and check `playwright-cli --help`. If the command is unavailable, check whether the project's installed Playwright exposes `npx --no-install playwright cli --help`. Otherwise install the CLI when permitted:
+
+```sh
+npm install -g @playwright/cli@latest
+playwright-cli --help
+```
+
+Use the installed CLI's browser setup guidance if a browser is missing. Do not add browser automation dependencies to an unrelated project just to run a one-off task.
+
+Create a uniquely named session, replacing `desktop-demo` if that name is already in use:
+
+```sh
+playwright-cli -s=desktop-demo open https://example.com --headed
+playwright-cli -s=desktop-demo snapshot
+playwright-cli -s=desktop-demo screenshot --filename=browser-before.png
+playwright-cli -s=desktop-demo close
+```
+
+For a real task, act between the snapshot and final capture. Read element references from the current snapshot, then use `click`, `fill`, `select`, or `press`. Do not reuse an example reference such as `e5` without discovering what it points to. Refresh the snapshot after navigation or substantial UI changes.
+
+### Best practices
+
+- Keep the same session name on every command. Close only sessions you created, not every browser on the machine.
+- Prefer a fresh profile. Attach to an existing personal browser only when authorized; stored sessions can expose private tabs and credentials.
+- Use headed mode for visual work. Headless mode can verify DOM behavior, but does not establish that desktop integration or native dialogs work.
+- Inspect visible results and relevant console/network output. Use semantic locators and assertions in a maintained Playwright test for repeatable regression coverage.
+- Use `upload` for supported file inputs rather than driving an OS file picker. Switch to CUA or native tooling only for UI outside the page, and then recheck focus before returning to browser control.
+- Treat cookies, saved authentication state, traces, and network logs as sensitive. Do not commit or attach a browser profile as evidence.
+- Browser mobile emulation tests a web viewport, not a native Android or iOS application.
+
+For verification captures and recordings, see [browser evidence](/workflows/verification#browser-changes).
+
+## Terminal automation with Herdr
+
+Prefer Herdr for interactive terminal work on macOS, Linux, and Windows, subject to the [eligibility requirements](#choose-the-right-tool). Use ordinary shell execution for builds, scripts, or commands that do not need interactive input. A long-running command alone is not a reason to add a multiplexer.
+
+### Setup and a dedicated pane
+
+Check `herdr --version` and `herdr --help`. Install missing Herdr using its [official installation guide](https://github.com/herdrdev/herdr/tree/v0.9.0#install) when permitted. macOS supports `brew install herdr`; macOS/Linux and Windows also have official shell and PowerShell installers. Inspect downloaded scripts before executing them.
+
+Once inside an eligible managed pane, check `herdr status` for client/server compatibility. Do not stop or replace an active server just to obtain a new feature. Atomic's automatic status reporting is documented separately in [Herdr integration](/herdr).
+
+Use the Herdr skill to discover the current pane and create a dedicated sibling without changing the user's focus. For example, in a POSIX shell inside Herdr:
+
+```sh
+herdr pane split --current --direction right --cwd "$PWD" --no-focus
+```
+
+Choose the split direction to suit the available space. Read the new pane ID from the creation response. In the commands below, replace `<pane-id>` with that returned ID and `<command>` with the intended command:
+
+```text
+herdr pane run <pane-id> "<command>"
+herdr pane wait-output <pane-id> --match "<expected output>" --timeout 10000
+herdr pane read <pane-id> --source visible
+```
+
+`pane run` sends text and Enter. `pane send-text` alone does not submit. `wait-output` can match text already on the screen, so use a fresh pane or a run-specific marker and inspect the result. The appearance of a marker is not a substitute for checking the command's exit status or the application's final state.
+
+For ordinary logs, `--source recent-unwrapped --lines 120` avoids soft-wrapped lines. For layout, inspect `visible` at the intended terminal dimensions. Alternate-screen content that has scrolled away may not be recoverable from host scrollback. Capture important states as they occur.
+
+### tmux and psmux fallbacks
+
+When Herdr is unavailable, cannot be installed, or has no eligible managed session, use tmux on macOS/Linux or [psmux](https://github.com/psmux/psmux) for native Windows terminals. Record the reason when it affects the requested coverage. Do not take over an unrelated pane to satisfy the preference.
+
+Load the tmux skill and check the installed help. tmux and psmux share familiar commands, but supported flags and behavior can differ. Herdr has a different CLI entirely.
+
+For tmux, create a dedicated session with a unique name, then discover its actual pane ID:
+
+```sh
+tmux new-session -d -s atomic-demo
+tmux list-panes -t atomic-demo -F '#{pane_id}'
+```
+
+Substitute the returned ID for `<pane-id>`:
+
+```text
+tmux send-keys -t <pane-id> -l -- "<command>"
+tmux send-keys -t <pane-id> Enter
+tmux capture-pane -p -t <pane-id>
+```
+
+Use literal text and a separate Enter to avoid interpreting arbitrary text as key names. On psmux, inspect `psmux list-panes` and use `psmux capture-pane -p -t <pane-id>` as documented in its [scripting guide](https://github.com/psmux/psmux/blob/master/docs/scripting.md). Discover IDs rather than assuming `%0` is your pane. Clean up only the session or pane created for the task. Never use a global server-kill command as routine cleanup.
+
+For modified-key setup in Atomic, see [tmux setup](/tmux). For behavioral checks and recordings, see [terminal evidence](/workflows/verification#terminal-changes).
+
+## macOS
+
+### Desktop and native tools
+
+- Install missing uv with `brew install uv` when Homebrew is available, or use the reviewed macOS installer from [uv installation](https://docs.astral.sh/uv/getting-started/installation/). Confirm `uv --version` in the launching shell.
+- Allow the application launching automation, such as Terminal or your IDE, in System Settings > Privacy & Security > Accessibility. Screenshot capture also needs Screen Recording permission, which may be labelled Screen & System Audio Recording on newer macOS versions. Relaunch the affected app if macOS requests it.
+- AppleScript automation may also prompt for Automation permission to control another app. Let the user grant permissions; do not script around consent dialogs.
+- PyAutoGUI depends on native Python bindings on macOS. If import or capture fails, check the installed release's [installation requirements](https://pyautogui.readthedocs.io/en/latest/install.html) before adding dependencies to the uv environment.
+- Check Retina scaling and keep the target on the primary display. A black or incomplete capture usually needs permission or display troubleshooting, not more clicks.
+
+Use `osascript` for AppleScript or JavaScript for Automation when an app's scripting dictionary exposes the operation you need. See [application scripting and recipes](#application-scripting-and-apis) for a runnable example and Office automation choices. `System Events` UI scripting and native accessibility APIs can address menus and controls more reliably than coordinates; consult Apple's [UI scripting guide](https://developer.apple.com/library/archive/documentation/LanguagesUtilities/Conceptual/MacAutomationScriptingGuide/AutomatetheUserInterface.html).
+
+`screencapture` is useful for native screenshots; Screenshot or QuickTime Player can record the screen or a selected area. Check permissions and the selected recording region before capture.
+
+### Browser and terminal
+
+playwright-cli uses its own browser session. WebKit coverage is not proof of every Safari-specific desktop behavior. Use an actual target browser when that distinction matters.
+
+Herdr is the first choice for interactive terminals when eligible. Homebrew provides Herdr and tmux. Preserve the shell, terminal dimensions, and keyboard behavior relevant to the task rather than silently changing them to make a scenario pass.
+
+## Linux
+
+### Desktop and native tools
+
+- Install missing uv through the [official Linux installer](https://docs.astral.sh/uv/getting-started/installation/) or an available distribution package. Review the installer before executing it, then confirm `uv --version`.
+- PyAutoGUI's Linux input backend uses X11. Run in an accessible graphical X11 session with the correct `DISPLAY` and authorization. Installing Python packages does not create a desktop session.
+- Check the distribution's screenshot and Python support packages. PyAutoGUI documents `scrot` and Python Tk/development packages for Linux; the required capture backend varies with the installed Pillow/PyScreeze versions. Use the distribution package manager with permission, not guessed cross-distribution commands.
+- A Wayland session is not equivalent to X11. XWayland does not grant access to every native Wayland app. Prefer compositor-supported capture/input tools, desktop portals, or native accessibility APIs when they support the operation. Do not weaken session security or claim PyAutoGUI has full Wayland support.
+- For unattended X11 work, a dedicated virtual display such as Xvfb can be useful. It does not prove behavior on a real Wayland desktop, GPU configuration, or physical display. Creative applications may require working graphics acceleration.
+
+[AT-SPI](https://gnome.pages.gitlab.gnome.org/at-spi2-core/) can expose named controls in accessible applications. `xdotool` and `wmctrl` can help with focus and window placement on X11; they are not general Wayland replacements. On Wayland, choose tools for the actual compositor and inspect their permission requirements. Use app APIs where custom canvases do not expose useful accessibility controls.
+
+For recordings, use a supported desktop recorder or OBS with the appropriate display or portal source. Confirm the saved file contains the intended window, not a blank capture.
+
+### Browser and terminal
+
+playwright-cli may need browser binaries and system libraries on a minimal Linux install. A headed browser needs a display. Headless browsing remains useful on SSH or CI hosts but does not grant desktop access.
+
+Herdr is preferred when eligible; tmux is a practical fallback on local or remote POSIX shells. An SSH terminal can run terminal scenarios without access to the remote desktop. Record which host owns the pane and application.
+
+## Windows
+
+### Desktop and native tools
+
+- Install missing uv with `winget install --id=astral-sh.uv -e` or use the reviewed PowerShell installer from [uv installation](https://docs.astral.sh/uv/getting-started/installation/). Open a new shell if PATH changed, then run `uv --version`.
+- Run PyAutoGUI and uv in the Windows graphical session that owns the app. Running them inside WSL does not automatically control native Windows windows.
+- Keep the session unlocked and available during automation. A disconnected or minimized Remote Desktop session can change rendering or input behavior; verify the actual remote-session setup before relying on it.
+- Use a consistent display scale and primary monitor. Check coordinates again after moving a window between displays with different DPI settings.
+- Standard-user automation cannot reliably drive elevated apps or the UAC secure desktop. Stop for the user or choose an authorized non-elevated path rather than escalating just to force input through.
+
+[Windows UI Automation](https://learn.microsoft.com/en-us/dotnet/framework/ui-automation/ui-automation-overview) exposes controls by name and automation ID. Tools such as [pywinauto](https://pywinauto.readthedocs.io/en/latest/) can be easier than pixel matching for accessible Windows apps. For structured document operations, start with [file libraries and app scripting](#application-scripting-and-apis). Use PyAutoGUI for the remaining visual interactions.
+
+Snipping Tool or OBS can capture desktop evidence. Check the selected window and saved recording before sharing it.
+
+### Browser and terminal
+
+Use native Windows playwright-cli when the task depends on Windows browsers, downloads, or desktop dialogs. Quote paths and URLs for the shell actually in use; do not paste POSIX shell syntax into PowerShell.
+
+Prefer native Herdr when eligible. In PowerShell, check `$env:HERDR_ENV -eq '1'`, use `(Get-Location).Path` for the working directory, and read pane IDs from CLI responses. If Herdr cannot be used, install psmux through its documented Windows installation options and inspect its help. WSL tmux is useful for Linux programs, but is not native Windows ConPTY coverage.
+
+See [Windows setup](/windows) for Atomic's shell requirements.
+
+## Creative work and CUA workflows
+
+Choose the deliverable first. A library or application API may produce it without computer use at all. Add visual interaction when it helps create or inspect the result.
+
+| Task | Practical approach | Useful deliverables |
+| --- | --- | --- |
+| Blender 3D modeling | Use Blender Python for repeatable geometry or scene setup; use PyAutoGUI for visible editor operations and visual inspection. | Editable `.blend` file, exported model if requested, preview render. |
+| Presentations | Generate structured slides with `python-pptx`, inspect them in a compatible viewer, and use CUA for visual refinements or slideshow interaction when needed. | Editable deck plus PDF or slide previews exported through a compatible application. |
+| Video editing | Use the editor's scripting API or media CLI for repetitive operations; use CUA to adjust the timeline, inspect transitions, and review playback. | Editable project, required source references, final export. |
+| Work across applications | Use native scripting for named windows and file operations; use PyAutoGUI where the task needs visual interaction. | Saved documents and a concise record of completed steps. |
+
+Do not substitute a screenshot for the editable project or final export the user requested. Reopen saved files, check missing assets and fonts, and inspect the actual export. For video, check audio and timing as well as a still frame. Keep originals intact and use explicit save paths. Rendering, uploading, or exporting through a paid service may need separate authorization.
+
+When the user specifically wants a CUA workflow, include PyAutoGUI in the stage that operates the desktop. For artifact-only requests, keep script-based work outside the desktop session and omit UI stages that add no useful operation or check. A desktop sequence is:
+
+1. Prepare assets and confirm the intended application, output formats, and permissions.
+2. Open the dedicated desktop and inspect its starting state.
+3. Create or edit with PyAutoGUI and suitable native/app APIs, saving checkpoints.
+4. Reopen and inspect the deliverables, then make bounded corrections if needed.
+5. Hand off local files. Publish or upload only to an authorized target.
+
+Pass scripts, project files, and artifact paths between stages rather than long click transcripts. Give one stage exclusive desktop ownership and use finite deadlines for renders and exports. Stop on unexpected dialogs, lost focus, missing permissions, or failed observations. On resume, inspect the app and files before repeating an action.
+
+See [workflow authoring](/workflows/authoring) for stages and human-input gates. Use durable `ctx.tool` calls for workflow-owned external operations, with finite timeouts and cancellation; model stages can use the appropriate automation tools to operate the app. If the user asks to work inline, keep the same safety and deliverable checks without creating a workflow.
+
+## Troubleshooting
+
+| Symptom | What to check |
+| --- | --- |
+| uv or another command is missing | Install it when permitted, refresh PATH, and check its version in the same shell that will launch automation. |
+| Black screenshot or no desktop | Check screen permissions, display/session ownership, X11 versus Wayland, and remote-session state. |
+| Input reaches the wrong app | Stop. Confirm focus, window identity, scaling, and that no other controller shares the desktop. |
+| Browser element reference no longer works | Take a fresh snapshot and locate the current control. |
+| Herdr binary exists but control is unavailable | Check explicit request, managed-pane context, and client/server compatibility. Use a fallback rather than replacing the server. |
+| Save/export timed out | Inspect the file and app state before retrying. Preserve partial output for diagnosis. |
+| Install or graphical access is blocked | Continue work that can be done safely with available APIs or shell tools, and state what remains unverified or unfinished. |
+
+A tool being unavailable is a reason to choose another supported mechanism or report a limitation, not to invent a successful interaction.