@murphai/murph 1.3.0 → 1.3.1

package/config.schema.json

@@ -393,17 +393,17 @@
                           "minLength": 1
                         },
                         "channel": {
-                          "description": "Optional channel label such as telegram or email.",
+                          "description": "Optional local channel label: telegram.",
                           "type": "string",
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
+                          "description": "Optional local assistant identity id for multi-user routing.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -466,7 +466,7 @@
                           "type": "boolean"
                         },
                         "deliveryTarget": {
-                          "description": "Optional one-send outbound destination in the transport-native send format. For Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for email use a recipient address. Reply-in-place sessions can often omit this and reuse the saved thread.",
+                          "description": "Optional one-send Telegram destination as a chat id or `<chatId>:topic:<messageThreadId>`. Reply-in-place sessions can often omit this and reuse the saved thread.",
                           "type": "string",
                           "minLength": 1
                         }
@@ -499,17 +499,17 @@
                           "minLength": 1
                         },
                         "channel": {
-                          "description": "Optional channel label such as telegram or email.",
+                          "description": "Optional local channel label: telegram.",
                           "type": "string",
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
+                          "description": "Optional local assistant identity id for multi-user routing.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -596,17 +596,17 @@
                           "minLength": 1
                         },
                         "channel": {
-                          "description": "Optional channel label such as telegram or email.",
+                          "description": "Optional local channel label: telegram.",
                           "type": "string",
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
+                          "description": "Optional local assistant identity id for multi-user routing.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly; thread-addressed transports may rely on --thread instead.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -616,7 +616,7 @@
                           "minLength": 1
                         },
                         "deliveryTarget": {
-                          "description": "Optional one-send outbound destination in the transport-native send format. For Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for email use a recipient address. Reply-in-place sessions can often omit this and reuse the saved thread.",
+                          "description": "Optional one-send Telegram destination as a chat id or `<chatId>:topic:<messageThreadId>`. Reply-in-place sessions can often omit this and reuse the saved thread.",
                           "type": "string",
                           "minLength": 1
                         }
@@ -722,12 +722,12 @@
                                   "maxLength": 128
                                 },
                                 "identity": {
-                                  "description": "Optional local assistant identity id to reuse for this saved channel target. Email targets require the configured AgentMail inbox id here.",
+                                  "description": "Optional local assistant identity id to reuse for this saved channel target.",
                                   "type": "string",
                                   "minLength": 1
                                 },
                                 "participant": {
-                                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
+                                  "description": "Optional remote participant identifier when the transport addresses a person directly; thread-addressed transports may rely on --thread instead.",
                                   "type": "string",
                                   "minLength": 1
                                 },
@@ -737,7 +737,7 @@
                                   "minLength": 1
                                 },
                                 "deliveryTarget": {
-                                  "description": "Optional saved outbound destination in the transport-native send format. For Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for email use a recipient address.",
+                                  "description": "Optional saved Telegram destination as a chat id or `<chatId>:topic:<messageThreadId>`.",
                                   "type": "string",
                                   "minLength": 1
                                 }
@@ -1022,17 +1022,17 @@
                   "minLength": 1
                 },
                 "channel": {
-                  "description": "Optional channel label such as telegram or email.",
+                  "description": "Optional local channel label: telegram.",
                   "type": "string",
                   "minLength": 1
                 },
                 "identity": {
-                  "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
+                  "description": "Optional local assistant identity id for multi-user routing.",
                   "type": "string",
                   "minLength": 1
                 },
                 "participant": {
-                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an email correspondent; thread-addressed transports may rely on --thread instead.",
+                  "description": "Optional remote participant identifier when the transport addresses a person directly; thread-addressed transports may rely on --thread instead.",
                   "type": "string",
                   "minLength": 1
                 },
@@ -1311,6 +1311,20 @@
                             "weekly_digest"
                           ]
                         },
