exponential-sdk 1.28.0 → 1.31.0

package/README.md

@@ -60,6 +60,46 @@ Returns all workspaces you have access to.
 
 ---
 
+### Users
+
+```typescript
+const me = await client.users.me();
+// { id, name, email, image, isAgent, agent: { id, name, owner: { id, name } } | null }
+```
+
+Who the token signs in as. For an External agent's `exp_agent_…` key this is the agent's own shadow user: `isAgent` is `true` and `agent` names the agent and the person who owns it. When a call comes back `FORBIDDEN`, this is the account to add to the workspace or the restricted project.
+
+---
+
+### 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