openmates 0.21.0-alpha.4 → 0.21.0-alpha.6

package/dist/{chunk-QVKOXAEV.js → chunk-WDFC7XBM.js}

@@ -19003,7 +19003,7 @@ var APP_SKILL_METADATA = [
     "app_namespace_py": "code",
     "skill_method_py": "run",
     "description_key": "app_skills.code.run.description",
-    "description": "Run code in an isolated E2B sandbox. When running code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_id from a filename. Use target_embed_id only for an existing chat code embed. Ask the user before running unmodified user-supplied code or after the initial run plus two unprompted reruns. The sandbox installs supported dependency manifests, executes the selected file, streams terminal status, and returns safe artif",
+    "description": "Run code in an isolated E2B sandbox or propose an exact command for the currently focused remote Project source. Remote execution requires an explicit one-run approval or an exact currently enabled command preset; never infer approval from Project write mode, chat text, or prior runs. Pass remote commands as argv, never as a composed shell string. When running E2B code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_",
     "schema": {
       "type": "object",
       "properties": {
@@ -19611,6 +19611,11 @@ Note: The 'id' field is auto-generated if not provided.
                 "maximum": 50,
                 "default": 10
               },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional concise natural-language event-selection purpose used for relevance ranking. Include it whenever the user states a material goal such as networking, promoting a product, finding potential users, or future speaking opportunities; omit it for a plain event search and never invent preferences. When present, the skill ranks a bounded pool of up to 40 candidates (or the larger requested count) and still returns only count events.\n"
+              },
               "provider": {
                 "type": "string",
                 "description": "Provider for this request. Overrides the top-level provider when set.",
@@ -19894,7 +19899,7 @@ Note: The 'id' field is auto-generated if not provided.
     "app_namespace_py": "fitness",
     "skill_method_py": "search_locations",
     "description_key": "fitness.search_locations.description",
-    "description": "Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches.",
+    "description": "Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches. When the user states a material purpose or preference that should change venue ordering, include a concise, faithful relevance_criteria value. Keep city, radius, plan, and category constraints structured. A plain venue search may omit it; never",
     "schema": {
       "type": "object",
       "properties": {
@@ -19928,7 +19933,15 @@ Note: The 'id' field is auto-generated if not provided.
                 "type": "string"
               },
               "limit": {
-                "type": "number"
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 50,
+                "default": 10
+              },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language activity goal used only to rank matching fitness locations. Omit for distance-first provider ordering; structured city, radius, plan, and category filters remain authoritative."
               }
             }
           },
@@ -19945,7 +19958,7 @@ Note: The 'id' field is auto-generated if not provided.
     "app_namespace_py": "fitness",
     "skill_method_py": "search_classes",
     "description_key": "fitness.search_classes.description",
-    "description": "Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max.",
+    "description": "Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max. When the user states a material purpose or preference that should change class ordering, include a concise, faithful relevance_criteria value. Keep date, location, radius, plan, attendance mode, min",
     "schema": {
       "type": "object",
       "properties": {
@@ -19997,7 +20010,15 @@ Note: The 'id' field is auto-generated if not provided.
                 "type": "string"
               },
               "limit": {
-                "type": "number"
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 50,
+                "default": 10
+              },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language activity goal used only to rank matching fitness classes. Omit for chronological provider ordering; structured date, location, radius, plan, attendance, spots, category, and venue filters remain authoritative."
               }
             }
           },
@@ -20121,7 +20142,7 @@ Note: The 'id' field is auto-generated if not provided.
     "app_namespace_py": "home",
     "skill_method_py": "search",
     "description_key": "app_skills.home.search.description",