+                        "plannedOccurrenceOffsetMs": {
+                          "description": "Milliseconds from this reminder to the planned session occurrence.",
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 9007199254740991
+                        },
+                        "contextReference": {
+                          "description": "Exact canonical record in <entity-kind>=<entity-id> form. Repeat for multiple records; routing and interpretation context only.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 3
+                          }
+                        },
                         "continuityPolicy": {
                           "description": "Optional continuity policy for scheduled assistant context.",
                           "type": "string",
@@ -1534,6 +1548,20 @@
                             "weekly_digest"
                           ]
                         },
+                        "plannedOccurrenceOffsetMs": {
+                          "description": "Milliseconds from this reminder to the planned session occurrence.",
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 9007199254740991
+                        },
+                        "contextReference": {
+                          "description": "Exact canonical record in <entity-kind>=<entity-id> form. Repeat for multiple records; routing and interpretation context only.",
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 3
+                          }
+                        },
                         "continuityPolicy": {
                           "description": "Optional continuity policy for scheduled assistant context.",
                           "type": "string",
@@ -1675,6 +1703,14 @@
                           "description": "Clear persisted plan-support consent metadata.",
                           "type": "boolean"
                         },
+                        "clearPlannedOccurrenceOffset": {
+                          "description": "Clear the planned session occurrence offset.",
+                          "type": "boolean"
+                        },
+                        "clearContextReferences": {
+                          "description": "Clear all canonical routing and interpretation references.",
+                          "type": "boolean"
+                        },
                         "clearAssistantTargetOverride": {
                           "description": "Clear the stored assistant target override.",
                           "type": "boolean"
@@ -3583,6 +3619,36 @@
                       }
                     }
                   }
+                },
+                "knowledge": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "search": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "limit": {
+                                  "default": 3,
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 3
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
                 }
               }
             }
@@ -3645,6 +3711,11 @@
                             "device",
                             "derived"
                           ]
+                        },
+                        "reuseExact": {
+                          "default": false,
+                          "description": "Reuse one live document with verified identical bytes instead of creating another document.",
+                          "type": "boolean"
                         }
                       }
                     }
@@ -3721,6 +3792,24 @@
                     }
                   }
                 },
