Files
marqdo/doc/design/stdlib-subtask.md
T
cflmyandCursor f240bdf156 Stream child agent events into view SSE without jumpy drip.
Forward quiet file-subtask EventBus frames while wait blocks, coalesce
DOM updates per rAF, and keep one SSE write per event so Stream stays
live during child work instead of freezing or dumping bursts.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-11 09:45:08 +08:00

2.0 KiB
Raw Permalink Blame History

子任务标准库(subtask)

状态 v2
库 lib/subtask.mq.md · lib/子任务.mq.md

定位

并发执行单元。spawn 四选一:

参数 执行方式 join / wait 返回值
path= marqdo run <file> --emit-result <tmp> 子进程 map { code, value, stdout?, stderr? }(# main 返回值;quiet 时 piped 捕获 I/O 尾部,不 inherit TTY)
fn= + 可选 args= 当前入口模块中的函数(进程内线程) 函数返回值 Value
code= 外联代码块(Value::Code)子进程 stdout Text
lang= + source= 外联源码子进程 stdout Text

args=:文件子任务为 List(命令行参数);函数子任务为 Map(形参绑定)或 List(按 arg0… 命名)。

quiet= / 静默=(默认 True):仅影响 文件 子任务的 TTY。默认 piped 捕获 stdout/stderr(父终端不被污染,wait map 带截断后的 stdout/stderr 供父智能体观察);False 时继承父进程 stdout/stderr(map 中 I/O 字段为空)。答案载荷仍以 # main 返回值为主(经 --emit-result 旁路)。外联子任务仍经管道收集 stdout 供 join 返回,不受此参数影响。

事件转发(文件子任务):spawn 时设置 MARQDO_EVENT_FORWARD=<临时 ndjson>;子进程内 EventBus.publish 追加写入该文件;父在 wait 阻塞期间 tail 并 republish(加 source=child)。这样子 LLM stream=True 的 token 能进 marqdo view SSE,而不破坏 quiet TTY 契约。函数子任务在同进程内,本来就共享 EventBus。

父进程结束(含 panic)时 KillOnDrop 终止所有文件/外联子进程;函数线程标记为 killed 并 detach(无法强杀 OS 线程)。

poll → { status: running | done | failed, … };函数 done 时含 value,进程/外联 failed 时含 code 或 error。

Host:host_subtask_*(src/host/subtask.rs)。