@murphai/murph 0.1.18 → 0.2.3

package/config.schema.json

@@ -166,34 +166,6 @@
                       }
                     }
                   }
-                },
-                "upgrade": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        },
-                        "dryRun": {
-                          "default": false,
-                          "description": "Preview the upgrade plan without writing canonical files.",
-                          "type": "boolean"
-                        }
-                      }
-                    }
-                  }
                 }
               }
             }
@@ -242,17 +214,17 @@
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing.",
+                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote actor id for multi-user routing and direct-conversation binding.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an iMessage phone number/email handle or an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
                           "type": "string",
                           "minLength": 1
                         },
                         "sourceThread": {
-                          "description": "Optional upstream thread id from the source channel. Thread ids anchor stored conversation bindings when present.",
+                          "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -290,7 +262,7 @@
                           "minLength": 1
                         },
                         "headersJson": {
-                          "description": "Optional JSON object of extra HTTP headers for OpenAI-compatible local assistant chat sessions.",
+                          "description": "Optional flat JSON object of extra HTTP headers with string values for OpenAI-compatible local assistant chat sessions.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -326,7 +298,7 @@
                           "type": "boolean"
                         },
                         "deliveryTarget": {
-                          "description": "Optional one-send outbound target override. For iMessage this can be a phone number, email handle, or chat id; for Telegram it can be a chat id or <chatId>:topic:<messageThreadId>; for Linq it can be a chat id; for email it can be a recipient address while thread-bound sessions reply in place.",
+                          "description": "Optional one-send outbound destination in the transport-native send format. For iMessage use a phone number, email handle, or chat id; for Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for Linq use a chat id; for email use a recipient address. Reply-in-place sessions can often omit this and reuse the saved thread.",
                           "type": "string",
                           "minLength": 1
                         }
@@ -369,17 +341,17 @@
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing.",
+                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote actor id for multi-user routing and direct-conversation binding.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an iMessage phone number/email handle or an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
                           "type": "string",
                           "minLength": 1
                         },
                         "sourceThread": {
-                          "description": "Optional upstream thread id from the source channel. Thread ids anchor stored conversation bindings when present.",
+                          "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -417,7 +389,7 @@
                           "minLength": 1
                         },
                         "headersJson": {
-                          "description": "Optional JSON object of extra HTTP headers for OpenAI-compatible local assistant chat sessions.",
+                          "description": "Optional flat JSON object of extra HTTP headers with string values for OpenAI-compatible local assistant chat sessions.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -487,22 +459,22 @@
                           "minLength": 1
                         },
                         "identity": {
-                          "description": "Optional local assistant identity id for multi-user routing.",
+                          "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
                           "type": "string",
                           "minLength": 1
                         },
                         "participant": {
-                          "description": "Optional remote actor id for multi-user routing and direct-conversation binding.",
+                          "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an iMessage phone number/email handle or an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
                           "type": "string",
                           "minLength": 1
                         },
                         "sourceThread": {
-                          "description": "Optional upstream thread id from the source channel. Thread ids anchor stored conversation bindings when present.",
+                          "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                           "type": "string",
                           "minLength": 1
                         },
                         "deliveryTarget": {
-                          "description": "Optional one-send outbound target override. For iMessage this can be a phone number, email handle, or chat id; for Telegram it can be a chat id or <chatId>:topic:<messageThreadId>; for Linq it can be a chat id; for email it can be a recipient address while thread-bound sessions reply in place.",
+                          "description": "Optional one-send outbound destination in the transport-native send format. For iMessage use a phone number, email handle, or chat id; for Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for Linq use a chat id; for email use a recipient address. Reply-in-place sessions can often omit this and reuse the saved thread.",
                           "type": "string",
                           "minLength": 1
                         }
@@ -555,7 +527,7 @@
                           "minLength": 1
                         },
                         "headersJson": {
-                          "description": "Optional JSON object of extra HTTP headers for the routing endpoint.",
+                          "description": "Optional flat JSON object of extra HTTP headers with string values for the routing endpoint.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -654,22 +626,22 @@
                                   "maxLength": 128
                                 },
                                 "identity": {
-                                  "description": "Optional local assistant identity id to reuse for this saved channel target.",
+                                  "description": "Optional local assistant identity id to reuse for this saved channel target. Email targets require the configured AgentMail inbox id here.",
                                   "type": "string",
                                   "minLength": 1
                                 },
                                 "participant": {
-                                  "description": "Optional remote actor id to reuse for this saved channel target.",
+                                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an iMessage phone number/email handle or an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
                                   "type": "string",
                                   "minLength": 1
                                 },
                                 "sourceThread": {
-                                  "description": "Optional upstream thread id to reuse for this saved channel target.",
+                                  "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                                   "type": "string",
                                   "minLength": 1
                                 },
                                 "deliveryTarget": {
-                                  "description": "Optional explicit outbound destination to save for this channel target, such as a phone number, Telegram chat id, or email address.",
+                                  "description": "Optional saved outbound destination in the transport-native send format. For iMessage use a phone number, email handle, or chat id; for Telegram use a chat id or `<chatId>:topic:<messageThreadId>`; for Linq use a chat id; for email use a recipient address.",
                                   "type": "string",
                                   "minLength": 1
                                 }