+                "workout-import-status": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        }
+                      }
+                    }
+                  }
+                },
                 "edit": {
                   "type": "object",
                   "additionalProperties": false,
@@ -4613,6 +4702,33 @@
               "type": "object",
               "additionalProperties": false,
               "properties": {
+                "resolve-address": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "country": {
+                          "description": "Optional ISO 3166-1 alpha-2 country restriction. Repeat --country to add more than one.",
+                          "maxItems": 10,
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "pattern": "^[A-Za-z]{2}$"
+                          }
+                        },
+                        "language": {
+                          "description": "Optional language hint for provider display names.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 10
+                        }
+                      }
+                    }
+                  }
+                },
                 "estimate": {
                   "type": "object",
                   "additionalProperties": false,
@@ -4709,7 +4825,7 @@
                       "properties": {
                         "input": {
                           "type": "string",
-                          "description": "Compact tag-profile JSON in @file.json form or - for stdin. Use bucket fields: topics, biomarkers, behaviors, supplements, conditionsOrConcerns, goals, activeExperiments. Do not include raw labs, names, dates of birth, full notes, or medical records."
+                          "description": "Focused structured JSON using required {\"mode\":\"focused\"} plus exact server-owned public concepts. Pass @file.json or - for stdin. Focused concept values: topics=[cardiometabolic risk, cognition, memory, metabolic health, mitochondrial complex i, phase i trials, recovery, sleep, sleep duration, sleep regularity, systematic reviews, type i interferon signaling, us guidelines]; biomarkers=[apob, glucose, hba1c, hdl cholesterol, hs-crp, ldl cholesterol]; behaviors=[exercise, meal timing, morning light, resistance training, screen curfew, sleep timing, yoga, zone 2 training]; supplements=[caffeine, creatine, magnesium, omega-3, vitamin d]; conditionsOrConcerns=[adults, anxiety, healthy adults, insomnia, menopause, migraine, older adults, parkinsons disease, sleep deprivation, type 2 diabetes]; goals=[better recovery, cardiometabolic health, cognitive performance, longevity, memory, sleep quality]; activeExperiments=[creatine supplementation, meal timing, morning light, resistance training, screen curfew]. Never include arbitrary values, names, organizations, private notes, contacts, identifiers, credentials, exact personal measurements, or medical records."
                         },
                         "since": {
                           "type": "string",
@@ -4740,7 +4856,7 @@
                       "properties": {
                         "input": {
                           "type": "string",
-                          "description": "Compact lane JSON in @file.json form or - for stdin. Use {\"lanes\":[{\"label\":\"sleep\",\"profile\":{\"topics\":[\"sleep\"]}}]}. Lane profiles use the same bucket fields as research scout and must not include raw labs, names, dates of birth, full notes, or medical records."
+                          "description": "Finite public-concept lane JSON in @file.json form or - for stdin. Use {\"lanes\":[{\"label\":\"sleep\",\"profile\":{\"topics\":[\"sleep\"]}}]}. Lane profiles accept tag-only bucket fields with the same server-owned provider concepts and must not include focused mode, arbitrary values, raw labs, names, dates of birth, full notes, or medical records."
                         },
                         "since": {
                           "type": "string",
@@ -5016,7 +5132,7 @@
                         },
                         "input": {
                           "type": "string",
-                          "description": "Structured meal payload in @file.json form or - for stdin. Structured payload object keys: `photo` or `photoPath` for an optional meal photo path; `audio` or `audioPath` for an optional audio note path; `note`, `occurredAt`, and `source` for the saved event fields; `ingredients` as a string array; `nutrition` as `{ totals?: { calories?, proteinGrams?, carbsGrams?, fatGrams?, fiberGrams? }, provenance?: { source, confidence?, sourceDetail? } }`."
+                          "description": "Structured meal payload in @file.json form or - for stdin. Structured payload object keys: `photo` or `photoPath` for an optional meal photo path; `audio` or `audioPath` for an optional audio note path; `note`, `occurredAt`, and `source` for the saved event fields; `ingredients` as a string array; `nutrition` as `{ totals?: { calories?, proteinGrams?, carbsGrams?, fatGrams?, fiberGrams?, waterGrams? }, micros?: { <supported bounded nutrient keys> }, provenance?: { source, confidence?, sourceDetail? } }`."
                         },
                         "photo": {
                           "description": "Optional meal photo path.",
@@ -5152,6 +5268,34 @@
                     }
                   }
                 },
+                "nutrients": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "from": {
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "to": {
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        }
+                      }
+                    }
+                  }
+                },
                 "remove-photo": {
                   "type": "object",
                   "additionalProperties": false,
@@ -5620,6 +5764,63 @@
                     }
                   }
                 },