-    "description": "Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany.",
+    "description": "Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany. When the user states a material preference not fully captured by the structured price, room, size, property-type, or sort fields, include a concise, faithful relevance_criteria value without waiting for the user to",
     "schema": {
       "type": "object",
       "properties": {
@@ -20189,6 +20210,11 @@ Note: The 'id' field is auto-generated if not provided.
                 "minimum": 0,
                 "description": "Minimum advertised area in square metres. Unknown area is excluded when set."
               },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional concise natural-language housing preference for relevance ranking. Include it when the user states a material preference not fully represented by structured filters; omit it for a plain search. Rank only explicit listing facts and never infer unstated amenities, commute, lease, accessibility, or neighborhood qualities. The internal candidate pool is bounded and only max_results listings are returned.\n"
+              },
               "max_results": {
                 "type": "integer",
                 "description": "Maximum number of listings to return (1-20, default 10).",
@@ -20642,7 +20668,7 @@ Each object must contain 'prompt' (description of the image).
     "app_namespace_py": "maps",
     "skill_method_py": "search",
     "description_key": "maps.search.description",
-    "description": "Search for places, businesses, restaurants, directions, locations.",
+    "description": "Search for places, businesses, restaurants, directions, and locations. When the user's request states a material purpose or preference that should change which matching places rank first, include a concise, faithful relevance_criteria value without waiting for the user to name the field. Keep location, place type, rating, open-now, price, and required amenity constraints in their structured fields. A plain place search may omit relevance_criteria; never invent quietness, ambience, accessibility,",
     "schema": {
       "type": "object",
       "properties": {
@@ -20652,7 +20678,7 @@ Each object must contain 'prompt' (description of the image).
 This parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.
 Example for single search: {"requests": [{"query": "restaurants in Berlin"}]}
 Example for multiple searches: {"requests": [{"query": "restaurants in Berlin"}, {"query": "museums in Berlin"}]}
-Each object must contain 'query' (search query string), and can include optional parameters (pageSize, languageCode, locationBias, includedType, minRating, openNow, includeReviews).
+Each object must contain 'query' (search query string), and can include optional parameters (pageSize, relevance_criteria, languageCode, locationBias, includedType, minRating, openNow, includeReviews).
 Note: The 'id' field is auto-generated if not provided - you don't need to include it.
 `,
           "items": {
@@ -20669,6 +20695,11 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
                 "maximum": 20,
                 "default": 10
               },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language goal used only to rank matching place candidates. Omit for ordinary provider ordering; structured place, rating, open-now, price, location, and amenity filters remain authoritative."
+              },
               "languageCode": {
                 "type": "string",
                 "description": "Language code for results (ISO 639-1, e.g., 'en', 'es', 'fr', 'de'). Defaults to 'en' if not specified.",
@@ -21022,7 +21053,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
     "app_namespace_py": "news",
     "skill_method_py": "search",
     "description_key": "news.search.description",
-    "description": "Search for news articles, current events, headlines, announcements.",
+    "description": "Search for news articles, current events, headlines, and announcements. When the user states a material purpose or preference that should change which coverage is most useful, include a concise, faithful relevance_criteria value. Do not wait for the user to name the field, but omit it for a plain news search and never invent preferences.",
     "schema": {
       "type": "object",
       "properties": {
@@ -21032,7 +21063,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
 This parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.
 Example for single search: {"requests": [{"query": "iPhone news"}]}
 Example for multiple searches: {"requests": [{"query": "iPhone news"}, {"query": "MacBook news"}]}
-Each object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch, freshness).
+Each object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch, freshness).
 Note: The 'id' field is auto-generated if not provided - you don't need to include it.
 `,
           "items": {
@@ -21044,10 +21075,15 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
               },
               "count": {
                 "type": "integer",
-                "description": "Number of results for this request (max 20)",
+                "description": "Number of final results for this request (default 10, max 20).",
                 "minimum": 1,
                 "maximum": 20,
-                "default": 6
+                "default": 10
+              },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional concise natural-language purpose or preference for relevance ranking. Include it when the user states a material goal that should change ordering; omit it for a plain search and never invent preferences. When present, the skill ranks up to 40 candidates and still returns only count results.\n"
               },
               "country": {
                 "type": "string",
@@ -21857,7 +21893,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
     "app_namespace_py": "shopping",
     "skill_method_py": "search_products",
     "description_key": "app_skills.shopping.search_products.description",
-    "description": "Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected.",
+    "description": "Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected. When the user states a material use case or preference that should change product ordering, include a concise, faithful relevance_criteria value. Keep provider, category, country, department, price, fulfilment, and sort constraints structured. A plain product",
     "schema": {
       "type": "object",
       "properties": {
@@ -21910,8 +21946,15 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
               "max_results": {
                 "type": "integer",
                 "description": "Maximum number of products to return (1-20, default 10).",
+                "minimum": 1,
+                "maximum": 20,
                 "default": 10
               },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language purchase goal used only to rank matching product candidates. Omit for ordinary provider ordering; structured provider, category, price, country, department, fulfilment, and sort fields remain authoritative."
+              },
               "sort": {
                 "type": "string",
                 "description": "Sort order for results. REWE supports: relevance, price_asc, price_desc, new. Amazon supports: relevance, price_asc, price_desc, review_rank, newest, best_sellers. Stoffe.de supports: relevance, price_asc, price_desc, new.\n",
@@ -22604,7 +22647,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
     "app_namespace_py": "travel",
     "skill_method_py": "search_stays",
     "description_key": "app_skills.travel.search_stays.description",
-    "description": "Run this OpenMates app skill.",
+    "description": "Search hotels, hostels, and other stays for explicit dates and party size. When the user states a material stay purpose or preference that should change which valid properties rank first, include a concise, faithful relevance_criteria value. Keep dates, guests, currency, price, hotel class, rating, free cancellation, and sort constraints in their structured fields. A plain stay search may omit relevance_criteria; never invent budget, amenities, neighborhood, quietness, accessibility, workspace,",
     "schema": {
       "type": "object",
       "properties": {
@@ -22662,6 +22705,11 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
                 "type": "integer",
                 "description": "Maximum number of results to return.",
                 "default": 10
+              },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language stay goal used only to rank matching first-page properties. Omit for ordinary provider ordering; structured date, party-size, price, class, rating, cancellation, and sort filters remain authoritative."
               }
             },
             "required": [
@@ -22872,7 +22920,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
     "app_namespace_py": "videos",
     "skill_method_py": "search",
     "description_key": "videos.search.description",
-    "description": "Search for videos, documentaries, tutorials, clips on the web.",
+    "description": "Search for videos, documentaries, tutorials, and clips on the web. When the user states a material viewing purpose or preference that should change ordering, such as audience level, desired depth, format, duration, authority, or freshness, include a concise, faithful relevance_criteria value. Keep country, language, safe-search, freshness, and count constraints structured. A plain video search may omit relevance_criteria; never invent experience level, recency, duration, creator, popularity, or",
     "schema": {
       "type": "object",
       "properties": {
@@ -22882,7 +22930,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
 This parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.
 Example for single search: {"requests": [{"query": "Python tutorial"}]}
 Example for multiple searches: {"requests": [{"query": "Python tutorial"}, {"query": "FastAPI tutorial"}]}
-Each object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch).
+Each object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch, freshness).
 Note: The 'id' field is auto-generated if not provided - you don't need to include it.
 `,
           "items": {
@@ -22899,6 +22947,11 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
                 "maximum": 20,
                 "default": 6
               },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional natural-language viewing or learning goal used only to rank matching video candidates. Omit for ordinary popularity ordering; structured country, language, safe-search, freshness, and count fields remain authoritative."
+              },
               "country": {
                 "type": "string",
                 "description": "Country code for localized results. Must be one of: AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, or ALL (case-insensitive). Defaults to 'us' if invalid.",
@@ -23587,7 +23640,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
     "app_namespace_py": "web",
     "skill_method_py": "search",
     "description_key": "app_skills.web.search.description",
-    "description": "General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies.",
+    "description": "General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies. When the user states a material purpose or preference that should change which results are most useful, include a concise, faithful relevance_criteria value (for example, research suitable for a purchase decision). Do not wait for the user to name the field, but omit it for a plain search and never invent preferences.",
     "schema": {
       "type": "object",
       "properties": {
@@ -23597,7 +23650,7 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
 This parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.
 Example for single search: {"requests": [{"query": "Python async"}]}
 Example for multiple searches: {"requests": [{"query": "Python async"}, {"query": "FastAPI best practices"}]}
-Each object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch).
+Each object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch).
 Note: The 'id' field is auto-generated if not provided - you don't need to include it.
 `,
           "items": {
@@ -23609,10 +23662,15 @@ Note: The 'id' field is auto-generated if not provided - you don't need to inclu
               },
               "count": {
                 "type": "integer",
-                "description": "Number of results for this request (max 20)",
+                "description": "Number of final results for this request (default 10, max 20).",
                 "minimum": 1,
                 "maximum": 20,
-                "default": 6
+                "default": 10
+              },
+              "relevance_criteria": {
+                "type": "string",
+                "maxLength": 1e3,
+                "description": "Optional concise natural-language purpose or preference for relevance ranking. Include it when the user states a material goal that should change ordering; omit it for a plain search and never invent preferences. When present, the skill ranks up to 40 candidates and still returns only count results.\n"
               },
               "country": {
                 "type": "string",
@@ -23982,7 +24040,7 @@ var CodeAppSkills = class {
     return this.runSkill("code", "remove_secrets", input, options);
   }
   /**
-   * Run code in an isolated E2B sandbox. When running code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_id from a filename. Use target_embed_id only for an existing chat code embed. Ask the user before running unmodified user-supplied code or after the initial run plus two unprompted reruns. The sandbox installs supported dependency manifests, executes the selected file, streams terminal status, and returns safe artif
+   * Run code in an isolated E2B sandbox or propose an exact command for the currently focused remote Project source. Remote execution requires an explicit one-run approval or an exact currently enabled command preset; never infer approval from Project write mode, chat text, or prior runs. Pass remote commands as argv, never as a composed shell string. When running E2B code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_
    * Description key: app_skills.code.run.description
    * Skill: code/run
    */
@@ -24046,7 +24104,7 @@ var FitnessAppSkills = class {
     this.runSkill = runSkill;
   }
   /**
-   * Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max.
+   * Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max. When the user states a material purpose or preference that should change class ordering, include a concise, faithful relevance_criteria value. Keep date, location, radius, plan, attendance mode, min
    * Description key: fitness.search_classes.description
    * Skill: fitness/search_classes
    */
@@ -24054,7 +24112,7 @@ var FitnessAppSkills = class {
     return this.runSkill("fitness", "search_classes", input, options);
   }
   /**
-   * Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches.
+   * Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches. When the user states a material purpose or preference that should change venue ordering, include a concise, faithful relevance_criteria value. Keep city, radius, plan, and category constraints structured. A plain venue search may omit it; never
    * Description key: fitness.search_locations.description
    * Skill: fitness/search_locations
    */
@@ -24090,7 +24148,7 @@ var HomeAppSkills = class {
     this.runSkill = runSkill;
   }
   /**
-   * Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany.
+   * Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany. When the user states a material preference not fully captured by the structured price, room, size, property-type, or sort fields, include a concise, faithful relevance_criteria value without waiting for the user to
    * Description key: app_skills.home.search.description
    * Skill: home/search
    */
@@ -24140,7 +24198,7 @@ var MapsAppSkills = class {
     this.runSkill = runSkill;
   }
   /**
-   * Search for places, businesses, restaurants, directions, locations.
+   * Search for places, businesses, restaurants, directions, and locations. When the user's request states a material purpose or preference that should change which matching places rank first, include a concise, faithful relevance_criteria value without waiting for the user to name the field. Keep location, place type, rating, open-now, price, and required amenity constraints in their structured fields. A plain place search may omit relevance_criteria; never invent quietness, ambience, accessibility,
    * Description key: maps.search.description
    * Skill: maps/search
    */
@@ -24196,7 +24254,7 @@ var NewsAppSkills = class {
     this.runSkill = runSkill;
   }
   /**
-   * Search for news articles, current events, headlines, announcements.
+   * Search for news articles, current events, headlines, and announcements. When the user states a material purpose or preference that should change which coverage is most useful, include a concise, faithful relevance_criteria value. Do not wait for the user to name the field, but omit it for a plain news search and never invent preferences.
    * Description key: news.search.description
    * Skill: news/search
    */
@@ -24350,7 +24408,7 @@ var ShoppingAppSkills = class {
     this.runSkill = runSkill;
   }
   /**
-   * Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected.
+   * Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected. When the user states a material use case or preference that should change product ordering, include a concise, faithful relevance_criteria value. Keep provider, category, country, department, price, fulfilment, and sort constraints structured. A plain product
    * Description key: app_skills.shopping.search_products.description
    * Skill: shopping/search_products
    */
@@ -24424,7 +24482,7 @@ var TravelAppSkills = class {
     return this.runSkill("travel", "search_connections", input, options);
   }
   /**
-   * Run this OpenMates app skill.
+   * Search hotels, hostels, and other stays for explicit dates and party size. When the user states a material stay purpose or preference that should change which valid properties rank first, include a concise, faithful relevance_criteria value. Keep dates, guests, currency, price, hotel class, rating, free cancellation, and sort constraints in their structured fields. A plain stay search may omit relevance_criteria; never invent budget, amenities, neighborhood, quietness, accessibility, workspace,
    * Description key: app_skills.travel.search_stays.description
    * Skill: travel/search_stays
    */
@@ -24462,7 +24520,7 @@ var VideosAppSkills = class {
     return this.runSkill("videos", "get_transcript", input, options);
   }
   /**
-   * Search for videos, documentaries, tutorials, clips on the web.
+   * Search for videos, documentaries, tutorials, and clips on the web. When the user states a material viewing purpose or preference that should change ordering, such as audience level, desired depth, format, duration, authority, or freshness, include a concise, faithful relevance_criteria value. Keep country, language, safe-search, freshness, and count constraints structured. A plain video search may omit relevance_criteria; never invent experience level, recency, duration, creator, popularity, or
    * Description key: videos.search.description
    * Skill: videos/search
    */
@@ -24506,7 +24564,7 @@ var WebAppSkills = class {
     return this.runSkill("web", "read", input, options);
   }
   /**
-   * General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies.
+   * General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies. When the user states a material purpose or preference that should change which results are most useful, include a concise, faithful relevance_criteria value (for example, research suitable for a purchase decision). Do not wait for the user to name the field, but omit it for a plain search and never invent preferences.
    * Description key: app_skills.web.search.description
    * Skill: web/search
    */
@@ -64436,6 +64494,14 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "We use api.video (EU company, France) to host and stream product demo and feature walkthrough videos shown on our website and web app. When you watch a video, your IP address and basic viewing data are processed by api.video. No user account identifiers are shared."
             }
+          },
+          hetzner_v2: {
+            heading: {
+              text: "Hetzner"
+            },
+            description: {
+              text: "We host backend services, databases, caches, S3-compatible object storage, backups, and our self-hosted OpenObserve platform on Hetzner infrastructure in the EU. Hetzner processes TLS-encrypted service traffic and stores ciphertext. Uploads and recordings also pass through its infrastructure before our upload service encrypts them for durable storage. Encryption reduces what Hetzner can read at rest but does not remove Hetzner's role as an infrastructure processor."
+            }
           }
         },
         ai_models: {
@@ -64490,7 +64556,7 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
               text: "TypeSafe Jev (via OpenRouter)"
             },
             description: {
-              text: "TypeSafe Jev receives bounded recent chat context and candidate metadata through OpenRouter to make internal routing, model-tier, skill, focus-mode, language, and safety decisions. It also checks external text for prompt injection. OpenMates does not send user identifiers, and Jev returns typed decisions rather than generated chat text."
+              text: "TypeSafe Jev receives bounded recent chat context and candidate metadata through OpenRouter to make internal routing, model-tier, skill, focus-mode, language, and safety decisions. It also checks external text for prompt injection. For optional search relevance ranking, it receives the stated relevance criteria, search parameters, and minimized candidate data from supported public searches. OpenMates does not send user identifiers, and Jev returns typed decisions rather than generated chat text."
             }
           },
           cerebras: {
@@ -64564,6 +64630,33 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "Z.ai provides GLM-family models. Z.ai receives your chat messages with PII placeholders already substituted client-side only when you select a Z.ai model."
             }
+          },
+          description_v2: {
+            text: "OpenMates routes requests to these providers according to the model or provider-powered feature you use. Eligible typed chat messages use client-side placeholder substitution. Recordings, raw transcripts, uploaded files, reference images, connected-account content, and structured skill inputs are not covered unless a feature explicitly says otherwise. Selectable models show their provider in AI settings."
+          },
+          mistral_v2: {
+            heading: {
+              text: "Mistral AI"
+            },
+            description: {
+              text: "Mistral processes eligible chat messages when you select a Mistral model and processes realtime or uploaded voice audio when you use audio transcription. Voice audio can contain personal or sensitive information and does not receive typed-message placeholder substitution. Mistral states that ordinary API inputs and outputs may be retained for 30 rolling days for abuse monitoring unless zero-data retention is activated; OpenMates does not promise zero-data retention for this path."
+            }
+          },
+          openai_v2: {
+            heading: {
+              text: "OpenAI"
+            },
+            description: {
+              text: "OpenAI processes eligible chat messages when you select a GPT-family model. It also receives image prompts, generation settings, and any reference images when you select GPT Image for generation or editing. Reference images are not covered by typed-message placeholder substitution."
+            }
+          },
+          google_gemini_v2: {
+            heading: {
+              text: "Google Gemini"
+            },
+            description: {
+              text: "Google's Gemini API processes eligible chat messages when you select a Gemini model. Gemini is also used to correct raw Mistral voice transcripts and create titles, and may process prompts, reference images, screenshots, or generated code for image generation or editing, Veo video generation, and screenshot-to-HTML conversion. These non-chat inputs do not receive typed-message placeholder substitution. Google's paid Gemini API terms say prompts and outputs are not used to improve its products, while its current abuse-monitoring documentation states that logged prompts, context, and outputs may be retained for 55 days."
+            }
           }
         },
         image_generation: {
@@ -64732,6 +64825,14 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "YouTube is queried when you ask OpenMates to retrieve a transcript for a YouTube video. YouTube receives video URLs and requested transcript language preferences without an OpenMates user identifier."
             }
