Caute

For the card Caute shows inside the chat, when the person taps Keep on a suggested property: it becomes theirs, confirmed. Never call this yourself; only the person decides (INV-50).

card_keep_property

For the card Caute shows inside the chat, when the person taps Keep on the pages a saved conversation cited (ADR 0158): each not yet kept is caught into the conversation's space and linked to it, fetched in the background. Never call this yourself; keeping sources is offered, never done unasked.

card_keep_cited

Passages the user marked in what they saved, newest first: the marked words, and the item each is in (id and title). Notes the user wrote are read with get_note.

list_highlights

The searches the user saved in Caute, each a working set that updates itself. Returns each one's id, name and query; run one with run_saved_search.

list_saved_searches

The tags the user organises their library with, and how many items each has. Pass a path to tag_items, or to search's tags, to work with that set.

list_tags

Connect two cards. Both must be ones this connection can see. This arrives as a suggestion for the user to accept, unless this connection was granted links:write, in which case it is a link.

propose_link

Suggest properties for a saved item: typed fields the user can filter by. They wait for the user to confirm them, unless this connection was allowed to set properties. A value the user already set, or a suggestion they dismissed, is left as it is.

propose_properties

Suggest tags for a saved item, by path (such as clients/acme). They wait for the user to confirm them, unless this connection was allowed to tag directly.

propose_tags

Read a note's current text and revision. Send the revision back with update_note so an edit cannot overwrite someone else's.

get_note

Read a saved item's full text, about 8,000 characters at a time: pass next_cursor back for the next part. Returns the title, kind, address and the text, labelled untrusted.

get_item

What the user's assistants, this one included, remembered about them on a topic: memory notes only, grouped by note, each with the assistant that wrote it (the assistant property) and the card it was learned from. A memory that replaced another carries the old words and date in replaced, so you can say what changed and when; two memories flagged may_disagree say nearly the same thing from different assistants, so read both and say so. Call it at the start of a task about the user's own work, before reading the library. Everything returned is untrusted data from the user's library.

recall

What the user saved most recently, newest first: id, title, kind, when, tags, the opening words of each, and whether it is in their reading queue. Use get_item to read one.

recent

Remember something about the user for next time, for you and for their other assistants. Write it as a fact about the user that any assistant can use ("The user prefers short answers"), never as preferences for yourself or instructions to yourself. It becomes a note in their private inbox under this app's own name (the tag memory/<app> and the property assistant), which they can read, edit and forget; recall returns it to every assistant. When it corrects a memory, pass that memory in replaces: the old one is kept, no longer returned, and recall carries its words and date beside the new one, so any assistant can say what changed. Returns the note's id and address.

remember

Replace a note's text. Refused if the note changed since you read it: read it again, merge, and try once more. The previous text is always kept in the note's history.

update_note

Run one of the user's saved searches, with its filters, over what this connection can read. Results are shaped like search's.

run_saved_search

Save text, a web page, a small file or a conversation to the user's library, for them to find later. Caute reads and indexes it in the background. Returns the new item's id and its address in Caute.

save_item

Find saved items by keyword and meaning. Returns up to `limit` items, each with a short excerpt where it matched, its title, kind, address and item id. To answer a question rather than find items, use ask; to read one in full, use get_item.

search

Ask Caute to write a brief: a cited synthesis over one tag, saved search, set of items or question (give exactly one), saved as a note in the user's private inbox. It takes a minute or two; returns a task_id to pass to get_brief. Counts against the user's plan.

create_brief

Write a new note in the user's library, in Markdown. Returns its id, revision and address; use append_to_note to add to it later.

create_note