+                "entry": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "list": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "metric": {
+                                  "minItems": 1,
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "minLength": 1,
+                                    "maxLength": 120
+                                  },
+                                  "description": "Measurement metric name or slug. Repeat --metric for OR matching. Registered aliases match their canonical metric identity; unknown custom metrics use normalized exact matching, never fuzzy matching."
+                                },
+                                "from": {
+                                  "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "to": {
+                                  "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
+                                  "type": "string",
+                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                                },
+                                "limit": {
+                                  "default": 10,
+                                  "description": "Maximum number of results to return.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 200
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
                 "manifest": {
                   "type": "object",
                   "additionalProperties": false,
@@ -5706,6 +5907,336 @@
               "type": "object",
               "additionalProperties": false,
               "properties": {
+                "start": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "routine": {
+                          "description": "Optional saved workout-format id, slug, or exact title.",
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "type": {
+                          "description": "Optional activity type override. Defaults to strength-training.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 120
+                        },
+                        "note": {
+                          "description": "Optional session note.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 4000
+                        },
+                        "startedAt": {
+                          "description": "Optional live-session start timestamp. Defaults to now.",
+                          "type": "string",
+                          "format": "date-time",
+                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                        }
+                      }
+                    }
+                  }
+                },
+                "active": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "workoutId": {
+                          "description": "Optional canonical workout id. Omit it only when exactly one live workout is active.",
+                          "type": "string",
+                          "pattern": "^evt_[0-9A-Za-z]+$"
+                        }
+                      }
+                    }
+                  }
+                },
+                "finish": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "workoutId": {
+                          "description": "Optional canonical workout id. Omit it only when exactly one live workout is active.",
+                          "type": "string",
+                          "pattern": "^evt_[0-9A-Za-z]+$"
+                        },
+                        "endedAt": {
+                          "description": "Optional finish timestamp. Defaults to now.",
+                          "type": "string",
+                          "format": "date-time",
+                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                        }
+                      }
+                    }
+                  }
+                },
+                "exercise": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "add": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "workoutId": {
+                                  "description": "Optional canonical workout id. Omit it only when exactly one live workout is active.",
+                                  "type": "string",
+                                  "pattern": "^evt_[0-9A-Za-z]+$"
+                                },
+                                "sourceExerciseId": {
+                                  "description": "Optional stable source exercise id, such as an exercise catalog id.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 200
+                                },
+                                "order": {
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991,
+                                  "description": "One-based exercise order within the live workout."
+                                },
+                                "groupId": {
+                                  "description": "Optional superset or circuit group id.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 80
+                                },
+                                "mode": {
+                                  "type": "string",
+                                  "enum": [
+                                    "weight_reps",
+                                    "bodyweight",
+                                    "assisted_bodyweight",
+                                    "weighted_bodyweight",
+                                    "duration",
+                                    "cardio"
+                                  ]
+                                },
+                                "unitOverride": {
+                                  "type": "string",
+                                  "enum": [
+                                    "lb",
+                                    "kg"
+                                  ]
+                                },
+                                "note": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 4000
+                                },
+                                "sets": {
+                                  "default": 1,
+                                  "description": "Number of unlogged set placeholders to create. Defaults to 1.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 150
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "set": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "commands": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "log": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "workoutId": {
+                                  "description": "Optional canonical workout id. Omit it only when exactly one live workout is active.",
+                                  "type": "string",
+                                  "pattern": "^evt_[0-9A-Za-z]+$"
+                                },
+                                "exerciseId": {
+                                  "description": "Optional stable source exercise id, such as an exercise catalog id.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 200
+                                },
+                                "exerciseOrder": {
+                                  "description": "Optional one-based exercise order within the live workout.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991
+                                },
+                                "setOrder": {
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991,
+                                  "description": "One-based set order. Read the active workout and pass it explicitly."
+                                },
+                                "requireExistingSet": {
+                                  "description": "Fail instead of appending when the selected set no longer exists.",
+                                  "type": "boolean"
+                                },
+                                "type": {
+                                  "type": "string",
+                                  "enum": [
+                                    "normal",
+                                    "warmup",
+                                    "dropset",
+                                    "failure"
+                                  ]
+                                },
+                                "note": {
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 400
+                                },
+                                "reps": {
+                                  "type": "integer",
+                                  "minimum": 0,
+                                  "maximum": 9007199254740991
+                                },
+                                "weight": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "weightUnit": {
+                                  "type": "string",
+                                  "enum": [
+                                    "lb",
+                                    "kg"
+                                  ]
+                                },
+                                "durationSeconds": {
+                                  "type": "integer",
+                                  "minimum": 0,
+                                  "maximum": 9007199254740991
+                                },
+                                "distanceMeters": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "rpe": {
+                                  "type": "number",
+                                  "minimum": 0,
+                                  "maximum": 10
+                                },
+                                "bodyweightKg": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "assistanceKg": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "addedWeightKg": {
+                                  "type": "number",
+                                  "minimum": 0
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "clear": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "options": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "requestId": {
+                                  "description": "Optional caller-supplied request id for audit correlation.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 128
+                                },
+                                "workoutId": {
+                                  "description": "Optional canonical workout id. Omit it only when exactly one live workout is active.",
+                                  "type": "string",
+                                  "pattern": "^evt_[0-9A-Za-z]+$"
+                                },
+                                "exerciseId": {
+                                  "description": "Optional stable source exercise id, such as an exercise catalog id.",
+                                  "type": "string",
+                                  "minLength": 1,
+                                  "maxLength": 200
+                                },
+                                "exerciseOrder": {
+                                  "description": "Optional one-based exercise order within the live workout.",
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991
+                                },
+                                "setOrder": {
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991,
+                                  "description": "One-based set order to clear."
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
                 "add": {
                   "type": "object",
                   "additionalProperties": false,
@@ -5843,7 +6374,7 @@
                           }
                         },
                         "workoutSet": {
-                          "description": "Compact workoutSet grammar: exercise=...;order=... plus optional set fields. Shell-quote each semicolon-separated value. Supported keys: exercise, order, type, weightUnit, reps, weight, durationSeconds, distanceMeters, rpe, bodyweightKg, assistanceKg, addedWeightKg. Repeat --workout-set for multiple sets.",
+                          "description": "Compact workoutSet grammar: exercise=...;order=... plus optional set fields. Shell-quote each semicolon-separated value. Supported keys: exercise, order, type, weightUnit, note, reps, weight, durationSeconds, distanceMeters, rpe, bodyweightKg, assistanceKg, addedWeightKg. Repeat --workout-set for multiple sets.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -6196,7 +6727,7 @@
                           }
                         },
                         "workoutSet": {
-                          "description": "Attach replacement sets with the compact workoutSet grammar: exercise=...;order=... plus optional set fields. Shell-quote each semicolon-separated value. Supported keys: exercise, order, type, weightUnit, reps, weight, durationSeconds, distanceMeters, rpe, bodyweightKg, assistanceKg, addedWeightKg. Repeat --workout-set for multiple sets.",
+                          "description": "Attach replacement sets with the compact workoutSet grammar: exercise=...;order=... plus optional set fields. Shell-quote each semicolon-separated value. Supported keys: exercise, order, type, weightUnit, note, reps, weight, durationSeconds, distanceMeters, rpe, bodyweightKg, assistanceKg, addedWeightKg. Repeat --workout-set for multiple sets.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -6329,16 +6860,35 @@
                                   "maxLength": 128
                                 },
                                 "source": {
-                                  "description": "Optional source hint such as strong or hevy.",
+                                  "description": "Strong or Hevy dialect; required when the headers are shared by both apps.",
                                   "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 80
+                                  "enum": [
+                                    "strong",
+                                    "hevy"
+                                  ]
                                 },
                                 "delimiter": {
                                   "description": "Optional single-character CSV delimiter override.",
                                   "type": "string",
                                   "minLength": 1,
                                   "maxLength": 1
+                                },
+                                "weightUnit": {
+                                  "description": "Required when positive CSV weights do not include unit metadata.",
+                                  "type": "string",
+                                  "enum": [
+                                    "lb",
+                                    "kg"
+                                  ]
+                                },
+                                "distanceUnit": {
+                                  "description": "Required when positive CSV distances do not include unit metadata.",
+                                  "type": "string",
+                                  "enum": [
+                                    "m",
+                                    "km",
+                                    "mi"
+                                  ]
                                 }
                               }
                             }