+          },
+          google_lens: {
+            heading: {
+              text: "Google Lens"
+            },
+            description: {
+              text: "When you request reverse-image search, SerpAPI brokers the request to Google Lens. SerpAPI and Google receive a short-lived public URL to a decrypted copy of the selected image and any optional text refinement. The URL expires, and no OpenMates user identifier is included."
+            }
           }
         },
         travel: {
@@ -64772,6 +64873,22 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "Flix provides intercity bus and rail connection results when you search for FlixBus or FlixTrain routes. Flix receives origin, destination, and date search details without an OpenMates user identifier."
             }
+          },
+          serpapi_v2: {
+            heading: {
+              text: "SerpAPI"
+            },
+            description: {
+              text: "SerpAPI powers flight, hotel, Google Events, Amazon product, and Google Lens reverse-image searches. It receives the relevant query and localization filters without an OpenMates user identifier. Reverse-image search also sends a short-lived URL to a decrypted copy of the selected image and any optional refinement query."
+            }
+          },
+          transitous: {
+            heading: {
+              text: "Transitous"
+            },
+            description: {
+              text: "Transitous receives origin and destination stations or locations, travel date and time, transport modes, and route options for supported European public-transport routing. Requests are server-side without an OpenMates user identifier. Transitous states that request URLs and server request metadata are retained for up to two days."
+            }
           }
         },
         events: {
@@ -64804,6 +64921,30 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "Resident Advisor powers event search for electronic music events. RA receives your search queries without a user identifier."
             }
