Search library
search_libraryFind relevant Project sources and citation-ready chunks so an answer can start from owned evidence.
When to use it
Default library search entrypoint. Use mode chunks for evidence, titles for ids and metadata, or semantic for bounded content snippets.
Search chunks, read only the precise chunk or bounded text needed, cite ids.
Source text, chunks, snippets, ids, and citation-ready context.
Avoid using it when
You only need source names or folders; start with metadata lists.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Canonical Prism library search and the single entry point for finding sources. Modes: chunks (authorized hybrid semantic + lexical evidence retrieval with relevance thresholds), titles (tokenized source/document name lookup), text (tokenized keyword lookup over titles and content). 'semantic' is a deprecated alias for text. Replaces search_research_library, search_library_chunks, and semantic_search_library. Use when: Default library search entrypoint. Use mode chunks for evidence, titles for ids and metadata, or semantic for bounded content snippets.
View JSON Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"titles",
"chunks",
"text",
"semantic"
],
"default": "chunks",
"description": "chunks = hybrid semantic + lexical evidence; titles = tokenized name/metadata; text = tokenized keyword lookup (semantic is a deprecated alias for text)."
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
},
"folderId": {
"type": "string",
"format": "uuid"
},
"fileIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"maxItems": 50
},
"sourceKind": {
"type": "string",
"enum": [
"document",
"web_page",
"article",
"social_post",
"note",
"email",
"transcript",
"presentation",
"dataset",
"image",
"audio",
"video",
"book_or_paper",
"other",
"news_article",
"video_transcript",
"research_report",
"company_press_release",
"quarterly_filing",
"annual_filing",
"sec_filing",
"earnings_call",
"investor_presentation"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 12
},
"asOf": {
"type": "string",
"format": "date-time",
"description": "Point-in-time retrieval: only sources added to Prism on or before this moment are searched. Use it to re-run a question with the evidence that existed when a decision or Thread confidence was recorded."
}
},
"required": [
"query"
],
"additionalProperties": false
}