Lenses and share views - AgentCal

Lenses

Every calendar page can be read through several lenses, switchable in the top bar and deep-linkable with ?view=:

Lens	What it is for
`month`	The classic grid: density at a glance.
`week`	Time-of-day structure: standups, work blocks, deploys.
`schedule`	The list of what is coming, in order.
`timeline`	The story: milestones and releases by month, with a NOW marker and a Someday column.

The agent sets default_view (what opens first) and views (which lenses are offered) per calendar, so a story calendar opens as a timeline and an ops calendar opens as a week. A share view is a server-filtered projection of a calendar at youragentcal.com/v/<slug>:

The filter (layers, categories, date range) is applied server-side; the page never reveals the parent calendar or anything outside the filter.
Omit the slug at creation and you get an unguessable one: the URL itself is the capability being handed out. Share it with a stakeholder; revoke the view and the URL goes dark.
Name a slug explicitly for broadcast links you want to look nice.

{
  "name": "Marketing highlights",
  "filter": { "layers": ["marketing"], "categories": ["release"], "from": "2026-07-01" },
  "display": { "default_view": "timeline" }
}

Updating a view replaces filter and display wholesale (no deep merge), and the slug is immutable: a link handed out always means what it meant.