+          },
+          eventbrite: {
+            heading: {
+              text: "Eventbrite"
+            },
+            description: {
+              text: "Eventbrite receives the event query, city, category, dates, and requested result count for public event search and page retrieval. Requests are sent server-side without an OpenMates user identifier."
+            }
+          },
+          siegessaeule: {
+            heading: {
+              text: "Siegess\xE4ule"
+            },
+            description: {
+              text: "Siegess\xE4ule receives the date range and, when applicable, a matching event section or category for Berlin LGBTQ+ event listings. Requests are routed through Webshare without an OpenMates user identifier; unmatched free-text filtering happens locally."
+            }
+          },
+          berlin_philharmonic: {
+            heading: {
+              text: "Berliner Philharmoniker"
+            },
+            description: {
+              text: "Berliner Philharmoniker receives the concert query, date filters, tags, and requested result count when you search its public calendar. Requests are sent server-side without an OpenMates user identifier."
+            }
           }
         },
         health: {
@@ -64852,6 +64993,14 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
             description: {
               text: "Amazon's product catalogue is queried for live product and price data. Amazon receives your search queries without a user identifier."
             }
+          },
+          stoffe: {
+            heading: {
+              text: "Stoffe.de"
+            },
+            description: {
+              text: "Stoffe.de receives the product query, category, sorting, pagination, and compatible shipping-country filters for fabric, sewing-supply, and pattern searches. Requests are sent server-side without an OpenMates user identifier."
+            }
           }
         },
         nutrition: {
@@ -64984,6 +65133,78 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
               text: "Mastodon is queried when you fetch public Mastodon profile posts. The relevant Mastodon server receives profile identifiers or public profile URLs without an OpenMates user identifier."
             }
           }
