exponential-sdk 1.27.0 → 1.29.0

package/README.md

@@ -60,6 +60,35 @@ Returns all workspaces you have access to.
 
 ---
 
+### Positions (roles & responsibilities)
+
+The roles shown on a workspace's settings page (ADR-0068). Writes need a
+person's own API token — agent keys get `FORBIDDEN` — and owner/admin, except
+that a holder who is at least a member may edit their Position's remit.
+
+```typescript
+const { positions, members } = await client.positions.list(workspaceId);
+
+const cto = await client.positions.create({
+  workspaceId,
+  title: 'Technical Director',
+  remit: 'Architecture, hiring engineers, the release process.',
+  notAccountableFor: 'Sales and marketing.',
+  holderUserIds: [userId],
+});
+
+await client.positions.update({ workspaceId, positionId: cto.id, remit: '...' });
+await client.positions.setHolders(workspaceId, cto.id, [userId, otherUserId]);
+await client.positions.delete(workspaceId, cto.id);
+
+// Upsert by title in one transaction; dryRun shows the plan first.
+await client.positions.importMany({ workspaceId, dryRun: true, positions: [
+  { title: 'Travel researcher', remit: 'Flights, hotels, visas.', holderUserIds: [] },
+] });
+```
+
+---
+
 ### Projects
 
 ```typescript
@@ -122,6 +151,42 @@ const projectActions = await client.actions.getProjectActions("proj-123");
 
 ---
 
+### Ceremonies
+
+Recurring meeting definitions (ADR-0059) and their scheduled **occurrences**
+(the page at `/w/<slug>/ceremonies/<ceremonyId>/<occurrenceId>`).
+
+```typescript
+// Definitions (Settings → Ceremonies)
+const ceremonies = await client.ceremonies.list("ws-123"); // { includeInactive: true } for retired ones
+const ceremony = await client.ceremonies.get("ws-123", "cer-123"); // + participants, recent/upcoming occurrences
+
+// One meeting instance: agenda snapshot, recordings, notes page id, skip proposal
+const occ = await client.ceremonies.getOccurrence("ws-123", "occ-123");
+const notes = occ.notesPageId ? await client.pages.get(occ.notesPageId) : null;
+
+// Occurrences in a window
+await client.ceremonies.listOccurrences({ workspaceId: "ws-123", from, to, ceremonyId: "cer-123" });
+
+// Async updates (standups)
+await client.ceremonies.updateSummary("ws-123", "occ-123");
+await client.ceremonies.saveMyUpdate({ workspaceId: "ws-123", occurrenceId: "occ-123", answers: { done: "…" }, submit: true });
+
+// Agenda and lifecycle (owner, or workspace owner/admin, for generate/skip/post)
+await client.ceremonies.generateAgenda("ws-123", "occ-123", { circulate: true });
+await client.ceremonies.addAgendaItem({ workspaceId: "ws-123", occurrenceId: "occ-123", sectionKey: "blockers", title: "Pricing" });
+await client.ceremonies.skipOccurrence("ws-123", "occ-123", "Nothing to discuss");
+await client.ceremonies.attachMeeting("meeting-123", "occ-123");
+
+// Write definitions
+await client.ceremonies.create({ workspaceId: "ws-123", name: "Weekly Planning", cadenceRule: "FREQ=WEEKLY;BYDAY=MO;BYHOUR=10;BYMINUTE=0", timezone: "Europe/Madrid", startsOn: new Date("2026-10-05") });
+await client.ceremonies.update({ workspaceId: "ws-123", id: "cer-123", isActive: false });
+```
+
+Decisions logged in an occurrence carry its `occurrenceId` (see Decisions below).
+
+---
+
 ### Decisions
 
 The workspace Decision Log (ADR-0060). **An open question is a decision with