@cyanheads/openalex-mcp-server 0.10.0 → 0.11.0

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

@@ -7,6 +7,7 @@ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     entity_type: z.ZodEnum<{
         authors: "authors";
+        awards: "awards";
         funders: "funders";
         institutions: "institutions";
         keywords: "keywords";
@@ -28,14 +29,15 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
     }, z.core.$strip>, unknown>>;
     sort: z.ZodOptional<z.ZodString>;
     select: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    per_page: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
+    per_page: z.ZodOptional<z.ZodLazy<z.ZodNumber>>;
     cursor: z.ZodOptional<z.ZodString>;
     page: z.ZodOptional<z.ZodNumber>;
-    sample: z.ZodOptional<z.ZodNumber>;
+    sample: z.ZodOptional<z.ZodLazy<z.ZodNumber>>;
     seed: z.ZodOptional<z.ZodString>;
     slice: z.ZodOptional<z.ZodObject<{
         field: z.ZodString;
         offset: z.ZodDefault<z.ZodNumber>;
+        limit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     meta: z.ZodObject<{
@@ -47,13 +49,6 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
         id: z.ZodString;
         display_name: z.ZodNullable<z.ZodString>;
     }, z.core.$loose>>;
-    omitted: z.ZodOptional<z.ZodObject<{
-        ids: z.ZodArray<z.ZodString>;
-        next: z.ZodObject<{
-            tool: z.ZodLiteral<"openalex_search_entities">;
-            arguments: z.ZodObject<{}, z.core.$loose>;
-        }, z.core.$strip>;
-    }, z.core.$strip>>;
     windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         field: z.ZodString;
@@ -66,7 +61,6 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
             arguments: z.ZodObject<{}, z.core.$loose>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
-    over_budget: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, readonly [{
     readonly reason: "invalid_filter_string";
     readonly code: JsonRpcErrorCode.ValidationError;
@@ -88,8 +82,13 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
 }, {
     readonly reason: "semantic_per_page_cap";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "A search (no `id`) set per_page above the semantic-search cap of 50.";
+    readonly when: "A semantic search (no `id`) set per_page above its cap of 50 on a server with OPENALEX_CLAMP_PER_PAGE=false; with clamping on (the default), it returns 50 and says so.";
     readonly recovery: "Reduce per_page to 50 or less, or switch search_mode to keyword.";
+}, {
+    readonly reason: "response_too_large";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The response's structuredContent or content[] text would exceed 8,000,000 bytes — a wide `select` on a large page, or a record with very long arrays. A page is never shortened to fit.";
+    readonly recovery: "Rerun with the per_page or slice.limit the error names when it names one, or narrow `select` to the fields you need; for a single oversized record, page its largest array with `slice`.";
 }, {
     readonly reason: "semantic_without_query";
     readonly code: JsonRpcErrorCode.ValidationError;
@@ -103,18 +102,23 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
 }, {
     readonly reason: "page_without_semantic";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "A search supplied `page` under a search_mode other than \"semantic\".";
-    readonly recovery: "Drop `page` and paginate with `cursor`, or set search_mode to \"semantic\" — the only mode `page` applies to.";
+    readonly when: "A search supplied `page` with neither search_mode \"semantic\" nor `sample`.";
+    readonly recovery: "Drop `page` and paginate with `cursor`, set search_mode to \"semantic\", or pass `sample` with a `seed` — the only searches `page` walks.";
 }, {
     readonly reason: "sample_with_cursor";
     readonly code: JsonRpcErrorCode.ValidationError;
     readonly when: "A search (no `id`) provided both `sample` and `cursor`.";
-    readonly recovery: "Sampling returns a single page only; remove `cursor` or remove `sample`.";
+    readonly recovery: "A sample walks its draw with `page` and a `seed`, not `cursor`; remove `cursor`, or remove `sample`.";
+}, {
+    readonly reason: "sample_page_without_seed";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A search (no `id`) provided `page` with `sample` but no `seed`, which OpenAlex refuses: an unseeded sample redraws on every call, so its pages would overlap.";
+    readonly recovery: "Pass `seed` to page a sample — an unseeded sample redraws on every call — or drop `page`.";
 }, {
-    readonly reason: "sample_with_page";
+    readonly reason: "sample_page_too_deep";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "A search (no `id`) provided both `sample` and `page`.";
-    readonly recovery: "Sampling returns a single page only; remove `page` or remove `sample`.";
+    readonly when: `A sample page reaches past record ${string} (\`page\` × \`per_page\` above ${string}), the most of a sample OpenAlex serves by page number.`;
+    readonly recovery: `Keep \`page\` × \`per_page\` at or under ${string}, with a per_page that divides ${string} — 25, 50, or 100 — so the last page ends on record ${string}; at per_page 100 that is page 100.`;
 }, {
     readonly reason: "sample_with_semantic";
     readonly code: JsonRpcErrorCode.ValidationError;
@@ -144,7 +148,7 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
     readonly reason: "id_type_mismatch";
     readonly code: JsonRpcErrorCode.ValidationError;
     readonly when: "`id` is a native OpenAlex ID whose letter names another entity type than `entity_type`, or a concept ID (C…), a type this server does not serve.";
-    readonly recovery: "Pass the entity_type the ID letter names — W works, A authors, S sources, I institutions, T topics, P publishers, F funders. A concept ID (C…) has no entity_type here; search topics for the concept by name with openalex_resolve_name instead.";
+    readonly recovery: "Pass the entity_type the ID letter names — W works, A authors, S sources, I institutions, T topics, P publishers, F funders, G awards. A concept ID (C…) has no entity_type here; search topics for the concept by name with openalex_resolve_name instead.";
     readonly thrownBy: "service";
 }, {
     readonly reason: "id_dot_segment";

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

@@ -1 +1 @@
-{"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA4HjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqsB7B,CAAC"}
+{"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA4IjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2zB7B,CAAC"}