+        },
+        model_generation_v2: {
+          heading: {
+            text: "3D model search and generation"
+          },
+          description: {
+            text: "These providers are used only when you search the public 3D model catalog or invoke a 3D model generation skill."
+          },
+          printables: {
+            heading: {
+              text: "Printables by Prusa Research"
+            },
+            description: {
+              text: "Printables receives the 3D model search query and requested result limit when you search its public catalog. The request is sent server-side without an OpenMates user identifier."
+            }
+          }
+        },
+        connected_services: {
+          heading: {
+            text: "Connected services"
+          },
+          description: {
+            text: "These providers are used only after you connect an external account and authorize access. OpenMates requests the scopes needed for the action and stores durable credential material encrypted."
+          },
+          google_calendar: {
+            heading: {
+              text: "Google Calendar"
+            },
+            description: {
+              text: "After you connect Google Calendar, OpenMates exchanges the OAuth authorization code and stores refresh or access tokens encrypted. Authorized actions may access calendar IDs, names, time zones, event IDs, titles, descriptions, locations, dates, and attendee email addresses. OpenMates reads, creates, updates, or deletes only within the scopes and action you authorize."
+            }
+          }
+        },
+        business_data: {
+          heading: {
+            text: "Public company data"
+          },
+          description: {
+            text: "This provider is used only when you explicitly request public company financial information."
+          },
+          sec_edgar: {
+            heading: {
+              text: "SEC EDGAR"
+            },
+            description: {
+              text: "The SEC receives the explicit company name, ticker, or CIK and the filing or period fields needed for a public-company lookup. Requests are sent server-side without an OpenMates user identifier."
+            }
+          }
+        },
+        weather: {
+          heading: {
+            text: "Weather services"
+          },
+          description: {
+            text: "A named place is first geocoded by Open-Meteo. Germany forecasts then use Bright Sky's DWD-derived data; forecasts elsewhere use Open-Meteo. These services receive location and forecast parameters without an OpenMates user identifier."
+          },
+          open_meteo: {
+            heading: {
+              text: "Open-Meteo"
+            },
+            description: {
+              text: "Open-Meteo receives a place name and language for geocoding, and coordinates, date range, time zone, and requested weather fields for global forecasts outside the Germany-specific path. Requests exclude OpenMates user identifiers. Open-Meteo states that API logs may contain coordinates and are deleted after 90 days."
+            }
+          },
+          bright_sky: {
+            heading: {
+              text: "Bright Sky"
+            },
+            description: {
+              text: "Bright Sky receives coordinates, date range, time zone, radar radius, and requested weather fields for Germany forecasts and rain radar using public DWD-derived data. Requests exclude OpenMates user identifiers. Bright Sky does not publish a standalone privacy notice, so the link points to its official service documentation."
+            }
+          }
         }
       },
       title: {
@@ -65233,6 +65454,12 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
         },
         stability_logs: {
           text: "Stability Logs: To diagnose technical errors, anonymized browser console logs (error messages, component status, connection events) are collected from authenticated users and stored for up to 48 hours. If an error occurs, surrounding context is retained for up to 14 days. No message content, chat titles, names, email addresses, or other personally identifiable information is included. A random session identifier (generated per browser tab, not linked to your account) is used for log correlation. You can disable this at any time in Settings > Privacy > Stability Logs."
+        },
+        content_v2: {
+          text: "Content: Chat messages, prompts, attachments, reminders, voice recordings and transcripts, calendar content, and uploaded images or videos needed to provide the service. Structured chat fields are generally encrypted in the browser before sync. Uploads and recordings travel to our backend over TLS and are encrypted before durable object storage; they are not necessarily client-side encrypted before transmission. Anonymous free-usage chats stay on the user's device until signup and are uploaded only if promoted into account sync."
+        },
+        connected_accounts: {
+          text: "Connected accounts: If you connect an external account, we process the provider, granted scopes, encrypted credential material, and the data needed for each authorized action. For Google Calendar this can include calendar names, time zones, event titles, descriptions, locations, dates, attendee email addresses, and provider event IDs."
         }
       },
       data_retention: {
@@ -65526,6 +65753,22 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
           answer: {
             text: "If you have very high privacy requirements, consider the [self-hosting edition](https://github.com/glowingkitty/OpenMates/blob/dev/docs/self-hosting/setup.md) of OpenMates with local or offline AI models instead of third-party AI providers. This gives you more control over infrastructure, model choice, logs, backups, and provider exposure. It requires technical experience, ongoing maintenance, secure server administration, and enough hardware for useful local AI inference. Self-hosting does not automatically make everything private: you still need to secure the server, backups, secrets, network access, logs, and any external providers you enable."
           }
+        },
+        third_party_providers_v2: {
+          question: {
+            text: "Do third-party providers receive my content?"
+          },
+          answer: {
+            text: "Yes, when you choose a model or use a provider-powered feature, the content needed for that request may be sent to the provider. Eligible typed chat messages use client-side placeholder substitution for recognized personal details and secrets. Anything not detected may be sent as typed, and the protection does not cover voice recordings, raw transcripts, uploaded files, reference images, calendar content, or structured skill inputs unless a feature explicitly says otherwise."
+          }
+        },
+        voice_recordings: {
+          question: {
+            text: "What happens when I record audio?"
+          },
+          answer: {
+            text: "Audio travels over TLS through the OpenMates backend hosted by Hetzner and is sent to Mistral for transcription. Realtime audio is streamed; uploaded recordings are encrypted by our upload service before durable storage and decrypted only in server memory for transcription. The raw transcript is then sent to Google Gemini to correct obvious transcription errors and create a title. Audio and raw transcripts do not receive the placeholder substitution used for eligible typed chat messages. OpenMates stores recordings and transcripts as encrypted account content, but Mistral and Google may retain API request data under their own policies."
+          }
         }
       },
       protection: {
@@ -65699,6 +65942,22 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
           description: {
             text: "OpenMates is open source. Every promise above is backed by code you can read, tests you can run, and architecture documents you can audit in our public repository. Our privacy-promises registry links each claim to the exact files that enforce it."
           }
+        },
+        client_side_chat_encryption_v2: {
+          heading: {
+            text: "Structured chat data is encrypted before sync"
+          },
+          description: {
+            text: "Structured chat data, settings, and memories are encrypted in your browser with AES-256-GCM before sync, and the server stores ciphertext on disk, in caches, and in backups. Uploaded files and recordings instead travel to our backend over TLS and are encrypted by the upload service before durable storage. This is not end-to-end encryption; server-side tasks decrypt relevant content transiently in memory when needed to provide a requested feature."
+          }
+        },
+        pii_placeholder_substitution_v2: {
+          heading: {
+            text: "Recognized personal data is replaced in eligible typed chat"
+          },
+          description: {
+            text: "Before an eligible typed chat message is sent to an AI provider, your browser detects supported categories of personal data and secrets and replaces recognized values with placeholders. The substitution map is encrypted with your chat key. Detection can miss data, and this protection does not cover voice audio, raw transcripts, uploaded files, reference images, connected-account content, or structured skill inputs unless a feature explicitly says otherwise."
+          }
         }
       },
       limitations_of_erasure: {
@@ -65747,6 +66006,14 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
           description: {
             text: "Ciphertext backups of your own data exports live in S3 for 60 days via a lifecycle rule, so you can retrieve an export if your device is lost. Because we destroyed your encryption key when you deleted your account, we cannot decrypt these backups either \u2014 they are effectively inert ciphertext until they expire."
           }
+        },
+        third_party_ai_logs_v2: {
+          heading: {
+            text: "Logs retained by third-party AI providers"
+          },
+          description: {
+            text: "AI providers retain request logs under their own policies, independently of OpenMates, and we cannot delete data from their systems. Retention is provider-specific; for example, Mistral states 30 rolling days for ordinary API input and output unless zero-data retention is active, while Google's current Gemini abuse-monitoring documentation states 55 days for logged prompts, context, and outputs. Eligible typed chat uses client-side placeholder substitution, which reduces exposure but may miss data and does not cover voice audio, raw transcripts, uploaded or reference files, connected-account content, or structured skill inputs unless a feature explicitly says otherwise."
+          }
         }
       },
       training_policies: {
@@ -65777,6 +66044,9 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
         status_limited_use: {
           text: "Anonymized derivatives may be used"
         }
+      },
+      provider_link_label_v2: {
+        text: "Provider privacy or legal information"
       }
     },
     terms: {

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   serializeToYaml,
   shouldRequireTrustedAccountGuard,
   waitForWorkflowRun
-} from "./chunk-QVKOXAEV.js";
+} from "./chunk-WDFC7XBM.js";
 import "./chunk-IWKP55ZB.js";
 import "./chunk-BBKJZ23O.js";
 export {

package/dist/index.d.ts

@@ -395,7 +395,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "code";
     readonly skill_method_py: "run";
     readonly description_key: "app_skills.code.run.description";
-    readonly description: "Run code in an isolated E2B sandbox. When running code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_id from a filename. Use target_embed_id only for an existing chat code embed. Ask the user before running unmodified user-supplied code or after the initial run plus two unprompted reruns. The sandbox installs supported dependency manifests, executes the selected file, streams terminal status, and returns safe artif";
+    readonly description: "Run code in an isolated E2B sandbox or propose an exact command for the currently focused remote Project source. Remote execution requires an explicit one-run approval or an exact currently enabled command preset; never infer approval from Project write mode, chat text, or prior runs. Pass remote commands as argv, never as a composed shell string. When running E2B code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -926,6 +926,11 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly maximum: 50;
                             readonly default: 10;
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional concise natural-language event-selection purpose used for relevance ranking. Include it whenever the user states a material goal such as networking, promoting a product, finding potential users, or future speaking opportunities; omit it for a plain event search and never invent preferences. When present, the skill ranks a bounded pool of up to 40 candidates (or the larger requested count) and still returns only count events.\n";
+                        };
                         readonly provider: {
                             readonly type: "string";
                             readonly description: "Provider for this request. Overrides the top-level provider when set.";
@@ -1166,7 +1171,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "fitness";
     readonly skill_method_py: "search_locations";
     readonly description_key: "fitness.search_locations.description";
-    readonly description: "Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches.";
+    readonly description: "Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches. When the user states a material purpose or preference that should change venue ordering, include a concise, faithful relevance_criteria value. Keep city, radius, plan, and category constraints structured. A plain venue search may omit it; never";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -1200,7 +1205,15 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly type: "string";
                         };
                         readonly limit: {
-                            readonly type: "number";
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 50;
+                            readonly default: 10;
+                        };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language activity goal used only to rank matching fitness locations. Omit for distance-first provider ordering; structured city, radius, plan, and category filters remain authoritative.";
                         };
                     };
                 };
