@riverintel/stayfinder-plugin 0.2.1 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/tools/search-stays.d.ts +1 -0
- package/dist/tools/search-stays.d.ts.map +1 -1
- package/dist/tools/search-stays.js +26 -3
- package/dist/tools/search-stays.js.map +1 -1
- package/dist/types.d.ts +4 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/skills/lodging-search/SKILL.md +29 -7
|
@@ -40,6 +40,7 @@ export declare const SearchStaysParamsSchema: import("@sinclair/typebox").TObjec
|
|
|
40
40
|
limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
|
|
41
41
|
intent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
|
|
42
42
|
hotel_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
|
|
43
|
+
radius_km: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
|
|
43
44
|
}>;
|
|
44
45
|
export declare function createSearchStaysTool(api: any): any;
|
|
45
46
|
//# sourceMappingURL=search-stays.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-stays.d.ts","sourceRoot":"","sources":["../../src/tools/search-stays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAeH,eAAO,MAAM,uBAAuB
|
|
1
|
+
{"version":3,"file":"search-stays.d.ts","sourceRoot":"","sources":["../../src/tools/search-stays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAeH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;EA0InC,CAAC;AA4BF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CA6EnD"}
|
|
@@ -79,12 +79,24 @@ export const SearchStaysParamsSchema = Type.Object({
|
|
|
79
79
|
Type.Literal('price_desc'),
|
|
80
80
|
Type.Literal('rating_desc'),
|
|
81
81
|
Type.Literal('distance'),
|
|
82
|
-
], {
|
|
82
|
+
], {
|
|
83
|
+
default: 'recommended',
|
|
84
|
+
description: "Sort order for results. Pick based on what the user has said:\n" +
|
|
85
|
+
"- 'recommended' (DEFAULT): adapter-chosen balance of price and value. " +
|
|
86
|
+
"Use this for generic queries with no explicit sort preference. When hotel_name is also set, the adapter " +
|
|
87
|
+
"internally substitutes a rating-based sort so chain flagships surface; you don't need to override.\n" +
|
|
88
|
+
"- 'price_asc': cheapest first. Use when the user said 'cheapest', 'budget', 'under $X', 'most affordable'.\n" +
|
|
89
|
+
"- 'price_desc': most expensive first. Use when the user said 'splurge', 'luxury', 'high-end', 'best available'.\n" +
|
|
90
|
+
"- 'rating_desc': highest guest rating first. Use when the user said 'best reviewed', 'highly rated', 'top-rated'.\n" +
|
|
91
|
+
"- 'distance': closest to the destination center first. Use when the user said 'central', 'downtown', 'closest', 'walking distance', 'near [landmark]'.\n" +
|
|
92
|
+
"Don't pick a non-default sort unless the user's words clearly signal it.",
|
|
93
|
+
})),
|
|
83
94
|
limit: Type.Optional(Type.Integer({
|
|
84
95
|
minimum: 1,
|
|
85
|
-
maximum:
|
|
96
|
+
maximum: 100,
|
|
86
97
|
default: 10,
|
|
87
|
-
description: 'Maximum number of results to return. Use
|
|
98
|
+
description: 'Maximum number of results to return. Use 10 (default) for generic destination searches. ' +
|
|
99
|
+
'When using hotel_name to find a specific property, use 50 to widen the candidate pool.',
|
|
88
100
|
})),
|
|
89
101
|
intent: Type.Optional(Type.String({
|
|
90
102
|
maxLength: 280,
|
|
@@ -103,6 +115,16 @@ export const SearchStaysParamsSchema = Type.Object({
|
|
|
103
115
|
'Can be combined with destination to narrow results within a city, or used alone. ' +
|
|
104
116
|
'Maps to a full-text search across hotel name, description, address, and amenities.',
|
|
105
117
|
})),
|
|
118
|
+
radius_km: Type.Optional(Type.Integer({
|
|
119
|
+
minimum: 1,
|
|
120
|
+
maximum: 200,
|
|
121
|
+
default: 12,
|
|
122
|
+
description: 'Search radius in kilometers around the destination. Default is 12km, which covers a typical city center. ' +
|
|
123
|
+
'Use a smaller radius (5-8km) for specific neighborhoods or "walking distance" queries. ' +
|
|
124
|
+
'Use a larger radius (25-50km) for broad metro-area searches, rural destinations, or when the user ' +
|
|
125
|
+
'asks to "expand the search" after getting too few results. ' +
|
|
126
|
+
'If a search returns zero results, try widening the radius before giving up.',
|
|
127
|
+
})),
|
|
106
128
|
}, { additionalProperties: false });
|
|
107
129
|
const TOOL_DESCRIPTION = 'Search live hotel and vacation rental inventory with real-time pricing, ' +
|
|
108
130
|
'availability, and booking redirect links. Returns up to 25 properties with ' +
|
|
@@ -153,6 +175,7 @@ export function createSearchStaysTool(api) {
|
|
|
153
175
|
...(rawParams.limit && { limit: rawParams.limit }),
|
|
154
176
|
...(rawParams.intent && { intent: rawParams.intent }),
|
|
155
177
|
...(rawParams.hotel_name && { hotel_name: rawParams.hotel_name }),
|
|
178
|
+
...(rawParams.radius_km && { radius: { value: rawParams.radius_km, unit: 'km' } }),
|
|
156
179
|
...(config.default_pos_country && { pos_country: config.default_pos_country }),
|
|
157
180
|
...(config.default_currency && { currency: config.default_currency }),
|
|
158
181
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-stays.js","sourceRoot":"","sources":["../../src/tools/search-stays.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"search-stays.js","sourceRoot":"","sources":["../../src/tools/search-stays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAChD;IACE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;QACvB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,WAAW,EACT,oGAAoG;YACpG,gDAAgD;KACnD,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EACT,uFAAuF;KAC1F,CAAC;IACF,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EACT,6FAA6F;KAChG,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;QACnB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,yBAAyB;KACvC,CAAC;IACF,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE;QACpD,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,WAAW,EACT,6EAA6E;KAChF,CAAC,CACH;IACD,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,KAAK,CACR;QACE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KACpB,EACD;QACE,OAAO,EAAE,KAAK;QACd,WAAW,EACT,yEAAyE;KAC5E,CACF,CACF;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CACT;QACE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3C,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAChD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CACxC;QACD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CACxC;QACD,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;KACtD,EACD;QACE,WAAW,EACT,+FAA+F;KAClG,CACF,CACF;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CACR;QACE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;KACzB,EACD;QACE,OAAO,EAAE,aAAa;QACtB,WAAW,EACT,iEAAiE;YACjE,wEAAwE;YACxE,0GAA0G;YAC1G,sGAAsG;YACtG,8GAA8G;YAC9G,mHAAmH;YACnH,qHAAqH;YACrH,0JAA0J;YAC1J,0EAA0E;KAC7E,CACF,CACF;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,OAAO,CAAC;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,EAAE;QACX,WAAW,EACT,0FAA0F;YAC1F,wFAAwF;KAC3F,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,SAAS,EAAE,GAAG;QACd,WAAW,EACT,kFAAkF;YAClF,iFAAiF;YACjF,yFAAyF;YACzF,sFAAsF;YACtF,iFAAiF;YACjF,yFAAyF;KAC5F,CAAC,CACH;IACD,UAAU,EAAE,IAAI,CAAC,QAAQ,CACvB,IAAI,CAAC,MAAM,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,WAAW,EACT,yFAAyF;YACzF,6FAA6F;YAC7F,mFAAmF;YACnF,oFAAoF;KACvF,CAAC,CACH;IACD,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,OAAO,CAAC;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,EAAE;QACX,WAAW,EACT,2GAA2G;YAC3G,yFAAyF;YACzF,oGAAoG;YACpG,6DAA6D;YAC7D,6EAA6E;KAChF,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,gBAAgB,GACpB,0EAA0E;IAC1E,6EAA6E;IAC7E,kEAAkE;IAClE,iFAAiF;IACjF,yDAAyD;IACzD,iFAAiF;IACjF,+EAA+E;IAC/E,2EAA2E;IAC3E,6FAA6F;IAC7F,iGAAiG;IACjG,yEAAyE;IACzE,+DAA+D,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,GACd,WAAW;IACX,2EAA2E;IAC3E,+EAA+E;IAC/E,gBAAgB,CAAC;AAEnB,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CAAC,GAAQ;IAC5C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE,uBAAuB;QACnC,8DAA8D;QAC9D,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,SAAc,EAAE,EAAE;YACrD,+BAA+B;YAE/B,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CACjC,IAAI,YAAY,CACd,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,qCAAqC,EAAE,EAAE,EACnF,GAAG,CACJ,CACF,CAAC,CAAC;YACL,CAAC;YAED,iCAAiC;YAEjC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAClD,MAAM,IAAI,GAAuB;gBAC/B,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,GAAG,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC;gBAC1E,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC;gBACvE,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;gBACxD,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC/C,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;gBAClD,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrD,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;gBACjE,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,IAAa,EAAE,EAAE,CAAC;gBAC3F,GAAG,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBAC9E,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC;aACtE,CAAC;YAEF,kCAAkC;YAElC,MAAM,eAAe,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,eAAe;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YAEtD,+BAA+B;YAE/B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;gBAC/B,MAAM;gBACN,QAAQ,EAAE,UAAU,CAAC,SAAS;gBAC9B,aAAa,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO;aACtC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,8DAA8D;YAE9D,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACxC,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;oBAC3B,QAAQ,CAAC,aAAa,GAAG,mBAAmB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YAED,4CAA4C;YAE5C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/C,OAAO,cAAc,CAAC,IAAI,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}
|
package/dist/types.d.ts
CHANGED
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,8BAA8B;AAC9B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAM7B,MAAM,WAAW,sBAAsB;IACrC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAMD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAC9D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,WAAW,GACX,YAAY,GACZ,aAAa,GACb,UAAU,CAAC;AAEf,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@riverintel/stayfinder-plugin",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"description": "OpenClaw plugin for live hotel and vacation rental search via the StayFinder service. Returns real-time pricing, availability, and Expedia booking redirect links — no scraping, no browser automation.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -79,20 +79,42 @@ Triggers include:
|
|
|
79
79
|
|
|
80
80
|
2. **Ask for missing required fields** before calling the tool. Don't guess dates. Don't assume party size. A typical follow-up: *"What dates are you looking at, and how many guests?"*
|
|
81
81
|
|
|
82
|
-
3. **Set `hotel_name`** when the user asks about a specific property by name — e.g., "Is the Four Seasons available?", "Find me a Hilton in Seattle." This searches across hotel name, description, address, and amenities. It can be combined with `destination` to narrow results within a city, or used alone. Do NOT put the hotel name in the `destination` field — that's for locations only.
|
|
82
|
+
3. **Set `hotel_name`** when the user asks about a specific property by name — e.g., "Is the Four Seasons available?", "Find me a Hilton in Seattle." This searches across hotel name, description, address, and amenities. It can be combined with `destination` to narrow results within a city, or used alone. Do NOT put the hotel name in the `destination` field — that's for locations only. When you set `hotel_name`, also pass `limit: 50` — see the limit guidance below.
|
|
83
83
|
|
|
84
|
-
4. **Set
|
|
84
|
+
4. **Set `limit` based on query type:**
|
|
85
|
+
- **Default (10)** for typical destination queries ("hotels in Seattle, May 15-17"). The agent surfaces 3-5 cards regardless of how many candidates come back; 10 is plenty for that.
|
|
86
|
+
- **`limit: 50`** when `hotel_name` is set or the user is searching by property name. The specific property often doesn't rank in the top 10 by the default sort; a wider candidate pool makes it much more likely the property surfaces.
|
|
87
|
+
- **`limit: 100`** only for very broad surveys ("show me every Marriott in Manhattan"). Each result costs ~500-1000 tokens of context; don't ask for 100 unless you'll use it.
|
|
85
88
|
|
|
86
|
-
5. **
|
|
89
|
+
5. **Set `sort` only when the user's words clearly signal a preference:**
|
|
90
|
+
- **Don't pass `sort`** for most queries — the default (`recommended`) is correct.
|
|
91
|
+
- **`sort: 'price_asc'`** when the user said "cheapest," "budget," "under $X," "most affordable."
|
|
92
|
+
- **`sort: 'price_desc'`** when the user said "splurge," "luxury," "high-end," "best available."
|
|
93
|
+
- **`sort: 'rating_desc'`** when the user said "best reviewed," "highly rated," "top-rated."
|
|
94
|
+
- **`sort: 'distance'`** when the user said "central," "downtown," "closest," "walking distance," "near [landmark]."
|
|
87
95
|
|
|
88
|
-
|
|
96
|
+
Special interaction with `hotel_name`: when `hotel_name` is set and you don't pass `sort`, the adapter automatically prefers a rating-based sort internally (chain flagships rank higher by guest rating than by deals). You don't need to override `sort` yourself in that case. If the user explicitly said "cheapest Hyatt," pass `sort: 'price_asc'` and the adapter respects your choice.
|
|
97
|
+
|
|
98
|
+
6. **Use `radius_km` to control how far from the destination center to search.** The default is 12km, which covers a typical city center.
|
|
99
|
+
- **5-8km** for specific neighborhoods or "walking distance" queries (e.g., "hotels in downtown Bellevue," "near Pike Place Market").
|
|
100
|
+
- **12km (default)** for city-level queries (e.g., "hotels in Bellevue," "hotels in Seattle").
|
|
101
|
+
- **25-50km** for broad metro-area searches, rural destinations, or resort areas with spread-out inventory (e.g., "hotels near Yellowstone," "anywhere in the Seattle metro").
|
|
102
|
+
- If a search returns too few results, **widen the radius** and search again before giving up — tell the user you're expanding the search area.
|
|
103
|
+
- If results include properties far from where the user expects, **narrow the radius** and search again.
|
|
104
|
+
|
|
105
|
+
7. **Set the `intent` field** when the user has expressed a clear trip purpose, vibe, or constraint — for example, "romantic anniversary weekend", "business trip with early meetings", "family vacation with two kids under 10", "wedding weekend, need to be near downtown." Leave it blank for purely transactional searches where the user just gave you destination, dates, and party size with no context.
|
|
106
|
+
|
|
107
|
+
8. **Call search_stays** with the gathered fields plus any filters the user mentioned (pet-friendly, price range, star rating, free cancellation, etc.).
|
|
108
|
+
|
|
109
|
+
9. **If the search returns zero results**, try these before giving up:
|
|
110
|
+
- **Widen the radius** — try `radius_km: 25` or `radius_km: 50` and tell the user you're expanding the search area
|
|
89
111
|
- Use a more specific destination (e.g., "Kihei, Maui" instead of "Maui") — the service resolves free-text destinations and specific town names work better than broad region names
|
|
90
112
|
- For vacation rentals in resort/rural areas, the inventory may be spread across a wider area than city hotels — some destinations just have limited coverage
|
|
91
113
|
- Tell the user honestly if nothing came back and suggest a nearby alternative or different dates
|
|
92
114
|
|
|
93
|
-
|
|
115
|
+
10. **Present 3-5 top options** to the user, not all 25. Focus on price, location, and the most distinctive feature. Include the redirect_link for each so the user can book.
|
|
94
116
|
|
|
95
|
-
|
|
117
|
+
11. **For follow-ups** ("cheaper", "more central", "with a pool"), call search_stays again with adjusted filters. Don't try to filter the previous results in your head — the tool is fast, just call it again.
|
|
96
118
|
|
|
97
119
|
## Output format for the user
|
|
98
120
|
|
|
@@ -107,7 +129,7 @@ For each recommendation, include:
|
|
|
107
129
|
- **Cancellation status:**
|
|
108
130
|
- If the rate is non-refundable, label it **"Non-refundable"** explicitly. Do not include any conflicting copy suggesting refunds.
|
|
109
131
|
- If `free_cancellation` is `true`, you may indicate "Free cancellation" with the cutoff date when known.
|
|
110
|
-
- **Distinctive features** (location, key amenities) in one short line.
|
|
132
|
+
- **Distinctive features** (location, key amenities) in one short line. When mentioning breakfast, always say **"breakfast included"** — never "free breakfast."
|
|
111
133
|
- **The `redirect_link`** as a tap-to-book URL. Never construct your own.
|
|
112
134
|
|
|
113
135
|
### Vrbo / vacation rentals
|