{"name":"lit-understanding","description":"Paper Finder, a literature understanding agent: it finds papers in the scientific literature, answers questions about them and writes reports that cite them. Push notifications require A2A 1.0 (send `A2A-Version: 1.0`); A2A 0.3 clients can stream or poll.","supportedInterfaces":[{"url":"https://mabool-demo.apps.allenai.org/api/4/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"},{"url":"https://mabool-demo.apps.allenai.org/api/3/a2a","protocolBinding":"JSONRPC","protocolVersion":"0.3"}],"version":"1.0.0","capabilities":{"streaming":true,"pushNotifications":true,"extensions":[{"uri":"https://allenai.org/asta/caller-context/v1","description":"Caller surface, originating message, eval run, and the caller's pubsub when not Paper Finder's own. actorId is the user the caller acts for.","required":false},{"uri":"https://allenai.org/asta/step-progress/v1","description":"Where step progress goes (stepsVia: a2a or nora), the caller step it nests under, and whether steps come flat (stepsShape: flat, opens and failures) or as a tree (tree, every step opens and closes).","params":{"runStates":["running","succeeded","failed"],"stepsVia":["a2a","nora"],"stepsShape":["flat","tree"]},"required":false},{"uri":"https://allenai.org/asta/usage/v1","description":"The cost trace to report cost against.","params":{"currency":"USD"},"required":false},{"uri":"https://allenai.org/asta/schemas/v1","params":{"lit-understanding":{"$ref":"https://mabool-demo.apps.allenai.org/api/4/a2a/skills/lit-understanding/input-schema.json"}},"required":false}]},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"lit-understanding","name":"Literature Understanding","description":"Literature understanding over Semantic Scholar, as a conversation: finds and ranks papers, answers questions about them and writes reports that cite them. Send a natural-language request; receive step updates via SSE, the answer as text and the turn's results as structured artifacts (a search result or a report on A2A 1.0, a paper-finder-search-result on 0.3).","tags":["literature","papers","search","question-answering","reports"],"examples":["{\"$defs\": {\"Include\": {\"enum\": [\"details\", \"relevance\", \"evidence\", \"internals\", \"internals.analyzedQuery\", \"internals.metrics\", \"internals.usage\", \"internals.scores\", \"internals.origins\", \"internals.viewedContent\"], \"type\": \"string\"}, \"Preset\": {\"enum\": [\"minimal\", \"full\", \"none\"], \"type\": \"string\"}, \"ResultSelection\": {\"description\": \"The caller's choice, as sent: the A2A skill input's `result`, or REST query parameters.\", \"properties\": {\"preset\": {\"$ref\": \"#/$defs/Preset\", \"default\": \"minimal\"}, \"include\": {\"default\": [], \"items\": {\"$ref\": \"#/$defs/Include\"}, \"title\": \"Include\", \"type\": \"array\", \"uniqueItems\": true}}, \"title\": \"ResultSelection\", \"type\": \"object\"}, \"SearchOperationMode\": {\"enum\": [\"infer\", \"fast\", \"diligent\"], \"type\": \"string\"}, \"WorkerProfile\": {\"enum\": [\"deep\", \"standard\"], \"type\": \"string\"}}, \"additionalProperties\": false, \"properties\": {\"query\": {\"description\": \"Literature understanding query in natural language\", \"minLength\": 1, \"title\": \"Query\", \"type\": \"string\"}, \"operation_mode\": {\"$ref\": \"#/$defs/SearchOperationMode\", \"default\": \"infer\", \"description\": \"Controls breadth/recall vs latency for broad searches. 'fast' runs a single-pass broad search; 'diligent' runs the full multi-iteration broad search for higher recall at higher latency; 'infer' lets the agent pick based on the query.\"}, \"worker_profile\": {\"$ref\": \"#/$defs/WorkerProfile\", \"default\": \"deep\", \"description\": \"'deep' orchestrates the full agent; 'standard' runs a quick best-effort search.\"}, \"result\": {\"$ref\": \"#/$defs/ResultSelection\", \"description\": \"How much of each paper to return (on the /api/4/a2a endpoint). Every paper has its corpus id; `preset` is the base set of layers (minimal: details + relevance; full: + evidence; none: ids only), and `include` adds to it: paper layers, and the internals (all of them, or one part; `internals.analyzedQuery` adds each search result's analyzed query to that artifact).\"}}, \"required\": [\"query\"], \"title\": \"LitUnderstandingSkillInput\", \"type\": \"object\"}"],"outputModes":["application/vnd.ai2.lit-understanding.search-result.v4+json","application/vnd.ai2.lit-understanding.report.v4+json","application/vnd.asta.paper-finder-search-result+json"]}],"preferredTransport":"JSONRPC","protocolVersion":"0.3","url":"https://mabool-demo.apps.allenai.org/api/3/a2a"}