@mind-your-now/myn 0.8.2 → 0.8.4

package/dist/src/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+BAA+B;AAC/B,MAAM,UAAU,GAAG,wEAAwE,CAAC;AAE5F,+BAA+B;AAC/B,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,SAAiB;IACvE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,gCAAgC;IACxF,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,WAAW,SAAS,qBAAqB,CAAC;IACnE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,WAAW,SAAS,sEAAsE,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,2DAA2D;IAC3D,OAAO,IAAI;SACR,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;6EAC6E;AAC7E,MAAM,UAAU,GAAG,sDAAsD,CAAC;AAE1E,+BAA+B;AAC/B,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,SAAiB;IACvE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,gCAAgC;IACxF,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,WAAW,SAAS,qBAAqB,CAAC;IACnE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,WAAW,SAAS,sEAAsE,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,2DAA2D;IAC3D,OAAO,IAAI;SACR,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "myn",
   "name": "Mind Your Now",
-  "version": "0.1.0",
+  "version": "0.8.2",
   "description": "AI-powered task and life management for OpenClaw agents",
   "author": "Mind Your Now <team@mindyournow.com>",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mind-your-now/myn",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "OpenClaw plugin for Mind Your Now - AI-powered task and life management",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@mind-your-now/skills": "0.1.0",