@@ -882,17 +854,17 @@
                   "minLength": 1
                 },
                 "identity": {
-                  "description": "Optional local assistant identity id for multi-user routing.",
+                  "description": "Optional local assistant identity id for multi-user routing. Email routes should use the configured AgentMail inbox id.",
                   "type": "string",
                   "minLength": 1
                 },
                 "participant": {
-                  "description": "Optional remote actor id for multi-user routing and direct-conversation binding.",
+                  "description": "Optional remote participant identifier when the transport addresses a person directly. Use the transport-native participant value, such as an iMessage phone number/email handle or an email correspondent; thread-addressed transports may rely on --sourceThread instead.",
                   "type": "string",
                   "minLength": 1
                 },
                 "sourceThread": {
-                  "description": "Optional upstream thread id from the source channel. Thread ids anchor stored conversation bindings when present.",
+                  "description": "Optional upstream thread identifier when the transport routes by thread/chat. Use the transport-native thread value, such as a Telegram chat id or `<chatId>:topic:<messageThreadId>` topic route; direct-recipient routes can often leave this unset.",
                   "type": "string",
                   "minLength": 1
                 },
@@ -930,7 +902,7 @@
                   "minLength": 1
                 },
                 "headersJson": {
-                  "description": "Optional JSON object of extra HTTP headers for OpenAI-compatible local assistant chat sessions.",
+                  "description": "Optional flat JSON object of extra HTTP headers with string values for OpenAI-compatible local assistant chat sessions.",
                   "type": "string",
                   "minLength": 1
                 },
@@ -1010,7 +982,7 @@
                   "minLength": 1
                 },
                 "headersJson": {
-                  "description": "Optional JSON object of extra HTTP headers for the routing endpoint.",
+                  "description": "Optional flat JSON object of extra HTTP headers with string values for the routing endpoint.",
                   "type": "string",
                   "minLength": 1
                 },
@@ -1318,29 +1290,33 @@
                           "maxLength": 128
                         },
                         "action": {
+                          "description": "Optional audit action filter such as validate, samples_import_csv, or goal_update.",
                           "type": "string",
                           "minLength": 1
                         },
                         "actor": {
+                          "description": "Optional audit actor filter such as cli, assistant, import, or system.",
                           "type": "string",
                           "minLength": 1
                         },
                         "status": {
+                          "description": "Optional audit status filter such as success, warning, or error.",
                           "type": "string",
                           "minLength": 1
                         },
                         "from": {
+                          "description": "Inclusive lower occurredAt date bound in YYYY-MM-DD form.",
                           "type": "string",
-                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                          "description": "Calendar date in YYYY-MM-DD form."
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "to": {
+                          "description": "Inclusive upper occurredAt date bound in YYYY-MM-DD form.",
                           "type": "string",
-                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                          "description": "Calendar date in YYYY-MM-DD form."
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "sort": {
                           "default": "desc",
+                          "description": "Sort audit records by occurredAt in ascending or descending order.",
                           "type": "string",
                           "enum": [
                             "asc",
@@ -1349,6 +1325,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of audit records to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -1378,6 +1355,7 @@
                         },
                         "limit": {
                           "default": 20,
+                          "description": "Maximum number of recent audit records to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -1490,12 +1468,12 @@
                           "maxLength": 128
                         },
                         "from": {
-                          "description": "Optional inclusive start date in YYYY-MM-DD form.",
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "to": {
-                          "description": "Optional inclusive end date in YYYY-MM-DD form.",
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         }
@@ -1637,9 +1615,9 @@
                           "format": "uri"
                         },
                         "returnTo": {
-                          "description": "Optional post-connect redirect. device-syncd accepts relative paths or configured allowed origins.",
+                          "description": "Optional post-connect redirect. Accepts a root-relative path like /settings/devices or an absolute URL; device-syncd still rejects absolute URLs outside its allowed origin list.",
                           "type": "string",
-                          "format": "uri"
+                          "minLength": 1
                         },
                         "open": {
                           "description": "Open the authorization URL in the default browser after creating the OAuth state.",
@@ -1965,11 +1943,33 @@
                             "Context"
                           ],
                           "description": "Memory section to write into."
+                        }
+                      }
+                    }
+                  }
+                },
+                "update": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "options": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "vault": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Vault root."
                         },
