fergana-labs/stash/brief

Briefing new saves

A period's saves are not a list to recite. The user already knows they saved things; what they don't know is what those saves add up to. Lead with the thread, not the inventory.

Get the set

Saves live in the Bookmarks table. Use query_table with a date filter on the Saved column — dates are ISO strings, so gte compares correctly:

query_table(table_name="Bookmarks",
            filters=[{"column_id": "<Saved>", "op": "gte", "value": "2026-07-20"}],
            limit=100)

query_table returns the column list, so read the ids off that rather than guessing. It also returns total — if it exceeds your limit, page with offset before writing anything. Never brief on a partial set without saying so.

Each row carries a Summary and Topics already, written when the item was saved. Use them. Only open the full saved copy (the Clip link) when the summary is too thin to place the item.

Write it

1. The thread — two or three sentences on what connects this period's

saves. If nothing connects them, say that; a week of scattered saves is a real finding, not a failure to look hard enough.

1. What's worth your time — at most three items, each with why this

one and a link. Rank by what the user seems to be working on, not by what's most impressive.

1. The rest — one line each, grouped by topic, linked.
2. Untouched — anything saved in the period they haven't opened since.

Say it plainly; don't nag.

Rules

• Every claim links to the item it came from.
• No outside knowledge. If context helps, mark it "(context, not from your

saves)".

• If the period is empty, say so in one line and stop. Do not pad.
• Write it as a page in the user's stash next to the material, when you can

write pages; otherwise put it in the chat.