Create research task
create_research_taskStart durable multi-session research work: record the goal, an ordered plan, and a budget so you can leave and resume later with your cursor and findings intact.
When to use it
Start durable multi-session research work: record the goal, an ordered plan, and a budget so you can leave and resume later with your cursor and findings intact.
List existing Threads first, inspect the case file, then add exact evidence, propose a revision, or start one bounded run and poll it to a terminal state.
The task with plan summary, cursor, findings, budget, and version for optimistic checkpoints.
Avoid using it when
Do not use for a question you will answer in this session, or as a substitute for Research Deltas; conclusions still land as review-only proposals.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Create a durable research task for multi-session agent work in one authorized Project: a goal, an ordered plan, a resumable cursor, evidence-linked findings, and a budget. Tasks are a scratchpad you can leave and resume; conclusions still land as review-only Research Deltas or Thread proposals. Use when: Start durable multi-session research work: record the goal, an ordered plan, and a budget so you can leave and resume later with your cursor and findings intact. Avoid when: Do not use for a question you will answer in this session, or as a substitute for Research Deltas; conclusions still land as review-only proposals.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"goal": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"plan": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"enum": [
"pending",
"running",
"complete",
"failed",
"skipped"
],
"default": "pending"
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
},
"cursor": {
"type": "object",
"additionalProperties": true
},
"budget": {
"type": "object",
"properties": {
"maxToolCalls": {
"type": "integer",
"minimum": 1,
"maximum": 5000
},
"maxCheckpoints": {
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"maxFindings": {
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"additionalProperties": false
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"folderId",
"title",
"goal",
"idempotencyKey"
],
"additionalProperties": false
}