Skip to content

Permissions and safety

Markdown

The copy of your library on Copilka’s service: every item in every room, with its title, address, site, note, tags, room, favourite mark, dates, properties, a table’s cells and a file’s name; and, on request, what the reader made of a page, with its facts and the prices it has seen. Rooms, tags and the tag tree, the properties you track, your sorting rules, and what was deleted in the last thirty days.

It cannot reach the contents of files or pictures; your settings, apart from the sorting rules and the board’s layout; your devices, plan or account; your read-as-you sessions; or anything that deletes for good. No tool fetches a web page: asking for a reading asks your Mac to do it.

You tick them on the connect page, and they cannot be widened later without connecting again. The names below are the connect page’s.

  • Read, always granted: search, look at an item and its reading, list rooms, tags, properties, rules and the trash, catch up on what changed, and see which prices moved.
  • Save and tag: everything that adds or changes. Saving addresses, notes and tables; changing an item’s title, note, table, tags, room, favourite mark, properties and place on the canvas; making and changing rooms; renaming, removing and arranging tags; changing the sorting rules and sorting Unsorted; and asking your Mac to read pages again. The connect page still calls this permission additive only, which it no longer is: a title, a note or a table can be replaced, a tag taken off everything or merged into another, and a rule removed. Nothing it does deletes an item.
  • Move to trash: move items to the trash, and bring them back. Nothing is destroyed: whatever is deleted, by an assistant or on any of your devices, stays in the trash for thirty days, and restoring puts it back as it was. With four or more items at once, the server makes the assistant show you the list and ask again before anything moves.

A tool called without its permission is refused with a message naming what is missing, and nothing happens.

In any hour, a connection may make 600 successful calls that only read, and 120 that change something, counted apart. Past either, the refusal tells the assistant to tell you rather than retry, since a loop is the usual cause: This connection has made 600 reads in the last hour, which is its limit.

Changing the library is part of the subscription, its trial included. On another plan, or once a plan ends, an assistant can still read but not change anything, and is told Changing the library is part of the Copilka subscription, and this account’s plan does not include it now. Reading still works.

Every call is logged against the connection for ninety days: the tool, whether it succeeded, and the error if not. Not the arguments, not the results. The log feeds the used 12 times in the last month line on Settings → Connections and survives a disconnection. Deleting your account removes it.

While an assistant works, an open Mac hears about each call as it happens, by the ids of the items and rooms touched and nothing more, and pulls a change at once instead of at the next sync.

A saved page might contain text written to hijack an assistant: ignore your instructions and…. Copilka’s server hands back titles, sites, excerpts, notes, tables and property values inside a field named untrusted_content, with a note that they are data to report on and never instructions to follow; a page’s reading carries the same note, and the server’s own instructions to the assistant say it too. Control characters are stripped and lengths are capped. The tools’ names and descriptions are fixed and never contain anything from your library.

The service unseals your records to answer the assistant, with the key that belongs to your account. That is why the cloud copy is encrypted with Copilka’s keys rather than end-to-end; see Encryption and the cloud.

Settings → Connections → Disconnect, immediately and without a confirmation. The token is dead on the assistant’s next request. There is no page on the web to do this from; it needs the Mac app. Also remove the a connection device under Settings → Account → Other devices if you are tidying up; it does not affect the connection either way.