Skip to content
Developer Preview

task/background

Durably sends a running foreground tool task to the background; the TaskBackgrounded record lands before the ack and the toolCall item’s item/updated folds the flip.

Type: TaskBackgroundParams

task/background params: durably send a running foreground tool task to the background.

Field Type Stability Presence Description
commandId string required The idempotency handle (UUIDv7).
sessionId string required The target session.
taskId string required The task to background, exactly as the view names it: the toolCall item’s itemId IS the task id.
Source

schema/msp/experimental/msp.schema.json#/methods/task~2Fbackground

{
"description": "Durably sends a running foreground tool task to the background; the `TaskBackgrounded` record lands before the ack and the `toolCall` item's `item/updated` folds the flip.",
"params": {
"$ref": "#/$defs/TaskBackgroundParams"
},
"result": {
"$ref": "#/$defs/TaskCommandResult"
}
}