All tools
ToolWrite
Propose Research Delta
propose_research_deltaPrepare a source-backed change proposal for a company thesis, claim, catalyst, risk, or research agenda.
When to use it
The task is centered on a saved ticker, thesis, claim, or research review.
Typical workflow
Use company context first, then thesis, claims, reviews, and evidence gaps.
What it returns
Company thesis context, claims, reviews, and evidence health signals.
Avoid using it when
The ticker is not saved in Prism or the task only needs generic market data.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Create a human-reviewable Research Delta proposal. Preview this operation with mode=preview and a stable idempotencyKey. After approval, commit with mode=commit, operationId and commitToken only; saved preview fields cannot be replaced. Human review: Never applies the canonical thesis..
View JSON Schema
{
"type": "object",
"properties": {
"companyId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceFileId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceTitle": {
"type": "string"
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"category": {
"type": "string",
"enum": [
"confirmed",
"strengthened",
"weakened",
"contradicted",
"superseded",
"newly_introduced",
"still_unresolved",
"changed_timing_only",
"changed_magnitude_only",
"no_material_thesis_impact"
]
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"affectedClaimIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"proposedClaims": {
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"label": {
"type": "string",
"enum": [
"CONFIRMED",
"INFERRED",
"UNVERIFIED"
]
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"sourceUrl": {
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"add",
"update",
"retire"
]
},
"targetClaimId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"text",
"label",
"section",
"action"
]
}
},
"confirms": {
"type": "array",
"items": {
"type": "string"
}
},
"contradicts": {
"type": "array",
"items": {
"type": "string"
}
},
"newRisks": {
"type": "array",
"items": {
"type": "string"
}
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
]
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"mode"
],
"additionalProperties": false,
"anyOf": [
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"companyId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceFileId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceTitle": {
"type": "string"
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"category": {
"type": "string",
"enum": [
"confirmed",
"strengthened",
"weakened",
"contradicted",
"superseded",
"newly_introduced",
"still_unresolved",
"changed_timing_only",
"changed_magnitude_only",
"no_material_thesis_impact"
]
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"affectedClaimIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"proposedClaims": {
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"label": {
"type": "string",
"enum": [
"CONFIRMED",
"INFERRED",
"UNVERIFIED"
]
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"sourceUrl": {
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"add",
"update",
"retire"
]
},
"targetClaimId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"text",
"label",
"section",
"action"
]
}
},
"confirms": {
"type": "array",
"items": {
"type": "string"
}
},
"contradicts": {
"type": "array",
"items": {
"type": "string"
}
},
"newRisks": {
"type": "array",
"items": {
"type": "string"
}
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"mode": {
"type": "string",
"const": "preview"
}
},
"required": [
"companyId",
"sourceFileId",
"category",
"summary",
"idempotencyKey",
"mode"
],
"additionalProperties": false
},
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "commit"
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"mode",
"operationId",
"commitToken"
],
"additionalProperties": false
}
]
}