@@ -6359,10 +6909,12 @@
                                   "maxLength": 128
                                 },
                                 "source": {
-                                  "description": "Optional source hint such as strong or hevy.",
+                                  "description": "Strong or Hevy dialect; required when the headers are shared by both apps.",
                                   "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 80
+                                  "enum": [
+                                    "strong",
+                                    "hevy"
+                                  ]
                                 },
                                 "delimiter": {
                                   "description": "Optional single-character CSV delimiter override.",
@@ -6370,9 +6922,30 @@
                                   "minLength": 1,
                                   "maxLength": 1
                                 },
+                                "weightUnit": {
+                                  "description": "Required when positive CSV weights do not include unit metadata.",
+                                  "type": "string",
+                                  "enum": [
+                                    "lb",
+                                    "kg"
+                                  ]
+                                },
+                                "distanceUnit": {
+                                  "description": "Required when positive CSV distances do not include unit metadata.",
+                                  "type": "string",
+                                  "enum": [
+                                    "m",
+                                    "km",
+                                    "mi"
+                                  ]
+                                },
                                 "storeRawOnly": {
                                   "description": "Store the raw CSV + manifest without creating workout events.",
                                   "type": "boolean"
+                                },
+                                "correctUnits": {
+                                  "description": "Explicitly supersede an exact prior import after correcting its unit choice.",
+                                  "type": "boolean"
                                 }
                               }
                             }
