Run and manage background indexing-related tasks with a durable state machine, concurrency control, progress events, and retry policies. Use when implementing reliable local-first document import/index/update/export pipelines.
{
"requestId": "string",
"task": {
"type": "ingest|index|export|reindex",
"taskId": "string",
"params": { "any": "task-specific payload" }
},
"runner": {
"concurrency": 2,
"timeoutMs": 900000,
"retry": { "maxAttempts": 3, "backoffMs": 1000 }
}
}
{
"ok": true,
"code": "SUCCESS|null",
"data": {
"taskId": "string",
"status": "QUEUED|RUNNING|SUCCEEDED|FAILED|CANCELLED",
"progress": { "current": 0, "total": 0, "message": "string" }
}
}
taskId 唯一）。QUEUED -> RUNNING -> SUCCEEDED/FAILED/CANCELLEDingest/index/export 的具体业务由对应 skills/module 完成（例如 ingestion indexer）。retryable=true 的失败重试retryable=true，建议暂停 runner 或提示重试。FAILED_TIMEOUT 并允许重试。