Auto-Write Research Reports

What it is

Auto-Write Research Report turns a Research Cafe into a full prose research report with inline citations and a formatted bibliography. Pick a topic and the AI researches it for you across the same providers you use in the Cafe (Web, Academic, etc.), ranks the strongest sources, and writes a report grounded in them. Or work the other way around: curate sources into your Serving Tray first, then let Auto-Write synthesise a report strictly from what you chose. Each report is saved as a first-class artefact inside the Cafe — open it back up any time, expand it inline to read it, edit its bibliography, export it, share it with another signed-in user, or feed it back into the Tray as input for a follow-up report.

Auto-Write reports live in the Generated Reports section of the Cafe's left column — purple-tinted cards that persist after generation so you can re-open them at any time. Each report is also URL-addressable at /cafe/[cafeId]/artefact/[artefactId] for bookmarking.

Scope — what it covers and what it doesn't

• In scope: topic-driven research from a one-line prompt; tray-only synthesis with no new searches; 8 citation styles; per-export style override; manual bibliography editing; BibTeX / RIS / PDF / Markdown export; re-using a report as a Tray item; per-report sharing via a share link; inline expansion in the Cafe column; citation display gated by scribe type; highlight-to-tray from expanded report text.
• Out of scope: A whole-report PDF export (the source-card PDF export exists; report-body PDF doesn't yet). Per-Report citation-style picker inside the editor — style change happens on the Export Modal. Truly-public sharing (recipients must be signed-in Coffeescribe users). Auto Research ↔ Auto-Write unification (W1.4).

Getting started — four modes

Open a Research Cafe and click the Auto-Write button (✨ icon, in the Cafe toolbar next to Auto). A dialog opens with tabs for each input mode:

Topic mode

1. Type the topic you want researched — be as specific as you can ("Effects of intermittent fasting on cardiovascular markers in adults over 60", not just "fasting").
2. Pick a depth: Quick (3-5 sources), Standard (6-10), or Deep (10-20). Depth controls how many sources Auto-Write gathers and synthesises.
3. The estimated token cost appears under the depth picker — recalculates live as you change settings.
4. (Pro / Creator only) Expand Advanced to override the default model. Free users always run on the platform-default model.
5. Click Generate Report.

Topic mode fans out across the same providers your Cafe has enabled (Web Search + Academic + any Apify Actors you've consented to), enriches each candidate, ranks them by source quality score, and writes a report from the strongest. The new sources are saved to the Cafe alongside the report so you can verify them individually.

From Sources mode

1. Open Auto-Write and switch to the From Sources tab.
2. The dialog shows all sources currently in your Cafe's Sources column and a token-cost estimate.
3. Submit. Auto-Write synthesises a report directly from all the sources in your Cafe — no Tray curation needed. Source-linked items are cited; the agent selects the most relevant passages.

Use From Sources when you have gathered research in your Cafe but haven't curated a Tray yet and want a report immediately. Combining this with the Sources column's "Credible only" filter is a fast way to get a report from only your trustworthy sources.

Tray + Sources mode

1. Curate the sources you most want featured into your Serving Tray.
2. Open Auto-Write and switch to the Tray + Sources tab.
3. The dialog synthesises from both your Tray items (highest priority — weighted by the agent) and the rest of your Sources column (secondary fill). A count and cost estimate are shown before you start.

Use Tray + Sources when you have a curated shortlist of important sources in the Tray but also want the report to draw on the broader research in the Cafe. The Tray items are featured prominently; the Sources column fills in context.

From Tray mode

1. Curate the sources you want included into your Serving Tray first. Both source-linked items (snippets with a citation) and plain notes (observations you wrote yourself) are included.
2. Open Auto-Write and switch to the From Tray tab.
3. The dialog shows the source count, note count, and a token-cost estimate based strictly on the Tray's contents. Source-linked items are cited with [N] markers; plain notes are woven into the prose as observations without citation markers.
4. Submit. No new research is done — Auto-Write synthesises only the Tray items you chose. This is the right mode when you've already vetted your sources or you need to constrain the report to a specific set.

Which mode should I use?

Reports persist in the Cafe column

After a report is generated, the Auto-Write dialog closes and a purple "Research Report" card appears in the Generated Reports section of the Cafe's left column. The card shows the report title, date, citation style badge, and model used.

Expanding a report inline

Click the chevron on a report card to expand it without leaving the Cafe. The expanded view shows:

• The full report body with inline citation markers
• The formatted bibliography

On first expand, the card fetches the full report body (a small network request). Collapsing and re-expanding does not re-fetch — the content is cached in the card.

Highlight to Tray from a report

While a report is expanded, you can drag-select any text in the report body. The same floating "Add to Tray" toolbar that works on normal source cards appears. Selected text is added to the Serving Tray as a note (not linked to a source citation — it's synthesised text). This is useful for pulling a particularly well-written passage forward into a follow-up report.

Opening the full-screen view

Click View Report on any report card to open the full URL-addressable report page at /cafe/[cafeId]/artefact/[artefactId]. From there you can edit the bibliography, share the report, or export it.

Citation display by scribe type

Each report is generated with a scribe type — the mode of writing. The citation display defaults differ by type:

A Show / Hide citations toggle appears on every report so you can override the default at any time. When citations are hidden, inline [N] markers and the bibliography section are both concealed — the prose reads cleanly. Toggle them back on to verify sources. The toggle is available in both the inline-expanded card view and the full-screen report page.

APA 7 in-text format

Reports generated with APA 7 citation style now render proper author-date in-text citations — (Smith, 2022) rather than [1]. Multi-author rules: one author → (Family, Year), two → (Family1 & Family2, Year), three or more → (Family1 et al., Year). Web sources without structured metadata fall back to a numbered [N] + URL reference in the bibliography.

Sharing a report

Every Auto-Write report can be shared with other signed-in Coffeescribe users via a share link.

How to share

1. Open a report card in the Cafe column and click Share (appears in the expanded card, next to "View Report").
2. Alternatively, open the full-screen report page and click Share in the toolbar.
3. A dialog opens. Toggle Enable sharing on.
4. A share URL appears — click Copy to copy it.
5. Send the link to anyone with a Coffeescribe account.

What recipients can do

Recipients who open the share link:

• Read the full report body, citations, and bibliography
• Cannot edit, delete, or modify anything — the report is read-only
• Must be signed in to Coffeescribe — the link does not work for anonymous visitors

Revoking sharing

Toggle sharing off in the Share dialog. The link immediately stops working.

Important: The shared link does not carry any special permissions for the parent Cafe — recipients can only read the report, not access other sources in your Cafe unless you have separately shared the Cafe itself.

Sparse-source warning

If a topic-mode run finishes with fewer than three usable sources, Auto-Write surfaces a sparse-source warning on the report. It's a heads-up that the topic was too narrow, too niche, or too recent for the providers you have enabled — the report may lack depth. Either add more provider coverage (e.g. enable an Apify Actor) or broaden the topic and re-run.

Editing the bibliography

Every report has an Edit Bibliography button. Click it to open the Bibliography Editor at /cafe/[cafeId]/artefact/[artefactId]/bibliography:

• One card per citation. Each card shows a live preview of the rendered citation in the report's chosen style, plus an edit form for authors, title, journal, year, etc. Live preview updates on blur (debounced, not on every keystroke).
• Add Citation opens a manual entry form. Manual citations create a cafe_sources row of type manual_entry so the bibliography can include sources that didn't come from the search providers.
• Replace with new source re-opens the identifier-paste flow (DOI / ISBN / PMID / arXiv / ISSN / URL) so you can swap one citation for a freshly enriched source.
• Delete removes a citation from this report only — the underlying source stays in the Cafe.
• Export opens the Export Modal.

The Bibliography Editor is per-Report, not per-Cafe. Different reports in the same Cafe can have different bibliographies.

Export formats

The Export Modal supports four formats and lets you override the citation style per export — defaults to the report's style, but you can pick any of the 8 styles even if the report was written in a different one.

The 8 citation styles

W1.2 adds three styles to the five W1.1 shipped, bringing the total to 8:

Set the style at the Cafe level via Cafe Settings (gear icon); override per-export on the Export Modal.

Detecting conflicts between sources

W1.2 also adds a Detect Conflicts button (⚡ icon) next to Auto-Write in the Cafe toolbar. It runs an LLM in the background that compares pairs of sources from your Cafe and flags any factual disagreements ("Source A says X; Source B says not-X"). Results land as a Conflict Report artefact in the amber Conflict Reports section of the Cafe's left column.

Scope

• Conflict Detect scans all sources currently in the Cafe — not just Tray items, not a specific report's sources.
• It is LLM-semantic, not keyword matching. The model reads both sources and decides whether they disagree on a checkable claim.
• It is pairwise — the cost scales O(n²) with source count, mitigated by a pre-filter that skips obviously unrelated pairs.
• Runs are rate-limited softly to one per 5 minutes per Cafe and hard-capped at $0.50 per run to prevent runaway cost on large Cafes.
• Runs in the background — you can keep using the Cafe while it works. You get an in-app toast when it completes with a link to the Conflict Report.

Using it

1. Click Detect Conflicts (⚡).
2. (Pro / Creator) Optionally expand Advanced to override the default model.
3. Click Run Detection. The button shows a spinner; a toast confirms the job started.
4. When the run completes (typically 10-60 seconds depending on source count), a second toast appears with a link to the Conflict Report.
5. The Conflict Report lists each detected disagreement with the two citations involved, so you can decide which (if any) to trust.

Conflict reports can be added to the Tray via a per-card button — same affordance as Auto-Write Reports — so you can fold "this is the disagreement" into a follow-up synthesis.

Token costs

Both Auto-Write and Detect Conflicts charge token costs that depend on source count and model. The exact cost is shown before you confirm:

Soft rate-limit on Detect Conflicts is 5 minutes between runs per Cafe.

Re-using reports as Tray items

Each Auto-Write Report has a small Tray button (Inbox icon) next to its title in the left-column list. Clicking it pulls the first ~500 chars of the report into the Serving Tray as a synthesis snippet, so you can:

• Feed it into another Auto-Write run as a Tray source
• Carry it through to your Scribe via the Workspace's Cafe Trays tab (in W1.3, also via Draft Scribe from Cafe)
• Reference it via @-mentions when writing in the Workspace

Conflict Reports support the same affordance from the amber section.

Adding a source by identifier (collapsible)

The existing identifier-paste input (DOI / ISBN / PMID / arXiv / ISSN / URL) is now wrapped in a collapsible Add Source by Identifier section in the Cafe header. It's collapsed by default; click to expand. Your expanded/collapsed preference is remembered per Cafe in localStorage, so the Cafes where you regularly paste identifiers stay open and the others stay tidy.

Empty-content source flow (Tray Confirm dialog)

When you click the Tray button on a source card whose body content is empty (e.g. an OpenAlex paper with no abstract), a confirmation dialog now opens with three options:

• Scrape full article — fires off an Apify URL scrape for the source's URL, populates the content, and adds it to the Tray. Costs a small URL-scrape fee.
• Add anyway — adds the source to the Tray as-is (just the metadata). Free.
• Cancel — closes the dialog.

This replaces the silent failure path where empty sources used to land in the Tray with nothing useful in them.

Tier availability

Auto-Write and Detect Conflicts both run on your token balance regardless of tier. If a run would push you over your balance, the pre-flight cost estimate warns you before submission.

Tips

• Curate before synthesising for the highest-quality reports. Use Topic mode to discover, then move the best results into the Tray, then use From Tray mode to re-write strictly from those vetted sources. Two-pass workflow.
• Mix sourced items and plain notes in the Tray — source-linked snippets get cited with [N] markers; your own observations (notes without a source) are woven in as observations. Both end up in the report, but only source-linked items appear in the bibliography.
• Set your citation style once per Cafe before running Auto-Write — the report bakes in the Cafe's style at generation time. You can still override per-export later.
• Use Detect Conflicts before publishing a literature review. Even if it finds no conflicts, that's useful context. If it finds one, you know to address it in your writing.
• Pin reports to the Tray to chain them — a report can become an input for the next report. Multi-step synthesis without re-typing.
• Expand the report inline first before opening the full-screen view — it loads faster and you can highlight passages directly to the Tray without leaving the Cafe.
• Use the citation toggle to read the prose cleanly (citations hidden) and then enable them just for verification — especially useful for Summary and Explainer types where citations are off by default.
• Share a report with a collaborator using the Share button in the expanded card or the full-screen view. They need a Coffeescribe account to open it. Toggle sharing off at any time to revoke access.
• Paste a DOI to get the full article body — the identifier enrichment now automatically attempts to scrape readable content after metadata lookup. Paywalled publishers may only return the abstract, but open-access articles often include the full text.
• Sparse-source warnings are honest signals. When Auto-Write tells you a topic returned only two sources, that usually means the topic is genuinely under-researched or your providers don't cover the right corner — broaden or enable Apify Actors.
• BibTeX/RIS round-trips cleanly to Zotero, Mendeley, and EndNote. Try it once with a small report before committing to a workflow.