-                        "memoryId": {
-                          "description": "Optional existing memory id to update.",
+                        "section": {
+                          "description": "Optional replacement memory section. Defaults to the current section.",
                           "type": "string",
-                          "minLength": 1
+                          "enum": [
+                            "Identity",
+                            "Preferences",
+                            "Instructions",
+                            "Context"
+                          ]
                         }
                       }
                     }
@@ -2005,11 +2005,11 @@
               "additionalProperties": false,
               "properties": {
                 "show": {
-                  "description": "Show the saved default assistant backend without changing it.",
+                  "description": "Show the saved default assistant backend without changing it. When set, no update options are allowed.",
                   "type": "boolean"
                 },
                 "preset": {
-                  "description": "Assistant backend preset to save: Codex or an OpenAI-compatible endpoint.",
+                  "description": "Assistant backend preset to save. Required for non-interactive updates when Murph cannot infer or reuse the backend, and required when switching between Codex and an OpenAI-compatible endpoint.",
                   "type": "string",
                   "enum": [
                     "codex",
@@ -2017,10 +2017,11 @@
                   ]
                 },
                 "providerPreset": {
-                  "description": "Optional named OpenAI-compatible provider preset to seed the endpoint prompts.",
+                  "description": "Optional named OpenAI-compatible provider preset. Only applies with `--preset openai-compatible`. Seeds endpoint defaults for prompts or non-interactive saves.",
                   "type": "string",
                   "enum": [
                     "openai",
+                    "vercel-ai-gateway",
                     "openrouter",
                     "venice",
                     "deepseek",
@@ -2039,37 +2040,41 @@
                   ]
                 },
                 "model": {
-                  "description": "Default model to save for the selected backend.",
+                  "description": "Default model to save for the selected backend. In non-interactive mode, pair this with `--preset` unless Murph can reuse the currently saved backend.",
                   "type": "string",
                   "minLength": 1
                 },
                 "baseUrl": {
-                  "description": "OpenAI-compatible base URL to save, such as http://127.0.0.1:11434/v1.",
+                  "description": "OpenAI-compatible base URL to save, such as http://127.0.0.1:11434/v1. Only applies with `--preset openai-compatible`.",
                   "type": "string",
                   "minLength": 1
                 },
                 "apiKeyEnv": {
-                  "description": "Environment variable name that should hold the OpenAI-compatible API key.",
+                  "description": "Environment variable name that should hold the OpenAI-compatible API key. Only applies with `--preset openai-compatible`.",
                   "type": "string",
                   "minLength": 1
                 },
                 "providerName": {
-                  "description": "Stable label for the saved OpenAI-compatible provider.",
+                  "description": "Stable label for the saved OpenAI-compatible provider. Only applies with `--preset openai-compatible`.",
                   "type": "string",
                   "minLength": 1
                 },
+                "zeroDataRetention": {
+                  "description": "Request zero data retention on Vercel AI Gateway assistant turns. Only applies with `--preset openai-compatible`.",
+                  "type": "boolean"
+                },
                 "codexCommand": {
-                  "description": "Optional Codex CLI executable path. Defaults to codex.",
+                  "description": "Optional Codex CLI executable path. Only applies with `--preset codex`. Defaults to `codex`.",
                   "type": "string",
                   "minLength": 1
                 },
                 "profile": {
-                  "description": "Optional Codex profile name to save.",
+                  "description": "Optional Codex profile name to save. Only applies with `--preset codex`.",
                   "type": "string",
                   "minLength": 1
                 },
                 "reasoningEffort": {
-                  "description": "Optional assistant reasoning effort default to save.",
+                  "description": "Optional assistant reasoning effort default to save for the selected backend. Use the matching `--preset` when Murph cannot infer the backend non-interactively.",
                   "type": "string",
                   "enum": [
                     "low",
@@ -2079,7 +2084,7 @@
                   ]
                 },
                 "oss": {
-                  "description": "Save a local Codex OSS model target instead of the signed-in Codex cloud path.",
+                  "description": "Save a local Codex OSS model target instead of the signed-in Codex cloud path. Only applies with `--preset codex`.",
                   "type": "boolean"
                 }
               }
