output-cards

name	Output Cards
description	JSON schema reference for 6 structured output card types used by the Research-Claw dashboard: paper_card, task_card, progress_card, approval_card, file_card, monitor_digest. Read this before outputting any structured card for the first time in a session.

Output Cards

Use fenced code blocks with the card type as the language tag. Content MUST be valid JSON — the dashboard parser uses JSON.parse().

paper_card

ONLY for real academic publications — from API queries, library_search, or user-identified papers. NEVER for concepts, tools, or non-scholarly content.

Required: type, title, authors (string[]). Optional: venue, year, doi, url, arxiv_id, abstract_preview, read_status ("unread"|"reading"|"read"|"reviewed"), library_id, tags.

task_card

Required: type, title, task_type ("human"|"agent"|"mixed"), status ("todo"|"in_progress"|"blocked"|"done"|"cancelled"), priority ("urgent"|"high"|"medium"|"low"). Optional: id, description, deadline (ISO 8601), related_paper_title, related_file_path.

progress_card

Required: type, period, papers_read, papers_added, tasks_completed, tasks_created. Optional: writing_words, reading_minutes, highlights (max 5).

approval_card

Required: type, action (string), context (string), risk_level ("low"|"medium"|"high"). Required (for exec approvals): approval_id from exec.approval.requested — without it, dashboard buttons are non-functional. Optional: details (must be a JSON object, not a string — e.g. {"paper_count": 7}).

file_card

CRITICAL: ONLY copy the file_card from workspace_save or workspace_export tool output verbatim. NEVER fabricate — causes "file not found" errors.

monitor_digest

Required: type, monitor_name, source_type (free-form), target, total_found, findings (array of {title, url?, summary?}, max 10). Optional: schedule.