Recalo

Create an entry in the user's library. `nounTypeSlug` is one of the types in the Recalo type catalog. The type's schema, fetched with `recalo-fetch recalo://noun-type/<slug>`, defines the required fields (e.g. `cover_emoji`), field shapes, and date formats that `data` must match, so fetch it before a direct `data` create. Provide either `data` (a plain entry matching that schema) or `canonicalNounIds` (for canonicalizable types, the ids chosen from a lookup; the first is the primary, the rest are merged into it). Returns a link to the new entry. To change an existing entry, fetch it and use recalo-update-noun instead.

recalo-create-noun

Create a rich page (a sequence of markdown and noun_ref blocks). Do NOT inline to-do checkboxes in markdown — create a checklist noun and reference it with a noun_ref block instead. Returns a link to the new page. To EDIT a page that already exists, do not create again — fetch it and use recalo-update-page.

recalo-create-page

Apply structured edits to a checklist and return its updated view. This is the channel the Recalo checklist card uses for its own controls — to edit a checklist on the user's behalf, use recalo-update-noun instead. New items and sections need a client-generated uuid.

recalo-checklist-edit

Fetch a single entity by its recalo:// URI. Supports recalo://noun/<id>, recalo://page/<id>, recalo://event/<id>, recalo://noun-type/<id>, and recalo://docs/page-spec (the page block grammar — read it before authoring a page). A noun or page fetch lists `files` (when any): refs of the images the app read to write it, whether or not they appear in its content — pass any `/api/files/<uuid>` ref to recalo-get-file-urls to open it. A noun fetch also returns its `events` (when any) — past and future, each with its id — plus a `hint` on how to change them (and, for a checklist, how to show it): for most entries pass an event id to recalo-update-event; for a checklist, edit the item via recalo-update-noun instead (that keeps its reminders in sync). Each noun fetch reports `permission`: `owner` or `edit` means you may change it; `view` means it is read-only and any write will be refused.

recalo-fetch

Turn `/api/files/<uuid>` refs from any fetched entry — an image in a page, a photo on an event, an entry's `files` — into temporary URLs you can open or show. Pass the refs verbatim. Each URL is valid for 24 hours; refs that are not the user's own ready images come back as `unavailable`.

recalo-get-file-urls

Look up authoritative metadata candidates for a canonicalizable entry (e.g. a movie, book, or place) from external providers. Pass the `nounTypeSlug` and a `query` (a title or name). Returns candidates each with a `canonical_noun_id` — pick the right one(s) and pass them to `recalo-create-noun`. Subject to a daily limit.

recalo-lookup-metadata

Record something the user did or plans to do against an entry in their library. Pass the `nounId` the event is about, a `verbSlug` (e.g. "do", "watch", "read"), and `tense` ('past' or 'future'). Optionally attach a date via `eventLocal` + `datePrecision`, free-text `notes`, a `subject` (who did it) and `companions`. Dates use the user's timezone unless you pass `timezone`. To CHANGE an event that already exists (e.g. reschedule a reminder), do not record a new one — fetch the noun to get the event id and use recalo-update-event.

recalo-create-event

Remove access to one of the user's pages or checklists. `target` is one of: a share_id (a person who has access, or one sub-page grant of theirs from recipients[].scope), an invite_id (an invite not yet accepted), or `{ link: true }` to turn off the general-access link. Ids come from recalo-get-access. With `cascade` (default true) removing a person also removes their access to the sub-pages that were shared with it; a sub-page share_id removes just that one. Turning off a link does not remove people who already joined through it.

recalo-revoke-share

Search the user's Recalo library. Accepts one or more queries (fanned out, bounded) and returns matching nouns grouped per query, with user-facing links.

recalo-search

Share one of the user's pages or checklists, or change how it is already shared. `to` is one of: an email address, one of the user's person cards (person_noun_id from recalo-search), or `{ link: true }` for a general-access link. `permission` is view or edit. `child_noun_ids` adds sub-pages to the share (ids from recalo-get-access); it only ever adds, and to stop sharing one use recalo-revoke-share with that sub-page's share_id. Calling it again for the same recipient updates their permission and sub-pages instead of sending a second invite. Returns what happened (delivered directly, emailed, pending acceptance, or a link) and the item's url.

recalo-share