+    "@mind-your-now/skills": "0.1.2",
     "@sinclair/typebox": "^0.34.0"
   },
   "engines": {

package/skills/myn/SKILL.md

@@ -10,16 +10,18 @@ Use these OpenClaw tool names instead of raw REST calls:
 |---------------|---------|-----------------|-----------|
 | `myn_tasks` | list, get, create, update, complete, archive, search | `/api/v2/unified-tasks` | [references/tasks-api.md](references/tasks-api.md) |
 | `myn_debrief` | status, generate, get, apply_correction, complete_session | `/api/v2/debrief/*` | [references/debrief-api.md](references/debrief-api.md) |
-| `myn_calendar` | list_events, create_event, delete_event, meetings | `/api/v2/calendar/*` | [references/calendar-api.md](references/calendar-api.md) |
-| `myn_habits` | streaks, skip, chains, schedule, reminders | `/api/v1/habit-chains/*` | [references/habits-api.md](references/habits-api.md) |
-| `myn_lists` | get, add, toggle, bulk_add, convert_to_tasks | `/api/v1/households/*/grocery-list` | [references/lists-api.md](references/lists-api.md) |
-| `myn_timers` | create_countdown, create_alarm, list, cancel, snooze, pomodoro | `/api/v2/timers` | [references/timers-api.md](references/timers-api.md) |
+| `myn_calendar` | list_calendars, list_events, get_event, create_event, update_event, delete_event, move_event, meetings | `/api/v2/calendar/*` | [references/calendar-api.md](references/calendar-api.md) |
+| `myn_habits` | streaks, skip, chains, schedule, reminders | `/api/v2/unified-tasks/*, /api/habits/*` | [references/habits-api.md](references/habits-api.md) |
+| `myn_lists` | get, add, toggle, bulk_add, update, delete, delete_checked, convert_to_tasks | `/api/v1/households/*/grocery-list` | [references/lists-api.md](references/lists-api.md) |
+| `myn_timers` | create_countdown, create_alarm, list, cancel, snooze, pomodoro | `/api/v2/timers/*` | [references/timers-api.md](references/timers-api.md) |
 | `myn_search` | search | `/api/v2/search` | [references/search-api.md](references/search-api.md) |
-| `myn_memory` | remember, recall, forget, search | `/api/v1/customers/memories` | [references/memory-api.md](references/memory-api.md) |
-| `myn_profile` | get_info, get_goals, update_goals, preferences | `/api/v1/customers/*` | [references/profile-api.md](references/profile-api.md) |
-| `myn_household` | members, invite, chores, chore_schedule, chore_complete | `/api/v1/households/*` | [references/household-api.md](references/household-api.md) |
-| `myn_projects` | list, get, create, move_task | `/api/project` | [references/projects-api.md](references/projects-api.md) |
-| `myn_planning` | plan, schedule_all, reschedule | `/api/schedules/*` | [references/planning-api.md](references/planning-api.md) |
+| `myn_memory` | remember, recall, forget, search | `/api/v1/agent/memories, /api/v1/customers/memories` | [references/memory-api.md](references/memory-api.md) |
+| `myn_profile` | get_info, get_goals, update_goals, preferences | `/api/v1/customers` | [references/profile-api.md](references/profile-api.md) |
+| `myn_household` | members, invite, chores, chore_schedule, chore_complete | `/api/v1/households/*, /api/v2/chores/*` | [references/household-api.md](references/household-api.md) |
+| `myn_projects` | list, get, create, move_task | `/api/project/*` | [references/projects-api.md](references/projects-api.md) |
+| `myn_planning` | plan, schedule_all, reschedule | `/planning/*` | [references/planning-api.md](references/planning-api.md) |
+| `myn_ynab` | budget_overview, category_balance, list_categories, account_balances, set_budget_amount, set_category_goal, goal_progress, budget_months, search_payees, create_transaction, create_transactions_bulk, list_transactions, update_transaction, delete_transaction, split_transaction, scheduled_transactions, create_scheduled_transaction, update_scheduled_transaction, delete_scheduled_transaction, subscriptions, upcoming_bills, spending_insights, payee_analysis, spending_trends, net_worth, debt_tracking, create_category_group, create_category, rename_category, move_category, rename_category_group, connection_status | `/api/v1/ynab/*` | [references/ynab-api.md](references/ynab-api.md) |
+| `myn_a2a_pairing` | redeem_invite, ping, send_message, get_agent_card | `/api/v1/agent/*, /a2a/*` | N/A |
 
 ## Quick Reference
 
@@ -34,7 +36,7 @@ Use these OpenClaw tool names instead of raw REST calls:
 
 ### Task Creation (Required Fields)
 
-Every `myn_tasks create` call needs: `title`, `taskType`, `priority`, `startDate`. A UUID is auto-generated — do NOT supply `id`.
+Every `myn_tasks create` call needs: `title`, `taskType`, `priority`, `startDate`. The `id` field is optional (auto-generated if omitted).
 
 ### Morning Routine
 

package/skills/myn/references/briefing-api.md

@@ -1,187 +1,15 @@
-# Briefing API
+# Briefing API (DEPRECATED)
 
-Compass briefing system for AI-generated daily planning sessions with corrections and completion tracking.
+**This API has been deprecated.** The compass/briefing endpoints have been renamed to **debrief**.
 
-## Base Path
+See [debrief-api.md](debrief-api.md) for the current API documentation.
 
-`/api/v2/compass`
+All `/api/v2/compass/*` endpoints should be replaced with `/api/v2/debrief/*`:
 
-## Endpoints
-
-### Get Session Status
-
-```
-GET /api/v2/compass/status
-```
-
-Returns the current briefing session state.
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `hasActiveSession` | boolean | Whether a briefing session is currently active |
-| `sessionId` | UUID | Current session ID (null if no active session) |
-| `lastBriefingId` | UUID | ID of the most recent briefing |
-| `lastBriefingTime` | datetime | Timestamp of the most recent briefing |
-| `pendingCorrections` | number | Count of unprocessed corrections |
-
-```bash
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/compass/status"
-```
-
-### Generate Briefing
-
-```
-POST /api/v2/compass/generate
-```
-
-Generates a new Compass briefing with prioritized task lists and suggestions.
-
-**Body Parameters:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `context` | string | Optional context to guide the briefing (e.g., "busy morning, meetings after 2pm") |
-| `focusAreas` | string[] | Optional focus areas to emphasize (e.g., `["health", "work deadlines"]`) |
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `briefingId` | UUID | Unique briefing identifier |
-| `sessionId` | UUID | Session this briefing belongs to |
-| `summary` | string | Natural language summary of the day |
-| `criticalNow` | object[] | Tasks requiring immediate attention |
-| `opportunityNow` | object[] | Tasks worth doing if time allows |
-| `overTheHorizon` | object[] | Tasks to keep in mind for later |
-| `upcomingMeetings` | object[] | Meetings and calendar events today |
-| `habitsDue` | object[] | Habits scheduled for today |
-| `suggestions` | string[] | AI-generated actionable suggestions |
-| `createdAt` | datetime | Briefing generation timestamp |
-
-```bash
-# Generate a basic briefing
-curl -X POST "$MYN_API_URL/api/v2/compass/generate" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{}'
-
-# Generate with context and focus areas
-curl -X POST "$MYN_API_URL/api/v2/compass/generate" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "context": "Working from home today, low energy",
-    "focusAreas": ["health", "project deadlines"]
-  }'
-```
-
-### Get Latest Briefing
-
-```
-GET /api/v2/compass/latest
-```
-
-Returns the most recent briefing without generating a new one.
-
-```bash
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/compass/latest"
-```
-
-### Get Specific Briefing
-
-```
-GET /api/v2/compass/briefings/{briefingId}
-```
-
-```bash
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/compass/briefings/550e8400-e29b-41d4-a716-446655440000"
-```
-
-### Submit Correction
-
-```
-POST /api/v2/compass/corrections
-```
-
-Submits a correction to update the active briefing session when reality diverges from the plan.
-
-**Body Parameters:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | string | **Required.** One of: `TASK_COMPLETED`, `TASK_MISSED`, `TASK_RESCHEDULED`, `TASK_ADDED`, `PRIORITY_CHANGED`, `OTHER` |
-| `data` | object | Optional data relevant to the correction type (e.g., `{"taskId": "..."}`) |
-| `reason` | string | Optional human-readable reason for the correction |
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `correctionId` | UUID | Unique correction identifier |
-| `appliedAt` | datetime | When the correction was applied |
-| `briefingUpdated` | boolean | Whether the active briefing was re-ranked |
-
-```bash
-# Mark a task as completed mid-session
-curl -X POST "$MYN_API_URL/api/v2/compass/corrections" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "type": "TASK_COMPLETED",
-    "data": {"taskId": "550e8400-e29b-41d4-a716-446655440000"},
-    "reason": "Finished the report early"
-  }'
-
-# Report a priority change
-curl -X POST "$MYN_API_URL/api/v2/compass/corrections" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "type": "PRIORITY_CHANGED",
-    "data": {"taskId": "660e8400-e29b-41d4-a716-446655440001", "newPriority": "CRITICAL"},
-    "reason": "Client moved deadline up"
-  }'
-```
-
-### Complete Session
-
-```
-POST /api/v2/compass/complete
-```
-
-Ends the active briefing session with an optional summary and decisions record.
-
-**Body Parameters:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `summary` | string | Optional end-of-session summary |
-| `decisions` | string[] | Optional list of key decisions made during the session |
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `sessionId` | UUID | The completed session ID |
-| `completedAt` | datetime | Session completion timestamp |
-| `nextSessionRecommended` | datetime | Suggested time for next briefing (nullable) |
-| `followUps` | object[] | Auto-generated follow-up items |
-
-```bash
-# Complete the session with a summary
-curl -X POST "$MYN_API_URL/api/v2/compass/complete" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "summary": "Productive morning, cleared all Critical Now items",
-    "decisions": [
-      "Postponed quarterly review to Friday",
-      "Delegated invoice follow-up to Sarah"
-    ]
-  }'
-```
+| Old Endpoint | New Endpoint |
+|-------------|--------------|
+| `GET /api/v2/compass/status` | `GET /api/v2/debrief/status` |
+| `POST /api/v2/compass/generate` | `POST /api/v2/debrief/generate` |
+| `GET /api/v2/compass/current` | `GET /api/v2/debrief/current` |
+| `POST /api/v2/compass/corrections/apply` | `POST /api/v2/debrief/corrections/apply` |
+| `POST /api/v2/compass/complete` | `POST /api/v2/debrief/complete` |

package/skills/myn/references/calendar-api.md

@@ -1,50 +1,128 @@
 # Calendar API
 
-Calendar events and meetings management including creation, listing, and deletion.
+Calendar events and meetings management including listing calendars, creating, updating, moving, and deleting events.
 
 ## Base Path
 
 `/api/v2/calendar`
 
+## Actions
+
+The `myn_calendar` tool supports these actions: `list_calendars`, `list_events`, `get_event`, `create_event`, `update_event`, `delete_event`, `move_event`, `meetings`.
+
 ## Endpoints
 
+### List Calendars
+
+```
+GET /api/v1/customers/calendars
+```
+
+Returns all connected calendars with metadata.
+
+**Response Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `calendars` | object[] | Array of calendar objects |
+| `calendars[].id` | string | Calendar identifier |
+| `calendars[].name` | string | Calendar display name |
+| `calendars[].using` | boolean | Whether the calendar is active/in use |
+| `calendars[].timeZone` | string | Calendar timezone |
+| `calendars[].accessRole` | string | User's access role |
+| `calendars[].accountEmail` | string | Associated account email |
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v1/customers/calendars"
+```
+
 ### List Events
 
 ```
 GET /api/v2/calendar/events
 ```
 
+Fetches events from all connected calendars within a date range. Descriptions are automatically truncated to 200 chars and attendee lists are stripped to reduce token bloat.
+
 **Query Parameters:**
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `start` | datetime | Filter events starting at or after this time (ISO 8601) |
-| `end` | datetime | Filter events ending at or before this time (ISO 8601) |
-| `calendarId` | string | Filter by specific calendar |
-| `allDay` | boolean | Filter for all-day events only |
+| `start` | datetime | Start of range (ISO 8601). Defaults to today |
+| `end` | datetime | End of range (ISO 8601). Defaults to start + 7 days |
 | `limit` | number | Max results (default: 50) |
 
-```bash
-# List events for this week
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/calendar/events?start=2026-03-01T00:00:00Z&end=2026-03-07T23:59:59Z"
+**Tool Parameters:**
 
-# List only all-day events
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `startDate` | datetime | Maps to `start` query param |
+| `endDate` | datetime | Maps to `end` query param |
+| `daysAhead` | number | Alternative to `endDate` — computes end date N days from now |
+| `limit` | number | Max results (default: 50) |
+
+**Response:**
+
+```json
+{
+  "events": [
+    {
+      "id": "google-event-id-123",
+      "title": "Team Standup",
+      "startTime": "2026-03-09T09:00:00",
+      "endTime": "2026-03-09T09:30:00",
+      "location": "Conference Room B",
+      "calendarId": "primary",
+      "calendarName": "Edward Becker",
+      "provider": "google",
+      "allDay": false,
+      "taskId": "550e8400-e29b-41d4-a716-446655440000",
+      "status": "confirmed"
+    }
+  ],
+  "total": 1,
+  "start": "2026-03-09T00:00:00",
+  "end": "2026-03-16T00:00:00"
+}
+```
+
+**Note:** When a calendar event is linked to a MYN task, the response includes a `taskId` field (UUID string) referencing the linked task.
+
+### Get Event
+
+```
+GET /api/v2/calendar/events/{eventId}
+```
+
+Returns full details for a single event including description and attendees. Results are cached in-memory (10-minute TTL) with hash-based change detection.
+
+**Required Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `eventId` | string | Calendar event ID |
+
+**Response:** Full event object plus `_cached` (boolean, whether unchanged since last fetch) and `_hash` (content hash).
+
+```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/calendar/events?allDay=true&limit=10"
+  "$MYN_API_URL/api/v2/calendar/events/EVENT_ID"
 ```
 
 ### Create Event
 
 ```
-POST /api/v2/calendar/events
+POST /api/v2/calendar/standalone-events
 ```
 
+Creates a new calendar event (not linked to a MYN task).
+
 **Required Fields:**
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `title` | string | Event title |
+| `title` | string | Event title (1-200 chars) |
 | `startTime` | datetime | Start time (ISO 8601) |
 | `endTime` | datetime | End time (ISO 8601, required for non-all-day events) |
 
@@ -52,17 +130,24 @@ POST /api/v2/calendar/events
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `isAllDay` | boolean | Whether this is an all-day event (default: false) |
-| `description` | string | Event description |
+| `isAllDay` | boolean | All-day event (default: false) |
+| `description` | string | Event description (max 2000 chars) |
 | `location` | string | Event location |
 | `calendarId` | string | Target calendar ID |
-| `attendees` | string[] | List of attendee email addresses |
-| `recurrence` | string | Recurrence rule (RRULE format, e.g., `FREQ=WEEKLY;BYDAY=MO,WE,FR`) |
-| `reminders` | object[] | Reminders, each with `minutes` (number) and `method` (`popup` or `email`) |
+| `calendarName` | string | Calendar name to resolve to ID (e.g. "Family", "Work") |
+| `attendees` | string[] | Email addresses, household member first names, or "family"/"everyone" to invite all household members |
+| `timezone` | string | Timezone (e.g., "America/New_York") |
+| `recurrence` | string | RRULE format (e.g., `FREQ=WEEKLY;BYDAY=MO,WE,FR`) |
+| `reminders` | object[] | Each with `minutes` (number) and `method` (`popup` or `email`) |
+
+**Calendar Selection Logic:**
+1. Explicit `calendarId` takes precedence
+2. `calendarName` is resolved by fuzzy match against available calendars
+3. If attendees include household members, auto-detects family/shared calendar
+4. Falls back to "primary"
 
 ```bash
-# Create a one-time meeting
-curl -X POST "$MYN_API_URL/api/v2/calendar/events" \
+curl -X POST "$MYN_API_URL/api/v2/calendar/standalone-events" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
@@ -73,18 +158,42 @@ curl -X POST "$MYN_API_URL/api/v2/calendar/events" \
     "attendees": ["alice@example.com", "bob@example.com"],
     "reminders": [{"minutes": 10, "method": "popup"}]
   }'
+```
 
-# Create a recurring all-day event
-curl -X POST "$MYN_API_URL/api/v2/calendar/events" \
+### Update Event
+
+```
+PATCH /api/v2/calendar/standalone-events/{eventId}?calendarId={calendarId}
+```
+
+Updates an existing calendar event. Only provided fields are changed.
+
+**Required Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `eventId` | string | Calendar event ID |
+
+**Update Fields (all optional, at least one required):**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `newTitle` | string | New title |
+| `newDescription` | string | New description |
+| `newLocation` | string | New location |
+| `newStartTime` | datetime | New start time (ISO 8601) |
+| `newEndTime` | datetime | New end time (ISO 8601) |
+| `newAttendees` | string[] | Replace attendee list (email addresses or household member names) |
+| `addAttendees` | string[] | Add to existing attendee list |
+| `calendarId` | string | Calendar ID (defaults to "primary") |
+| `calendarName` | string | Calendar name to resolve |
+| `timezone` | string | Timezone for start/end times |
+
+```bash
+curl -X PATCH "$MYN_API_URL/api/v2/calendar/standalone-events/EVENT_ID?calendarId=primary" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
-  -d '{
-    "title": "Sprint review",
-    "startTime": "2026-03-06T00:00:00Z",
-    "isAllDay": true,
-    "recurrence": "FREQ=WEEKLY;INTERVAL=2;BYDAY=FR",
-    "description": "Bi-weekly sprint review"
-  }'
+  -d '{"title": "Updated meeting title", "location": "Room C"}'
 ```
 
 ### Delete Event
@@ -93,47 +202,60 @@ curl -X POST "$MYN_API_URL/api/v2/calendar/events" \
 DELETE /api/v2/calendar/events/{eventId}
 ```
 
+**Uses read-before-write guard** (agent reads event state hash before deleting).
+
 ```bash
-curl -X DELETE "$MYN_API_URL/api/v2/calendar/events/550e8400-e29b-41d4-a716-446655440000" \
-  -H "X-API-KEY: $MYN_API_KEY"
+curl -X DELETE "$MYN_API_URL/api/v2/calendar/events/EVENT_ID" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "X-MYN-State-Hash: abc123"
 ```
 
-### List Meetings
+### Move Event
 
 ```
-GET /api/v2/calendar/meetings
+POST /api/v2/calendar/standalone-events/{eventId}/move?sourceCalendarId={source}&destinationCalendarId={destination}
 ```
 
-Returns upcoming meetings with attendee information. This is a convenience view over calendar events filtered to multi-attendee meetings.
+Moves an event from one calendar to another.
 
-**Query Parameters:**
+**Required Parameters:**
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `includePast` | boolean | Include past meetings (default: false) |
-| `daysAhead` | number | Number of days to look ahead (default: 7) |
-| `limit` | number | Max results |
+| `eventId` | string | Calendar event ID |
+| `destinationCalendarId` | string | Target calendar ID (or use `destinationCalendarName`) |
 
-**Response Fields:**
+**Optional Parameters:**
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `meetings` | object[] | Array of meeting objects |
-| `meetings[].id` | string | Meeting/event ID |
-| `meetings[].title` | string | Meeting title |
-| `meetings[].startTime` | datetime | Start time |
-| `meetings[].endTime` | datetime | End time |
-| `meetings[].attendees` | string[] | List of attendee emails |
-| `meetings[].location` | string | Meeting location (nullable) |
-| `meetings[].isRecurring` | boolean | Whether the meeting recurs |
-| `total` | number | Total matching meetings |
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `destinationCalendarName` | string | Target calendar name (resolved by fuzzy match) |
+| `sourceCalendarId` | string | Source calendar ID (defaults to "primary") |
 
 ```bash
-# Get meetings for the next 7 days
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/calendar/meetings"
+curl -X POST "$MYN_API_URL/api/v2/calendar/standalone-events/EVENT_ID/move?sourceCalendarId=primary&destinationCalendarId=DEST_ID" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+### Meetings
 
-# Get meetings for the next 14 days including past
+```
+GET /api/v2/calendar/events (filtered to events with attendees)
+```
+
+Returns upcoming meetings (events that have attendees). This action uses the standard events endpoint with date range filtering, then filters to only events with attendees.
+
+**Tool Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `includePast` | boolean | Include today's past meetings (default: false) |
+| `daysAhead` | number | Days to look ahead (default: 7) |
+| `limit` | number | Max results |
+
+```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/calendar/meetings?daysAhead=14&includePast=true&limit=25"
+  "$MYN_API_URL/api/v2/calendar/events?start=2026-03-09T00:00:00&end=2026-03-16T00:00:00"
 ```