All tools
ToolWrite
Import social source
import_social_sourceYou need matching folders, sources, notes, recent changes, or library metadata.
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 full registry notes
Preview a structured social capture with account, timestamp, media, canonical URL, and clean research representation. 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.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"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)$"
},
"project": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"name"
]
},
"source": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"userContext": {
"type": "string",
"maxLength": 10000
},
"sharedText": {
"type": "string",
"maxLength": 50000
},
"sharedTitle": {
"type": "string",
"maxLength": 500
}
},
"required": [
"url"
]
},
"template": {
"default": "research_update",
"type": "string",
"maxLength": 120
},
"importProfileId": {
"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)$"
},
"actions": {
"default": {
"saveRawSource": true,
"createCleanSource": true,
"extractObservations": true,
"proposeClaimDeltas": true,
"updateWatchlist": true,
"createAnalysisNote": true,
"linkEvidenceGraph": true,
"identifyAffectedModels": true,
"identifyAffectedArticles": true
},
"type": "object",
"properties": {
"saveRawSource": {
"default": true,
"type": "boolean"
},
"createCleanSource": {
"default": true,
"type": "boolean"
},
"extractObservations": {
"default": true,
"type": "boolean"
},
"proposeClaimDeltas": {
"default": true,
"type": "boolean"
},
"updateWatchlist": {
"default": true,
"type": "boolean"
},
"createAnalysisNote": {
"default": true,
"type": "boolean"
},
"linkEvidenceGraph": {
"default": true,
"type": "boolean"
},
"identifyAffectedModels": {
"default": true,
"type": "boolean"
},
"identifyAffectedArticles": {
"default": true,
"type": "boolean"
}
}
},
"observations": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"observation": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"interpretation": {
"type": "string",
"maxLength": 5000
},
"classification": {
"type": "string",
"enum": [
"F",
"M",
"E",
"J"
]
},
"sourceTier": {
"default": "unknown",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"effectiveAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"entities": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"topics": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"supports": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"contradicts": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"doesNotProve": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"thesisImpact": {
"default": {
"direction": "neutral",
"magnitude": "none"
},
"type": "object",
"properties": {
"direction": {
"default": "neutral",
"type": "string",
"enum": [
"positive",
"negative",
"mixed",
"neutral"
]
},
"magnitude": {
"default": "none",
"type": "string",
"enum": [
"none",
"small",
"medium",
"large"
]
}
}
},
"sourceChunkId": {
"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)$"
},
"idempotencyKey": {
"type": "string",
"maxLength": 500
}
},
"required": [
"observation",
"classification"
]
}
},
"claimDeltas": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"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": {
"default": [],
"maxItems": 100,
"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)$"
}
},
"confirms": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"contradicts": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"newRisks": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"followUps": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
}
},
"required": [
"category",
"summary"
]
}
},
"watchlistUpdates": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"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)$"
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"status": {
"type": "string",
"enum": [
"not_started",
"tracking",
"in_progress",
"blocked",
"triggered",
"completed",
"cancelled"
]
}
},
"required": [
"itemId",
"message"
]
}
},
"analysisNote": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 100000
}
},
"required": [
"title",
"body"
]
},
"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)$"
},
"claimPolicy": {
"default": "propose_only",
"type": "string",
"const": "propose_only"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"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": {
"folderId": {
"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)$"
},
"project": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"name"
]
},
"source": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"userContext": {
"type": "string",
"maxLength": 10000
},
"sharedText": {
"type": "string",
"maxLength": 50000
},
"sharedTitle": {
"type": "string",
"maxLength": 500
}
},
"required": [
"url"
]
},
"template": {
"default": "research_update",
"type": "string",
"maxLength": 120
},
"importProfileId": {
"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)$"
},
"actions": {
"default": {
"saveRawSource": true,
"createCleanSource": true,
"extractObservations": true,
"proposeClaimDeltas": true,
"updateWatchlist": true,
"createAnalysisNote": true,
"linkEvidenceGraph": true,
"identifyAffectedModels": true,
"identifyAffectedArticles": true
},
"type": "object",
"properties": {
"saveRawSource": {
"default": true,
"type": "boolean"
},
"createCleanSource": {
"default": true,
"type": "boolean"
},
"extractObservations": {
"default": true,
"type": "boolean"
},
"proposeClaimDeltas": {
"default": true,
"type": "boolean"
},
"updateWatchlist": {
"default": true,
"type": "boolean"
},
"createAnalysisNote": {
"default": true,
"type": "boolean"
},
"linkEvidenceGraph": {
"default": true,
"type": "boolean"
},
"identifyAffectedModels": {
"default": true,
"type": "boolean"
},
"identifyAffectedArticles": {
"default": true,
"type": "boolean"
}
}
},
"observations": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"observation": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"interpretation": {
"type": "string",
"maxLength": 5000
},
"classification": {
"type": "string",
"enum": [
"F",
"M",
"E",
"J"
]
},
"sourceTier": {
"default": "unknown",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"effectiveAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"entities": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"topics": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"supports": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"contradicts": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"doesNotProve": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"thesisImpact": {
"default": {
"direction": "neutral",
"magnitude": "none"
},
"type": "object",
"properties": {
"direction": {
"default": "neutral",
"type": "string",
"enum": [
"positive",
"negative",
"mixed",
"neutral"
]
},
"magnitude": {
"default": "none",
"type": "string",
"enum": [
"none",
"small",
"medium",
"large"
]
}
}
},
"sourceChunkId": {
"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)$"
},
"idempotencyKey": {
"type": "string",
"maxLength": 500
}
},
"required": [
"observation",
"classification"
]
}
},
"claimDeltas": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"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": {
"default": [],
"maxItems": 100,
"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)$"
}
},
"confirms": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"contradicts": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"newRisks": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"followUps": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
}
},
"required": [
"category",
"summary"
]
}
},
"watchlistUpdates": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"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)$"
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"status": {
"type": "string",
"enum": [
"not_started",
"tracking",
"in_progress",
"blocked",
"triggered",
"completed",
"cancelled"
]
}
},
"required": [
"itemId",
"message"
]
}
},
"analysisNote": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 100000
}
},
"required": [
"title",
"body"
]
},
"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)$"
},
"claimPolicy": {
"default": "propose_only",
"type": "string",
"const": "propose_only"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"mode": {
"type": "string",
"const": "preview"
}
},
"required": [
"source",
"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
}
]
}