@@ -1216,7 +1229,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "fitness";
     readonly skill_method_py: "search_classes";
     readonly description_key: "fitness.search_classes.description";
-    readonly description: "Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max.";
+    readonly description: "Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max. When the user states a material purpose or preference that should change class ordering, include a concise, faithful relevance_criteria value. Keep date, location, radius, plan, attendance mode, min";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -1268,7 +1281,15 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly type: "string";
                         };
                         readonly limit: {
-                            readonly type: "number";
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 50;
+                            readonly default: 10;
+                        };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language activity goal used only to rank matching fitness classes. Omit for chronological provider ordering; structured date, location, radius, plan, attendance, spots, category, and venue filters remain authoritative.";
                         };
                     };
                 };
@@ -1368,7 +1389,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "home";
     readonly skill_method_py: "search";
     readonly description_key: "app_skills.home.search.description";
-    readonly description: "Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany.";
+    readonly description: "Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany. When the user states a material preference not fully captured by the structured price, room, size, property-type, or sort fields, include a concise, faithful relevance_criteria value without waiting for the user to";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -1423,6 +1444,11 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly minimum: 0;
                             readonly description: "Minimum advertised area in square metres. Unknown area is excluded when set.";
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional concise natural-language housing preference for relevance ranking. Include it when the user states a material preference not fully represented by structured filters; omit it for a plain search. Rank only explicit listing facts and never infer unstated amenities, commute, lease, accessibility, or neighborhood qualities. The internal candidate pool is bounded and only max_results listings are returned.\n";
+                        };
                         readonly max_results: {
                             readonly type: "integer";
                             readonly description: "Maximum number of listings to return (1-20, default 10).";
@@ -1804,13 +1830,13 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "maps";
     readonly skill_method_py: "search";
     readonly description_key: "maps.search.description";
-    readonly description: "Search for places, businesses, restaurants, directions, locations.";
+    readonly description: "Search for places, businesses, restaurants, directions, and locations. When the user's request states a material purpose or preference that should change which matching places rank first, include a concise, faithful relevance_criteria value without waiting for the user to name the field. Keep location, place type, rating, open-now, price, and required amenity constraints in their structured fields. A plain place search may omit relevance_criteria; never invent quietness, ambience, accessibility,";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
             readonly requests: {
                 readonly type: "array";
-                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"restaurants in Berlin\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"restaurants in Berlin\"}, {\"query\": \"museums in Berlin\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (pageSize, languageCode, locationBias, includedType, minRating, openNow, includeReviews).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
+                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"restaurants in Berlin\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"restaurants in Berlin\"}, {\"query\": \"museums in Berlin\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (pageSize, relevance_criteria, languageCode, locationBias, includedType, minRating, openNow, includeReviews).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
                 readonly items: {
                     readonly type: "object";
                     readonly properties: {
@@ -1825,6 +1851,11 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly maximum: 20;
                             readonly default: 10;
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language goal used only to rank matching place candidates. Omit for ordinary provider ordering; structured place, rating, open-now, price, location, and amenity filters remain authoritative.";
+                        };
                         readonly languageCode: {
                             readonly type: "string";
                             readonly description: "Language code for results (ISO 639-1, e.g., 'en', 'es', 'fr', 'de'). Defaults to 'en' if not specified.";
@@ -2119,13 +2150,13 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "news";
     readonly skill_method_py: "search";
     readonly description_key: "news.search.description";
-    readonly description: "Search for news articles, current events, headlines, announcements.";
+    readonly description: "Search for news articles, current events, headlines, and announcements. When the user states a material purpose or preference that should change which coverage is most useful, include a concise, faithful relevance_criteria value. Do not wait for the user to name the field, but omit it for a plain news search and never invent preferences.";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
             readonly requests: {
                 readonly type: "array";
-                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"iPhone news\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"iPhone news\"}, {\"query\": \"MacBook news\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch, freshness).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
+                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"iPhone news\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"iPhone news\"}, {\"query\": \"MacBook news\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch, freshness).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
                 readonly items: {
                     readonly type: "object";
                     readonly properties: {
@@ -2135,10 +2166,15 @@ declare const APP_SKILL_METADATA: readonly [{
                         };
                         readonly count: {
                             readonly type: "integer";
-                            readonly description: "Number of results for this request (max 20)";
+                            readonly description: "Number of final results for this request (default 10, max 20).";
                             readonly minimum: 1;
                             readonly maximum: 20;
-                            readonly default: 6;
+                            readonly default: 10;
+                        };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional concise natural-language purpose or preference for relevance ranking. Include it when the user states a material goal that should change ordering; omit it for a plain search and never invent preferences. When present, the skill ranks up to 40 candidates and still returns only count results.\n";
                         };
                         readonly country: {
                             readonly type: "string";
@@ -2784,7 +2820,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "shopping";
     readonly skill_method_py: "search_products";
     readonly description_key: "app_skills.shopping.search_products.description";
-    readonly description: "Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected.";
+    readonly description: "Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected. When the user states a material use case or preference that should change product ordering, include a concise, faithful relevance_criteria value. Keep provider, category, country, department, price, fulfilment, and sort constraints structured. A plain product";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -2811,8 +2847,15 @@ declare const APP_SKILL_METADATA: readonly [{
                         readonly max_results: {
                             readonly type: "integer";
                             readonly description: "Maximum number of products to return (1-20, default 10).";
+                            readonly minimum: 1;
+                            readonly maximum: 20;
                             readonly default: 10;
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language purchase goal used only to rank matching product candidates. Omit for ordinary provider ordering; structured provider, category, price, country, department, fulfilment, and sort fields remain authoritative.";
+                        };
                         readonly sort: {
                             readonly type: "string";
                             readonly description: "Sort order for results. REWE supports: relevance, price_asc, price_desc, new. Amazon supports: relevance, price_asc, price_desc, review_rank, newest, best_sellers. Stoffe.de supports: relevance, price_asc, price_desc, new.\n";
@@ -3346,7 +3389,7 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "travel";
     readonly skill_method_py: "search_stays";
     readonly description_key: "app_skills.travel.search_stays.description";
-    readonly description: "Run this OpenMates app skill.";
+    readonly description: "Search hotels, hostels, and other stays for explicit dates and party size. When the user states a material stay purpose or preference that should change which valid properties rank first, include a concise, faithful relevance_criteria value. Keep dates, guests, currency, price, hotel class, rating, free cancellation, and sort constraints in their structured fields. A plain stay search may omit relevance_criteria; never invent budget, amenities, neighborhood, quietness, accessibility, workspace,";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
@@ -3405,6 +3448,11 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly description: "Maximum number of results to return.";
                             readonly default: 10;
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language stay goal used only to rank matching first-page properties. Omit for ordinary provider ordering; structured date, party-size, price, class, rating, cancellation, and sort filters remain authoritative.";
+                        };
                     };
                     readonly required: readonly ["query", "check_in_date", "check_out_date"];
                 };
@@ -3564,13 +3612,13 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "videos";
     readonly skill_method_py: "search";
     readonly description_key: "videos.search.description";
-    readonly description: "Search for videos, documentaries, tutorials, clips on the web.";
+    readonly description: "Search for videos, documentaries, tutorials, and clips on the web. When the user states a material viewing purpose or preference that should change ordering, such as audience level, desired depth, format, duration, authority, or freshness, include a concise, faithful relevance_criteria value. Keep country, language, safe-search, freshness, and count constraints structured. A plain video search may omit relevance_criteria; never invent experience level, recency, duration, creator, popularity, or";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
             readonly requests: {
                 readonly type: "array";
-                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"Python tutorial\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"Python tutorial\"}, {\"query\": \"FastAPI tutorial\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
+                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"Python tutorial\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"Python tutorial\"}, {\"query\": \"FastAPI tutorial\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch, freshness).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
                 readonly items: {
                     readonly type: "object";
                     readonly properties: {
@@ -3585,6 +3633,11 @@ declare const APP_SKILL_METADATA: readonly [{
                             readonly maximum: 20;
                             readonly default: 6;
                         };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional natural-language viewing or learning goal used only to rank matching video candidates. Omit for ordinary popularity ordering; structured country, language, safe-search, freshness, and count fields remain authoritative.";
+                        };
                         readonly country: {
                             readonly type: "string";
                             readonly description: "Country code for localized results. Must be one of: AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, or ALL (case-insensitive). Defaults to 'us' if invalid.";
@@ -4082,13 +4135,13 @@ declare const APP_SKILL_METADATA: readonly [{
     readonly app_namespace_py: "web";
     readonly skill_method_py: "search";
     readonly description_key: "app_skills.web.search.description";
-    readonly description: "General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies.";
+    readonly description: "General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies. When the user states a material purpose or preference that should change which results are most useful, include a concise, faithful relevance_criteria value (for example, research suitable for a purchase decision). Do not wait for the user to name the field, but omit it for a plain search and never invent preferences.";
     readonly schema: {
         readonly type: "object";
         readonly properties: {
             readonly requests: {
                 readonly type: "array";
-                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"Python async\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"Python async\"}, {\"query\": \"FastAPI best practices\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, country, search_lang, safesearch).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
+                readonly description: "REQUIRED: Array of search request objects for parallel processing (up to 5 requests). \nThis parameter is MANDATORY - you MUST always provide a 'requests' array, even for a single search.\nExample for single search: {\"requests\": [{\"query\": \"Python async\"}]}\nExample for multiple searches: {\"requests\": [{\"query\": \"Python async\"}, {\"query\": \"FastAPI best practices\"}]}\nEach object must contain 'query' (search query string), and can include optional parameters (count, relevance_criteria, country, search_lang, safesearch).\nNote: The 'id' field is auto-generated if not provided - you don't need to include it.\n";
                 readonly items: {
                     readonly type: "object";
                     readonly properties: {
@@ -4098,10 +4151,15 @@ declare const APP_SKILL_METADATA: readonly [{
                         };
                         readonly count: {
                             readonly type: "integer";
-                            readonly description: "Number of results for this request (max 20)";
+                            readonly description: "Number of final results for this request (default 10, max 20).";
                             readonly minimum: 1;
                             readonly maximum: 20;
-                            readonly default: 6;
+                            readonly default: 10;
+                        };
+                        readonly relevance_criteria: {
+                            readonly type: "string";
+                            readonly maxLength: 1000;
+                            readonly description: "Optional concise natural-language purpose or preference for relevance ranking. Include it when the user states a material goal that should change ordering; omit it for a plain search and never invent preferences. When present, the skill ranks up to 40 candidates and still returns only count results.\n";
                         };
                         readonly country: {
                             readonly type: "string";
@@ -4335,7 +4393,7 @@ declare class CodeAppSkills {
      */
     removeSecrets<T = unknown>(input: SkillInput, options?: AppSkillRunOptions): Promise<T>;
     /**
-     * Run code in an isolated E2B sandbox. When running code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_id from a filename. Use target_embed_id only for an existing chat code embed. Ask the user before running unmodified user-supplied code or after the initial run plus two unprompted reruns. The sandbox installs supported dependency manifests, executes the selected file, streams terminal status, and returns safe artif
+     * Run code in an isolated E2B sandbox or propose an exact command for the currently focused remote Project source. Remote execution requires an explicit one-run approval or an exact currently enabled command preset; never infer approval from Project write mode, chat text, or prior runs. Pass remote commands as argv, never as a composed shell string. When running E2B code the assistant is creating in this same turn, pass the source through files[].code plus entry_path; do not invent a target_embed_
      * Description key: app_skills.code.run.description
      * Skill: code/run
      */
@@ -4381,13 +4439,13 @@ declare class FitnessAppSkills {
     private readonly runSkill;
     constructor(runSkill: AppSkillRunner);
     /**
-     * Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max.
+     * Search available Urban Sports Club public fitness classes. Use this when the user asks for dated fitness classes, course availability, free spots, on-site classes, online classes, or plan-filtered Urban Sports classes. Omit plan unless the user explicitly asks for Essential, Classic, Premium, or Max. When the user states a material purpose or preference that should change class ordering, include a concise, faithful relevance_criteria value. Keep date, location, radius, plan, attendance mode, min
      * Description key: fitness.search_classes.description
      * Skill: fitness/search_classes
      */
     searchClasses<T = unknown>(input: SkillInput, options?: AppSkillRunOptions): Promise<T>;
     /**
-     * Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches.
+     * Search Urban Sports Club public fitness locations. Use this when the user asks for gyms, studios, pools, or Urban Sports locations near a city, address, or radius. Do not use it for class availability; use fitness.search_classes for dated class searches. When the user states a material purpose or preference that should change venue ordering, include a concise, faithful relevance_criteria value. Keep city, radius, plan, and category constraints structured. A plain venue search may omit it; never
      * Description key: fitness.search_locations.description
      * Skill: fitness/search_locations
      */
@@ -4413,7 +4471,7 @@ declare class HomeAppSkills {
     private readonly runSkill;
     constructor(runSkill: AppSkillRunner);
     /**
-     * Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany.
+     * Search for apartments, houses, and WG rooms in German cities. Searches ImmoScout24, Kleinanzeigen, and WG-Gesucht simultaneously. Returns listings with prices, sizes, rooms, addresses, and direct links. Costs 10 credits per search. Use when user asks about finding housing in Germany. When the user states a material preference not fully captured by the structured price, room, size, property-type, or sort fields, include a concise, faithful relevance_criteria value without waiting for the user to
      * Description key: app_skills.home.search.description
      * Skill: home/search
      */
@@ -4449,7 +4507,7 @@ declare class MapsAppSkills {
     private readonly runSkill;
     constructor(runSkill: AppSkillRunner);
     /**
-     * Search for places, businesses, restaurants, directions, locations.
+     * Search for places, businesses, restaurants, directions, and locations. When the user's request states a material purpose or preference that should change which matching places rank first, include a concise, faithful relevance_criteria value without waiting for the user to name the field. Keep location, place type, rating, open-now, price, and required amenity constraints in their structured fields. A plain place search may omit relevance_criteria; never invent quietness, ambience, accessibility,
      * Description key: maps.search.description
      * Skill: maps/search
      */
@@ -4489,7 +4547,7 @@ declare class NewsAppSkills {
     private readonly runSkill;
     constructor(runSkill: AppSkillRunner);
     /**
-     * Search for news articles, current events, headlines, announcements.
+     * Search for news articles, current events, headlines, and announcements. When the user states a material purpose or preference that should change which coverage is most useful, include a concise, faithful relevance_criteria value. Do not wait for the user to name the field, but omit it for a plain news search and never invent preferences.
      * Description key: news.search.description
      * Skill: news/search
      */
@@ -4601,7 +4659,7 @@ declare class ShoppingAppSkills {
     private readonly runSkill;
     constructor(runSkill: AppSkillRunner);
     /**
-     * Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected.
+     * Search products on REWE, Amazon, or Stoffe.de with real-time prices. Use category to route groceries, marketplace products, fabrics, sewing supplies, and patterns to compatible providers. Invalid provider/category combinations are rejected. When the user states a material use case or preference that should change product ordering, include a concise, faithful relevance_criteria value. Keep provider, category, country, department, price, fulfilment, and sort constraints structured. A plain product
      * Description key: app_skills.shopping.search_products.description
      * Skill: shopping/search_products
      */
@@ -4655,7 +4713,7 @@ declare class TravelAppSkills {
      */
     searchConnections<T = unknown>(input: SkillInput, options?: AppSkillRunOptions): Promise<T>;
     /**
-     * Run this OpenMates app skill.
+     * Search hotels, hostels, and other stays for explicit dates and party size. When the user states a material stay purpose or preference that should change which valid properties rank first, include a concise, faithful relevance_criteria value. Keep dates, guests, currency, price, hotel class, rating, free cancellation, and sort constraints in their structured fields. A plain stay search may omit relevance_criteria; never invent budget, amenities, neighborhood, quietness, accessibility, workspace,
      * Description key: app_skills.travel.search_stays.description
      * Skill: travel/search_stays
      */
@@ -4683,7 +4741,7 @@ declare class VideosAppSkills {
      */
     getTranscript<T = unknown>(input: SkillInput, options?: AppSkillRunOptions): Promise<T>;
     /**
-     * Search for videos, documentaries, tutorials, clips on the web.
+     * Search for videos, documentaries, tutorials, and clips on the web. When the user states a material viewing purpose or preference that should change ordering, such as audience level, desired depth, format, duration, authority, or freshness, include a concise, faithful relevance_criteria value. Keep country, language, safe-search, freshness, and count constraints structured. A plain video search may omit relevance_criteria; never invent experience level, recency, duration, creator, popularity, or
      * Description key: videos.search.description
      * Skill: videos/search
      */
@@ -4715,7 +4773,7 @@ declare class WebAppSkills {
      */
     read<T = unknown>(input: SkillInput, options?: AppSkillRunOptions): Promise<T>;
     /**
-     * General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies.
+     * General web search for current information, prices, weather, facts, stocks, sports scores, etc. Use as a fallback when no specialized skill applies. When the user states a material purpose or preference that should change which results are most useful, include a concise, faithful relevance_criteria value (for example, research suitable for a purchase decision). Do not wait for the user to name the field, but omit it for a plain search and never invent preferences.
      * Description key: app_skills.web.search.description
      * Skill: web/search
      */

package/dist/index.js

@@ -42,7 +42,7 @@ import {
   selectAssistantMessagesForSpeech,
   serializeToYaml,
   summarizeAssistantSpeech
-} from "./chunk-QVKOXAEV.js";
+} from "./chunk-WDFC7XBM.js";
 import "./chunk-IWKP55ZB.js";
 import "./chunk-BBKJZ23O.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmates",
-  "version": "0.21.0-alpha.4",
+  "version": "0.21.0-alpha.6",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",