All tools
ToolWrite
Ingest research update
ingest_research_updateTurn new source material into evidence-backed research observations and reviewable Project updates.
When to use it
You need matching folders, sources, notes, recent changes, or library metadata.
Typical workflow
Find candidate library objects before reading full evidence.
What it returns
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
You need exact quoted evidence from a long source; use chunk tools instead.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
},
"folderId": {
"type": "string",
"format": "uuid"
},
"project": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"source": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"userContext": {
"type": "string"
},
"sharedText": {
"type": "string"
},
"sharedTitle": {
"type": "string"
}
},
"required": [
"url"
]
},
"template": {
"type": "string"
},
"actions": {
"type": "object"
},
"observations": {
"type": "array",
"items": {
"type": "object"
}
},
"claimDeltas": {
"type": "array",
"items": {
"type": "object"
}
},
"watchlistUpdates": {
"type": "array",
"items": {
"type": "object"
}
},
"companyId": {
"type": "string",
"format": "uuid"
},
"claimPolicy": {
"type": "string",
"const": "propose_only"
},
"idempotencyKey": {
"type": "string"
},
"operationId": {
"type": "string",
"format": "uuid"
},
"commitToken": {
"type": "string"
}
},
"additionalProperties": true
}