@@ -2191,12 +2196,12 @@
                           "maxLength": 128
                         },
                         "from": {
-                          "description": "Optional inclusive start date in YYYY-MM-DD form.",
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "to": {
-                          "description": "Optional inclusive end date in YYYY-MM-DD form.",
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         }
@@ -2426,15 +2431,18 @@
                           "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}$"
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -2790,13 +2798,6 @@
                                     "kg"
                                   ]
                                 },
-                                "distance": {
-                                  "type": "string",
-                                  "enum": [
-                                    "km",
-                                    "mi"
-                                  ]
-                                },
                                 "bodyMeasurement": {
                                   "description": "Preferred circumference/body-measurement unit.",
                                   "type": "string",
@@ -2806,7 +2807,7 @@
                                   ]
                                 },
                                 "recordedAt": {
-                                  "description": "Optional profile-snapshot timestamp override in ISO 8601 form.",
+                                  "description": "Optional preferences update timestamp override in ISO 8601 form.",
                                   "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)))$"
@@ -3332,6 +3333,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -3520,6 +3522,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -3707,6 +3710,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -3974,6 +3978,7 @@
                           "maxLength": 128
                         },
                         "kind": {
+                          "description": "Optional canonical event kind filter such as encounter, procedure, test, adverse_effect, or exposure.",
                           "type": "string",
                           "minLength": 1
                         },
@@ -3988,7 +3993,7 @@
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "tag": {
-                          "description": "Optional tag filter. Repeat --tag for multiple values.",
+                          "description": "Optional tag filter. Repeat --tag to match any listed tag.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -3996,12 +4001,13 @@
                           }
                         },
                         "experiment": {
+                          "description": "Optional experiment slug filter for events linked to one experiment.",
                           "type": "string",
-                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-                          "description": "Stable lowercase kebab-case identifier."
+                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -4827,6 +4833,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -5001,17 +5008,18 @@
                           "maxLength": 128
                         },
                         "from": {
-                          "description": "Inclusive lower date bound.",
+                          "description": "Optional inclusive lower date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "to": {
-                          "description": "Inclusive upper date bound.",
+                          "description": "Optional inclusive upper date bound in YYYY-MM-DD form.",
                           "type": "string",
                           "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -5068,7 +5076,7 @@
                           "maxLength": 128
                         },
                         "eventId": {
-                          "description": "Optional event ids to mutate. Repeat --event-id for multiple values.",
+                          "description": "Optional event ids to mutate. Repeat --event-id for multiple values. Mutually exclusive with --stream.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -5076,7 +5084,7 @@
                           }
                         },
                         "stream": {
-                          "description": "Optional sample streams to mutate. Repeat --stream for multiple values.",
+                          "description": "Optional sample streams to mutate. Repeat --stream for multiple values. Mutually exclusive with --event-id.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -5107,7 +5115,7 @@
                           "maxLength": 128
                         },
                         "eventId": {
-                          "description": "Optional event ids to mutate. Repeat --event-id for multiple values.",
+                          "description": "Optional event ids to mutate. Repeat --event-id for multiple values. Mutually exclusive with --stream.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -5115,7 +5123,7 @@
                           }
                         },
                         "stream": {
-                          "description": "Optional sample streams to mutate. Repeat --stream for multiple values.",
+                          "description": "Optional sample streams to mutate. Repeat --stream for multiple values. Mutually exclusive with --event-id.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -5173,7 +5181,7 @@
                   "maxLength": 128
                 },
                 "recordType": {
-                  "description": "Optional query record families such as event, journal, assessment, profile_snapshot, current_profile, goal, condition, allergy, protocol, history, family, genetics, food, recipe, provider, or sample.",
+                  "description": "Optional query record families. Repeat --record-type for multiple values: allergy, assessment, audit, condition, core, event, experiment, family, food, genetics, goal, journal, protocol, provider, recipe, sample, workout_format.",
                   "type": "array",
                   "items": {
                     "type": "string",
@@ -5259,12 +5267,12 @@
                           "maxLength": 128
                         },
                         "text": {
-                          "description": "Search text to run across titles, notes, tags, ids, and record payloads.",
                           "type": "string",
-                          "minLength": 1
+                          "minLength": 1,
+                          "description": "Required search text to run across titles, notes, tags, ids, and record payloads."
                         },
                         "recordType": {
-                          "description": "Optional record families. Repeat --record-type for multiple values: core, experiment, journal, event, sample, audit, assessment, profile_snapshot, current_profile, goal, condition, allergy, protocol, history, family, genetics.",
+                          "description": "Optional query record families. Repeat --record-type for multiple values: allergy, assessment, audit, condition, core, event, experiment, family, food, genetics, goal, journal, protocol, provider, recipe, sample, workout_format.",
                           "type": "array",
                           "items": {
                             "type": "string",
@@ -5446,7 +5454,7 @@
                   }
                 },
                 "entryType": {
-                  "description": "Optional entry types: journal, event, assessment, history, profile_snapshot, sample_summary. Repeat --entry-type for multiple values.",
+                  "description": "Optional entry types: journal, event, assessment, sample_summary. Repeat --entry-type for multiple values.",
                   "type": "array",
                   "items": {
                     "type": "string",
@@ -7133,165 +7141,6 @@
             }
           }
         },
