@cyanheads/hn-mcp-server 0.5.22 → 0.6.1

package/dist/mcp-server/tools/definitions/search-content.tool.d.ts

@@ -18,6 +18,8 @@ export declare function stripUrlPrefix(query: string): {
 /** What the search notice is composed from: the inputs as searched, and the page Algolia returned. */
 export interface SearchNoticeFacts {
     author?: string | undefined;
+    /** How a full page over the response budget was fitted to it; absent for a page that fit. */
+    budget?: SearchBudget | undefined;
     count: number;
     dateRange?: {
         start?: string | undefined;
@@ -25,6 +27,7 @@ export interface SearchNoticeFacts {
     } | undefined;
     /** The URL prefix dropped from the caller's query before searching. */
     droppedPrefix?: string | undefined;
+    minComments?: number | undefined;
     minPoints?: number | undefined;
     /**
      * The caller's count and page when count was above the per-call cap. The
@@ -47,12 +50,20 @@ export interface SearchNoticeFacts {
     totalHitsExact?: boolean | undefined;
     totalPages: number;
 }
+/** The two steps that fit a full page over the response budget to it. */
+interface SearchBudget {
+    /** Ids of the hits step 2 cut the text of, in page order; empty when step 1 sufficed. */
+    cutIds: readonly number[];
+    /** Step 1 dropped highlights.text from every hit. False when no hit carried one. */
+    highlightsTextOmitted: boolean;
+}
 /**
  * Compose the one `notice` string every search writes. `notice` is last-wins,
  * so each source goes through here: the page-state sentence first, then the
- * cause sentences in input order — query, tags, author, storyId, count. None
- * replaces another. Undefined when nothing applies — the last page of an
- * uncapped, non-empty search.
+ * cause sentences in input order — query, tags, author, storyId, count — then
+ * the budget sentence for a page fitted to the response budget. None replaces
+ * another. Undefined when nothing applies — the last page of an uncapped,
+ * non-empty search that fit.
  */
 export declare function composeSearchNotice(facts: SearchNoticeFacts): string | undefined;
 export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
@@ -77,6 +88,7 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
         end: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     minPoints: z.ZodOptional<z.ZodNumber>;
+    minComments: z.ZodOptional<z.ZodNumber>;
     count: z.ZodDefault<z.ZodNumber>;
     page: z.ZodDefault<z.ZodNumber>;
     view: z.ZodDefault<z.ZodEnum<{
@@ -102,7 +114,10 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
         createdAt: z.ZodString;
         storyTitle: z.ZodOptional<z.ZodString>;
         storyId: z.ZodOptional<z.ZodNumber>;
+        parentId: z.ZodOptional<z.ZodNumber>;
+        storyUrl: z.ZodOptional<z.ZodString>;
         text: z.ZodOptional<z.ZodString>;
+        textTruncated: z.ZodOptional<z.ZodBoolean>;
         highlights: z.ZodOptional<z.ZodObject<{
             title: z.ZodOptional<z.ZodString>;
             text: z.ZodOptional<z.ZodString>;
@@ -114,7 +129,7 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
     readonly reason: "missing_query_or_filter";
     readonly code: JsonRpcErrorCode.InvalidParams;
     readonly when: "Neither a query nor any filter was supplied, so there is nothing to search by.";
-    readonly recovery: "Pass a query, or at least one filter: tags, author, storyId, minPoints, or a dateRange bound. sort, count, page, and view do not count as filters.";
+    readonly recovery: "Pass a query, or at least one filter: tags, author, storyId, minPoints, minComments, or a dateRange bound. sort, count, page, and view do not count as filters.";
     readonly severity: "notice";
 }, {
     readonly reason: "invalid_date_range";
@@ -128,6 +143,12 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
     readonly when: "minPoints was combined with tags \"comment\" or \"job\", record types Algolia stores without points.";
     readonly recovery: "Drop minPoints to search comments or jobs, or search a scored type (story, poll, ask_hn, show_hn, front_page) to filter by points.";
     readonly severity: "notice";
+}, {
+    readonly reason: "min_comments_unscored_type";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "minComments was combined with tags \"comment\" or \"job\", record types Algolia stores without a comment count.";
+    readonly recovery: "Drop minComments to search comments or jobs, or search a type with a comment count (story, poll, ask_hn, show_hn, front_page) to filter by comments.";
+    readonly severity: "notice";
 }, {
     readonly reason: "count_page_unaligned";
     readonly code: JsonRpcErrorCode.InvalidParams;
@@ -182,6 +203,7 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
         author: z.ZodOptional<z.ZodString>;
         storyId: z.ZodOptional<z.ZodNumber>;
         minPoints: z.ZodOptional<z.ZodNumber>;
+        minComments: z.ZodOptional<z.ZodNumber>;
         dateRange: z.ZodOptional<z.ZodObject<{
             start: z.ZodOptional<z.ZodString>;
             end: z.ZodOptional<z.ZodString>;
@@ -204,6 +226,8 @@ export declare const searchHn: import("@cyanheads/mcp-ts-core").ToolDefinition<z
     readonly truncated: z.ZodOptional<z.ZodBoolean>;
     readonly shown: z.ZodOptional<z.ZodNumber>;
     readonly cap: z.ZodOptional<z.ZodNumber>;
+    readonly highlightsTextOmitted: z.ZodOptional<z.ZodBoolean>;
     readonly notice: z.ZodOptional<z.ZodString>;
 }>;
+export {};
 //# sourceMappingURL=search-content.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-content.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-content.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-content.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsHjE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAKvF;AA0ED,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACjF,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AA8FD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAKhF;AAwDD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8fnB,CAAC"}
+{"version":3,"file":"search-content.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-content.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA+HjE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAKvF;AAgFD,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACjF,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AA8FD,yEAAyE;AACzE,UAAU,YAAY;IACpB,yFAAyF;IACzF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,oFAAoF;IACpF,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAYD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAOhF;AA8QD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuZnB,CAAC"}