@@ -7748,11 +8321,15 @@
                       "additionalProperties": false,
                       "properties": {
                         "limit": {
-                          "description": "Maximum label matches to return. Defaults to 5.",
+                          "description": "Maximum label matches to return. Defaults to 1.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 50
                         },
+                        "fullLabel": {
+                          "description": "Return the complete source label when the requested fact is absent from compact serving, calorie, macro, and fiber facts.",
+                          "type": "boolean"
+                        },
                         "generic": {
                           "description": "Search only USDA generic food rows, excluding branded food products.",
                           "type": "boolean"
@@ -7785,11 +8362,15 @@
                           "description": "Food product, brand, or generic ingredient search text. Repeat --query for multiple values."
                         },
                         "limit": {
-                          "description": "Maximum label matches to return per query. Defaults to 5.",
+                          "description": "Maximum label matches to return per query. Defaults to 1.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 50
                         },
+                        "fullLabel": {
+                          "description": "Return complete source labels when a requested fact is absent from compact serving, calorie, macro, and fiber facts.",
+                          "type": "boolean"
+                        },
                         "generic": {
                           "description": "Search only USDA generic food rows, excluding branded food products.",
                           "type": "boolean"
@@ -8586,6 +9167,11 @@
                           "default": false,
                           "description": "Apply the import. Without this flag the command only reports what it would create, skip, or update.",
                           "type": "boolean"
+                        },
+                        "sourceRawRefOnce": {
+                          "description": "Reject the whole batch if any workout has ever referenced this raw source. Every row must be an externalRef-free activity_session that references the same source.",
+                          "type": "string",
+                          "pattern": "^raw\\/[A-Za-z0-9._/-]+$"
                         }
                       }
                     }
@@ -10179,6 +10765,36 @@
                     }
                   }
                 },
+                "patterns": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "requestId": {
+                          "description": "Optional caller-supplied request id for audit correlation.",
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 128
+                        },
+                        "date": {
+                          "description": "Optional last action date in YYYY-MM-DD form. Defaults to today.",
+                          "type": "string",
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+                        },
+                        "windowDays": {
+                          "default": 120,
+                          "description": "Calendar-day window for matched personal patterns. Defaults to 120 days.",
+                          "type": "integer",
+                          "minimum": 28,
+                          "maximum": 366
+                        }
+                      }
+                    }
+                  }
+                },
                 "metric": {
                   "type": "object",
                   "additionalProperties": false,
@@ -11626,6 +12242,10 @@
                                   "minLength": 1,
                                   "maxLength": 128
                                 },
+                                "reminderIntentId": {
+                                  "description": "Provider-accepted private reminder intent id from trusted ordered conversation context. The canonical writer derives and deduplicates the occurrence from it.",
+                                  "type": "string"
+                                },
                                 "date": {
                                   "description": "Optional intended local session date in YYYY-MM-DD form.",
                                   "type": "string",