-        "profile": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "commands": {
-              "type": "object",
-              "additionalProperties": false,
-              "properties": {
-                "scaffold": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        }
-                      }
-                    }
-                  }
-                },
-                "upsert": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        },
-                        "input": {
-                          "type": "string",
-                          "description": "Payload input in @file.json form or - for stdin."
-                        }
-                      }
-                    }
-                  }
-                },
-                "show": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        }
-                      }
-                    }
-                  }
-                },
-                "list": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "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}$"
-                        },
-                        "limit": {
-                          "default": 50,
-                          "type": "integer",
-                          "exclusiveMinimum": 0,
-                          "maximum": 200
-                        }
-                      }
-                    }
-                  }
-                },
-                "current": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "commands": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "rebuild": {
-                          "type": "object",
-                          "additionalProperties": false,
-                          "properties": {
-                            "options": {
-                              "type": "object",
-                              "additionalProperties": false,
-                              "properties": {
-                                "vault": {
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "description": "Vault root to operate against."
-                                },
-                                "requestId": {
-                                  "description": "Optional caller-supplied request id for audit correlation.",
-                                  "type": "string",
-                                  "minLength": 1,
-                                  "maxLength": 128
-                                }
-                              }
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        },
         "goal": {
           "type": "object",
           "additionalProperties": false,
@@ -7399,6 +7248,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -7518,6 +7368,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -7637,140 +7488,7 @@
                         },
                         "limit": {
                           "default": 50,
-                          "type": "integer",
-                          "exclusiveMinimum": 0,
-                          "maximum": 200
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "history": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "commands": {
-              "type": "object",
-              "additionalProperties": false,
-              "properties": {
-                "scaffold": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        }
-                      }
-                    }
-                  }
-                },
-                "upsert": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        },
-                        "input": {
-                          "type": "string",
-                          "description": "Payload input in @file.json form or - for stdin."
-                        }
-                      }
-                    }
-                  }
-                },
-                "show": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        }
-                      }
-                    }
-                  }
-                },
-                "list": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "options": {
-                      "type": "object",
-                      "additionalProperties": false,
-                      "properties": {
-                        "vault": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Vault root to operate against."
-                        },
-                        "requestId": {
-                          "description": "Optional caller-supplied request id for audit correlation.",
-                          "type": "string",
-                          "minLength": 1,
-                          "maxLength": 128
-                        },
-                        "status": {
-                          "description": "Optional health-event status to filter by.",
-                          "type": "string",
-                          "minLength": 1
-                        },
-                        "kind": {
-                          "description": "Optional history event kind filter such as encounter, procedure, test, adverse_effect, or exposure.",
-                          "type": "string",
-                          "minLength": 1
-                        },
-                        "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": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -7900,6 +7618,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -8014,6 +7733,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -8133,6 +7853,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -8252,6 +7973,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200
@@ -8280,9 +8002,9 @@
                           "maxLength": 128
                         },
                         "stoppedOn": {
+                          "description": "Optional calendar day when the supplement stopped. Defaults to today.",
                           "type": "string",
-                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                          "description": "Calendar date in YYYY-MM-DD form."
+                          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                         }
                       }
                     }
@@ -8351,6 +8073,7 @@
                                 },
                                 "limit": {
                                   "default": 50,
+                                  "description": "Maximum number of results to return.",
                                   "type": "integer",
                                   "exclusiveMinimum": 0,
                                   "maximum": 200
@@ -8507,6 +8230,7 @@
                         },
                         "limit": {
                           "default": 50,
+                          "description": "Maximum number of results to return.",
                           "type": "integer",
                           "exclusiveMinimum": 0,
                           "maximum": 200