@keystrokehq/semanticscholar 0.1.0

package/dist/actions/get-dataset-diffs.cjs

@@ -0,0 +1,31 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-dataset-diffs.ts
+const SemanticscholarGetDatasetDiffsInput = zod.z.object({
+	dataset_name: zod.z.string().describe("Name of the dataset to retrieve diffs for. Common datasets include 'papers', 'authors', 'citations', 'abstracts', etc."),
+	end_release_id: zod.z.string().describe("ID of the ending release. Use date format YYYY-MM-DD (e.g., '2025-01-15') or 'latest' for the most recent release."),
+	start_release_id: zod.z.string().describe("ID of the starting release. Use date format YYYY-MM-DD (e.g., '2024-12-31') or 'latest' for the most recent release.")
+}).describe("Request schema for `GetDatasetDiffs`");
+const SemanticscholarGetDatasetDiffs_DatasetDiffSchema = zod.z.object({
+	to_release: zod.z.string().describe("Target release for this specific diff"),
+	delete_files: zod.z.array(zod.z.string()).describe("Download links to files with records that need removing from the dataset"),
+	from_release: zod.z.string().describe("Baseline release for this specific diff"),
+	update_files: zod.z.array(zod.z.string()).describe("Download links to files with records that need inserting or updating by their primary key")
+}).describe("Individual diff object representing changes between two releases");
+const SemanticscholarGetDatasetDiffsOutput = zod.z.object({
+	diffs: zod.z.array(SemanticscholarGetDatasetDiffs_DatasetDiffSchema).describe("List of diff objects containing download links for incremental updates. Each diff contains 'update_files' and 'delete_files' lists."),
+	dataset: zod.z.string().describe("Name of the dataset these diffs are for"),
+	end_release: zod.z.string().describe("Ending release, i.e. the release the client wants to update to"),
+	start_release: zod.z.string().describe("Beginning release, i.e. the release currently held by the client")
+}).describe("Response schema for `GetDatasetDiffs`");
+const semanticscholarGetDatasetDiffs = require_action.action("SEMANTICSCHOLAR_GET_DATASET_DIFFS", {
+	slug: "semanticscholar-get-dataset-diffs",
+	name: "Get dataset diffs",
+	description: "Get download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. Use when you need to update a local dataset copy without re-downloading the entire dataset.",
+	input: SemanticscholarGetDatasetDiffsInput,
+	output: SemanticscholarGetDatasetDiffsOutput
+});
+//#endregion
+exports.semanticscholarGetDatasetDiffs = semanticscholarGetDatasetDiffs;
+
+//# sourceMappingURL=get-dataset-diffs.cjs.map

package/dist/actions/get-dataset-diffs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset-diffs.cjs","names":["z","action"],"sources":["../../src/actions/get-dataset-diffs.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDatasetDiffsInput: z.ZodTypeAny = z.object({\n  dataset_name: z.string().describe(\"Name of the dataset to retrieve diffs for. Common datasets include 'papers', 'authors', 'citations', 'abstracts', etc.\"),\n  end_release_id: z.string().describe(\"ID of the ending release. Use date format YYYY-MM-DD (e.g., '2025-01-15') or 'latest' for the most recent release.\"),\n  start_release_id: z.string().describe(\"ID of the starting release. Use date format YYYY-MM-DD (e.g., '2024-12-31') or 'latest' for the most recent release.\"),\n}).describe(\"Request schema for `GetDatasetDiffs`\");\nconst SemanticscholarGetDatasetDiffs_DatasetDiffSchema: z.ZodTypeAny = z.object({\n  to_release: z.string().describe(\"Target release for this specific diff\"),\n  delete_files: z.array(z.string()).describe(\"Download links to files with records that need removing from the dataset\"),\n  from_release: z.string().describe(\"Baseline release for this specific diff\"),\n  update_files: z.array(z.string()).describe(\"Download links to files with records that need inserting or updating by their primary key\"),\n}).describe(\"Individual diff object representing changes between two releases\");\nexport const SemanticscholarGetDatasetDiffsOutput: z.ZodTypeAny = z.object({\n  diffs: z.array(SemanticscholarGetDatasetDiffs_DatasetDiffSchema).describe(\"List of diff objects containing download links for incremental updates. Each diff contains 'update_files' and 'delete_files' lists.\"),\n  dataset: z.string().describe(\"Name of the dataset these diffs are for\"),\n  end_release: z.string().describe(\"Ending release, i.e. the release the client wants to update to\"),\n  start_release: z.string().describe(\"Beginning release, i.e. the release currently held by the client\"),\n}).describe(\"Response schema for `GetDatasetDiffs`\");\n\nexport const semanticscholarGetDatasetDiffs = action(\"SEMANTICSCHOLAR_GET_DATASET_DIFFS\", {\n  slug: \"semanticscholar-get-dataset-diffs\",\n  name: \"Get dataset diffs\",\n  description: \"Get download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. Use when you need to update a local dataset copy without re-downloading the entire dataset.\",\n  input: SemanticscholarGetDatasetDiffsInput,\n  output: SemanticscholarGetDatasetDiffsOutput,\n});\n"],"mappings":";;;AAIA,MAAa,sCAAoDA,IAAAA,EAAE,OAAO;CACxE,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,wHAAwH;CAC1J,gBAAgBA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,oHAAoH;CACxJ,kBAAkBA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,sHAAsH;AAC9J,CAAC,CAAC,CAAC,SAAS,sCAAsC;AAClD,MAAM,mDAAiEA,IAAAA,EAAE,OAAO;CAC9E,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,uCAAuC;CACvE,cAAcA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,0EAA0E;CACrH,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,yCAAyC;CAC3E,cAAcA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,2FAA2F;AACxI,CAAC,CAAC,CAAC,SAAS,kEAAkE;AAC9E,MAAa,uCAAqDA,IAAAA,EAAE,OAAO;CACzE,OAAOA,IAAAA,EAAE,MAAM,gDAAgD,CAAC,CAAC,SAAS,qIAAqI;CAC/M,SAASA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,yCAAyC;CACtE,aAAaA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,gEAAgE;CACjG,eAAeA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,kEAAkE;AACvG,CAAC,CAAC,CAAC,SAAS,uCAAuC;AAEnD,MAAa,iCAAiCC,eAAAA,OAAO,qCAAqC;CACxF,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAAQ;AACV,CAAC"}

package/dist/actions/get-dataset-diffs.d.cts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-dataset-diffs.d.ts
+declare const SemanticscholarGetDatasetDiffsInput: z.ZodTypeAny;
+declare const SemanticscholarGetDatasetDiffsOutput: z.ZodTypeAny;
+declare const semanticscholarGetDatasetDiffs: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDatasetDiffs };
+//# sourceMappingURL=get-dataset-diffs.d.cts.map

package/dist/actions/get-dataset-diffs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset-diffs.d.cts","names":[],"sources":["../../src/actions/get-dataset-diffs.ts"],"mappings":";;;cAIa,mCAAA,EAAqC,CAAA,CAAE,UAID;AAAA,cAOtC,oCAAA,EAAsC,CAAA,CAAE,UAKD;AAAA,cAEvC,8BAAA,gCAA8B,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-dataset-diffs.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-dataset-diffs.d.ts
+declare const SemanticscholarGetDatasetDiffsInput: z.ZodTypeAny;
+declare const SemanticscholarGetDatasetDiffsOutput: z.ZodTypeAny;
+declare const semanticscholarGetDatasetDiffs: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDatasetDiffs };
+//# sourceMappingURL=get-dataset-diffs.d.mts.map

package/dist/actions/get-dataset-diffs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset-diffs.d.mts","names":[],"sources":["../../src/actions/get-dataset-diffs.ts"],"mappings":";;;cAIa,mCAAA,EAAqC,CAAA,CAAE,UAID;AAAA,cAOtC,oCAAA,EAAsC,CAAA,CAAE,UAKD;AAAA,cAEvC,8BAAA,gCAA8B,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-dataset-diffs.mjs

@@ -0,0 +1,30 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/get-dataset-diffs.ts
+const SemanticscholarGetDatasetDiffsInput = z.object({
+	dataset_name: z.string().describe("Name of the dataset to retrieve diffs for. Common datasets include 'papers', 'authors', 'citations', 'abstracts', etc."),
+	end_release_id: z.string().describe("ID of the ending release. Use date format YYYY-MM-DD (e.g., '2025-01-15') or 'latest' for the most recent release."),
+	start_release_id: z.string().describe("ID of the starting release. Use date format YYYY-MM-DD (e.g., '2024-12-31') or 'latest' for the most recent release.")
+}).describe("Request schema for `GetDatasetDiffs`");
+const SemanticscholarGetDatasetDiffs_DatasetDiffSchema = z.object({
+	to_release: z.string().describe("Target release for this specific diff"),
+	delete_files: z.array(z.string()).describe("Download links to files with records that need removing from the dataset"),
+	from_release: z.string().describe("Baseline release for this specific diff"),
+	update_files: z.array(z.string()).describe("Download links to files with records that need inserting or updating by their primary key")
+}).describe("Individual diff object representing changes between two releases");
+const semanticscholarGetDatasetDiffs = action("SEMANTICSCHOLAR_GET_DATASET_DIFFS", {
+	slug: "semanticscholar-get-dataset-diffs",
+	name: "Get dataset diffs",
+	description: "Get download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. Use when you need to update a local dataset copy without re-downloading the entire dataset.",
+	input: SemanticscholarGetDatasetDiffsInput,
+	output: z.object({
+		diffs: z.array(SemanticscholarGetDatasetDiffs_DatasetDiffSchema).describe("List of diff objects containing download links for incremental updates. Each diff contains 'update_files' and 'delete_files' lists."),
+		dataset: z.string().describe("Name of the dataset these diffs are for"),
+		end_release: z.string().describe("Ending release, i.e. the release the client wants to update to"),
+		start_release: z.string().describe("Beginning release, i.e. the release currently held by the client")
+	}).describe("Response schema for `GetDatasetDiffs`")
+});
+//#endregion
+export { semanticscholarGetDatasetDiffs };
+
+//# sourceMappingURL=get-dataset-diffs.mjs.map

package/dist/actions/get-dataset-diffs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset-diffs.mjs","names":[],"sources":["../../src/actions/get-dataset-diffs.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDatasetDiffsInput: z.ZodTypeAny = z.object({\n  dataset_name: z.string().describe(\"Name of the dataset to retrieve diffs for. Common datasets include 'papers', 'authors', 'citations', 'abstracts', etc.\"),\n  end_release_id: z.string().describe(\"ID of the ending release. Use date format YYYY-MM-DD (e.g., '2025-01-15') or 'latest' for the most recent release.\"),\n  start_release_id: z.string().describe(\"ID of the starting release. Use date format YYYY-MM-DD (e.g., '2024-12-31') or 'latest' for the most recent release.\"),\n}).describe(\"Request schema for `GetDatasetDiffs`\");\nconst SemanticscholarGetDatasetDiffs_DatasetDiffSchema: z.ZodTypeAny = z.object({\n  to_release: z.string().describe(\"Target release for this specific diff\"),\n  delete_files: z.array(z.string()).describe(\"Download links to files with records that need removing from the dataset\"),\n  from_release: z.string().describe(\"Baseline release for this specific diff\"),\n  update_files: z.array(z.string()).describe(\"Download links to files with records that need inserting or updating by their primary key\"),\n}).describe(\"Individual diff object representing changes between two releases\");\nexport const SemanticscholarGetDatasetDiffsOutput: z.ZodTypeAny = z.object({\n  diffs: z.array(SemanticscholarGetDatasetDiffs_DatasetDiffSchema).describe(\"List of diff objects containing download links for incremental updates. Each diff contains 'update_files' and 'delete_files' lists.\"),\n  dataset: z.string().describe(\"Name of the dataset these diffs are for\"),\n  end_release: z.string().describe(\"Ending release, i.e. the release the client wants to update to\"),\n  start_release: z.string().describe(\"Beginning release, i.e. the release currently held by the client\"),\n}).describe(\"Response schema for `GetDatasetDiffs`\");\n\nexport const semanticscholarGetDatasetDiffs = action(\"SEMANTICSCHOLAR_GET_DATASET_DIFFS\", {\n  slug: \"semanticscholar-get-dataset-diffs\",\n  name: \"Get dataset diffs\",\n  description: \"Get download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. Use when you need to update a local dataset copy without re-downloading the entire dataset.\",\n  input: SemanticscholarGetDatasetDiffsInput,\n  output: SemanticscholarGetDatasetDiffsOutput,\n});\n"],"mappings":";;;AAIA,MAAa,sCAAoD,EAAE,OAAO;CACxE,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS,wHAAwH;CAC1J,gBAAgB,EAAE,OAAO,CAAC,CAAC,SAAS,oHAAoH;CACxJ,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS,sHAAsH;AAC9J,CAAC,CAAC,CAAC,SAAS,sCAAsC;AAClD,MAAM,mDAAiE,EAAE,OAAO;CAC9E,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,uCAAuC;CACvE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,0EAA0E;CACrH,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS,yCAAyC;CAC3E,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,2FAA2F;AACxI,CAAC,CAAC,CAAC,SAAS,kEAAkE;AAQ9E,MAAa,iCAAiC,OAAO,qCAAqC;CACxF,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAZgE,EAAE,OAAO;EACzE,OAAO,EAAE,MAAM,gDAAgD,CAAC,CAAC,SAAS,qIAAqI;EAC/M,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,yCAAyC;EACtE,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,gEAAgE;EACjG,eAAe,EAAE,OAAO,CAAC,CAAC,SAAS,kEAAkE;CACvG,CAAC,CAAC,CAAC,SAAS,uCAOF;AACV,CAAC"}

package/dist/actions/get-dataset.cjs

@@ -0,0 +1,24 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-dataset.ts
+const SemanticscholarGetDatasetInput = zod.z.object({
+	release_id: zod.z.string().describe("ID of the release. Use 'latest' for the most recent release, or a specific date in YYYY-MM-DD format (e.g., '2024-12-31')"),
+	dataset_name: zod.z.string().describe("Name of the dataset to retrieve. Common dataset names include: 'papers', 'abstracts', 'authors', 'citations', 'embeddings'")
+}).describe("Request schema for GetDataset");
+const SemanticscholarGetDatasetOutput = zod.z.object({
+	name: zod.z.string().describe("Name of the dataset"),
+	files: zod.z.array(zod.z.string()).describe("List of temporary, pre-signed S3 download URLs for dataset partitions. These URLs expire after a limited time and must be used promptly"),
+	README: zod.z.string().describe("License and usage information for the dataset"),
+	description: zod.z.string().describe("Description of the data contained in this dataset")
+}).describe("Response schema for GetDataset");
+const semanticscholarGetDataset = require_action.action("SEMANTICSCHOLAR_GET_DATASET", {
+	slug: "semanticscholar-get-dataset",
+	name: "Get dataset download links",
+	description: "Tool to get download links for a specific dataset within a release. Use when you need to download Semantic Scholar dataset files from S3. Returns pre-signed URLs for all dataset partitions.",
+	input: SemanticscholarGetDatasetInput,
+	output: SemanticscholarGetDatasetOutput
+});
+//#endregion
+exports.semanticscholarGetDataset = semanticscholarGetDataset;
+
+//# sourceMappingURL=get-dataset.cjs.map

package/dist/actions/get-dataset.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset.cjs","names":["z","action"],"sources":["../../src/actions/get-dataset.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDatasetInput: z.ZodTypeAny = z.object({\n  release_id: z.string().describe(\"ID of the release. Use 'latest' for the most recent release, or a specific date in YYYY-MM-DD format (e.g., '2024-12-31')\"),\n  dataset_name: z.string().describe(\"Name of the dataset to retrieve. Common dataset names include: 'papers', 'abstracts', 'authors', 'citations', 'embeddings'\"),\n}).describe(\"Request schema for GetDataset\");\nexport const SemanticscholarGetDatasetOutput: z.ZodTypeAny = z.object({\n  name: z.string().describe(\"Name of the dataset\"),\n  files: z.array(z.string()).describe(\"List of temporary, pre-signed S3 download URLs for dataset partitions. These URLs expire after a limited time and must be used promptly\"),\n  README: z.string().describe(\"License and usage information for the dataset\"),\n  description: z.string().describe(\"Description of the data contained in this dataset\"),\n}).describe(\"Response schema for GetDataset\");\n\nexport const semanticscholarGetDataset = action(\"SEMANTICSCHOLAR_GET_DATASET\", {\n  slug: \"semanticscholar-get-dataset\",\n  name: \"Get dataset download links\",\n  description: \"Tool to get download links for a specific dataset within a release. Use when you need to download Semantic Scholar dataset files from S3. Returns pre-signed URLs for all dataset partitions.\",\n  input: SemanticscholarGetDatasetInput,\n  output: SemanticscholarGetDatasetOutput,\n});\n"],"mappings":";;;AAIA,MAAa,iCAA+CA,IAAAA,EAAE,OAAO;CACnE,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,2HAA2H;CAC3J,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,4HAA4H;AAChK,CAAC,CAAC,CAAC,SAAS,+BAA+B;AAC3C,MAAa,kCAAgDA,IAAAA,EAAE,OAAO;CACpE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,qBAAqB;CAC/C,OAAOA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,yIAAyI;CAC7K,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,+CAA+C;CAC3E,aAAaA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,mDAAmD;AACtF,CAAC,CAAC,CAAC,SAAS,gCAAgC;AAE5C,MAAa,4BAA4BC,eAAAA,OAAO,+BAA+B;CAC7E,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAAQ;AACV,CAAC"}

package/dist/actions/get-dataset.d.cts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-dataset.d.ts
+declare const SemanticscholarGetDatasetInput: z.ZodTypeAny;
+declare const SemanticscholarGetDatasetOutput: z.ZodTypeAny;
+declare const semanticscholarGetDataset: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDataset };
+//# sourceMappingURL=get-dataset.d.cts.map

package/dist/actions/get-dataset.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset.d.cts","names":[],"sources":["../../src/actions/get-dataset.ts"],"mappings":";;;cAIa,8BAAA,EAAgC,CAAA,CAAE,UAGH;AAAA,cAC/B,+BAAA,EAAiC,CAAA,CAAE,UAKH;AAAA,cAEhC,yBAAA,gCAAyB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-dataset.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-dataset.d.ts
+declare const SemanticscholarGetDatasetInput: z.ZodTypeAny;
+declare const SemanticscholarGetDatasetOutput: z.ZodTypeAny;
+declare const semanticscholarGetDataset: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDataset };
+//# sourceMappingURL=get-dataset.d.mts.map

package/dist/actions/get-dataset.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset.d.mts","names":[],"sources":["../../src/actions/get-dataset.ts"],"mappings":";;;cAIa,8BAAA,EAAgC,CAAA,CAAE,UAGH;AAAA,cAC/B,+BAAA,EAAiC,CAAA,CAAE,UAKH;AAAA,cAEhC,yBAAA,gCAAyB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-dataset.mjs

@@ -0,0 +1,21 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+const semanticscholarGetDataset = action("SEMANTICSCHOLAR_GET_DATASET", {
+	slug: "semanticscholar-get-dataset",
+	name: "Get dataset download links",
+	description: "Tool to get download links for a specific dataset within a release. Use when you need to download Semantic Scholar dataset files from S3. Returns pre-signed URLs for all dataset partitions.",
+	input: z.object({
+		release_id: z.string().describe("ID of the release. Use 'latest' for the most recent release, or a specific date in YYYY-MM-DD format (e.g., '2024-12-31')"),
+		dataset_name: z.string().describe("Name of the dataset to retrieve. Common dataset names include: 'papers', 'abstracts', 'authors', 'citations', 'embeddings'")
+	}).describe("Request schema for GetDataset"),
+	output: z.object({
+		name: z.string().describe("Name of the dataset"),
+		files: z.array(z.string()).describe("List of temporary, pre-signed S3 download URLs for dataset partitions. These URLs expire after a limited time and must be used promptly"),
+		README: z.string().describe("License and usage information for the dataset"),
+		description: z.string().describe("Description of the data contained in this dataset")
+	}).describe("Response schema for GetDataset")
+});
+//#endregion
+export { semanticscholarGetDataset };
+
+//# sourceMappingURL=get-dataset.mjs.map

package/dist/actions/get-dataset.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dataset.mjs","names":[],"sources":["../../src/actions/get-dataset.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDatasetInput: z.ZodTypeAny = z.object({\n  release_id: z.string().describe(\"ID of the release. Use 'latest' for the most recent release, or a specific date in YYYY-MM-DD format (e.g., '2024-12-31')\"),\n  dataset_name: z.string().describe(\"Name of the dataset to retrieve. Common dataset names include: 'papers', 'abstracts', 'authors', 'citations', 'embeddings'\"),\n}).describe(\"Request schema for GetDataset\");\nexport const SemanticscholarGetDatasetOutput: z.ZodTypeAny = z.object({\n  name: z.string().describe(\"Name of the dataset\"),\n  files: z.array(z.string()).describe(\"List of temporary, pre-signed S3 download URLs for dataset partitions. These URLs expire after a limited time and must be used promptly\"),\n  README: z.string().describe(\"License and usage information for the dataset\"),\n  description: z.string().describe(\"Description of the data contained in this dataset\"),\n}).describe(\"Response schema for GetDataset\");\n\nexport const semanticscholarGetDataset = action(\"SEMANTICSCHOLAR_GET_DATASET\", {\n  slug: \"semanticscholar-get-dataset\",\n  name: \"Get dataset download links\",\n  description: \"Tool to get download links for a specific dataset within a release. Use when you need to download Semantic Scholar dataset files from S3. Returns pre-signed URLs for all dataset partitions.\",\n  input: SemanticscholarGetDatasetInput,\n  output: SemanticscholarGetDatasetOutput,\n});\n"],"mappings":";;AAeA,MAAa,4BAA4B,OAAO,+BAA+B;CAC7E,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAf0D,EAAE,OAAO;EACnE,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,2HAA2H;EAC3J,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS,4HAA4H;CAChK,CAAC,CAAC,CAAC,SAAS,+BAYH;CACP,QAZ2D,EAAE,OAAO;EACpE,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,qBAAqB;EAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,yIAAyI;EAC7K,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,+CAA+C;EAC3E,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,mDAAmD;CACtF,CAAC,CAAC,CAAC,SAAS,gCAOF;AACV,CAAC"}

package/dist/actions/get-details-for-multiple-authors-at-once.cjs

@@ -0,0 +1,19 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-details-for-multiple-authors-at-once.ts
+const SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput = zod.z.object({
+	ids: zod.z.array(zod.z.string()).describe("A list of Semantic Scholar author IDs to retrieve details for. Author IDs are unique identifiers in the format of numeric strings (e.g., '144388777', '1688882'). You can obtain author IDs by searching for authors by name using the author search endpoint. The API will return author details for each valid ID, and null for any invalid or non-existent IDs."),
+	fields: zod.z.string().describe("A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.<br><br> Examples: <ul>     <li><code>fields=name,affiliations,papers</code></li>     <li><code>fields=url,papers.year,papers.authors</code></li> </ul>").optional()
+}).describe("Request schema for `GetDetailsForMultipleAuthorsAtOnce`");
+const SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput = zod.z.unknown();
+const semanticscholarGetDetailsForMultipleAuthorsAtOnce = require_action.action("SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_AUTHORS_AT_ONCE", {
+	slug: "semanticscholar-get-details-for-multiple-authors-at-once",
+	name: "Get details for multiple authors at once",
+	description: "Retrieves detailed information for multiple authors from Semantic Scholar in a single API call. This endpoint allows users to efficiently fetch data for a batch of authors by providing their unique Semantic Scholar IDs. It's particularly useful for applications that need to gather information on multiple authors simultaneously, reducing the number of individual API calls required. The endpoint accepts a list of author IDs and returns comprehensive details for each author, which may include their publications, citations, and other relevant academic information. While the exact response structure is not specified in the given schema, users can expect rich metadata about the requested authors.",
+	input: SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput,
+	output: SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput
+});
+//#endregion
+exports.semanticscholarGetDetailsForMultipleAuthorsAtOnce = semanticscholarGetDetailsForMultipleAuthorsAtOnce;
+
+//# sourceMappingURL=get-details-for-multiple-authors-at-once.cjs.map

package/dist/actions/get-details-for-multiple-authors-at-once.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-authors-at-once.cjs","names":["z","action"],"sources":["../../src/actions/get-details-for-multiple-authors-at-once.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput: z.ZodTypeAny = z.object({\n  ids: z.array(z.string()).describe(\"A list of Semantic Scholar author IDs to retrieve details for. Author IDs are unique identifiers in the format of numeric strings (e.g., '144388777', '1688882'). You can obtain author IDs by searching for authors by name using the author search endpoint. The API will return author details for each valid ID, and null for any invalid or non-existent IDs.\"),\n  fields: z.string().describe(\"A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.<br><br> Examples: <ul>     <li><code>fields=name,affiliations,papers</code></li>     <li><code>fields=url,papers.year,papers.authors</code></li> </ul>\").optional(),\n}).describe(\"Request schema for `GetDetailsForMultipleAuthorsAtOnce`\");\nexport const SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput: z.ZodTypeAny = z.unknown();\n\nexport const semanticscholarGetDetailsForMultipleAuthorsAtOnce = action(\"SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_AUTHORS_AT_ONCE\", {\n  slug: \"semanticscholar-get-details-for-multiple-authors-at-once\",\n  name: \"Get details for multiple authors at once\",\n  description: \"Retrieves detailed information for multiple authors from Semantic Scholar in a single API call. This endpoint allows users to efficiently fetch data for a batch of authors by providing their unique Semantic Scholar IDs. It's particularly useful for applications that need to gather information on multiple authors simultaneously, reducing the number of individual API calls required. The endpoint accepts a list of author IDs and returns comprehensive details for each author, which may include their publications, citations, and other relevant academic information. While the exact response structure is not specified in the given schema, users can expect rich metadata about the requested authors.\",\n  input: SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput,\n  output: SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput,\n});\n"],"mappings":";;;AAIA,MAAa,yDAAuEA,IAAAA,EAAE,OAAO;CAC3F,KAAKA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,oWAAoW;CACtY,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,2gBAA2gB,CAAC,CAAC,SAAS;AACpjB,CAAC,CAAC,CAAC,SAAS,yDAAyD;AACrE,MAAa,0DAAwEA,IAAAA,EAAE,QAAQ;AAE/F,MAAa,oDAAoDC,eAAAA,OAAO,4DAA4D;CAClI,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAAQ;AACV,CAAC"}

package/dist/actions/get-details-for-multiple-authors-at-once.d.cts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-details-for-multiple-authors-at-once.d.ts
+declare const SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput: z.ZodTypeAny;
+declare const SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput: z.ZodTypeAny;
+declare const semanticscholarGetDetailsForMultipleAuthorsAtOnce: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDetailsForMultipleAuthorsAtOnce };
+//# sourceMappingURL=get-details-for-multiple-authors-at-once.d.cts.map

package/dist/actions/get-details-for-multiple-authors-at-once.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-authors-at-once.d.cts","names":[],"sources":["../../src/actions/get-details-for-multiple-authors-at-once.ts"],"mappings":";;;cAIa,sDAAA,EAAwD,CAAA,CAAE,UAGD;AAAA,cACzD,uDAAA,EAAyD,CAAA,CAAE,UAAwB;AAAA,cAEnF,iDAAA,gCAAiD,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-details-for-multiple-authors-at-once.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-details-for-multiple-authors-at-once.d.ts
+declare const SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput: z.ZodTypeAny;
+declare const SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput: z.ZodTypeAny;
+declare const semanticscholarGetDetailsForMultipleAuthorsAtOnce: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDetailsForMultipleAuthorsAtOnce };
+//# sourceMappingURL=get-details-for-multiple-authors-at-once.d.mts.map

package/dist/actions/get-details-for-multiple-authors-at-once.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-authors-at-once.d.mts","names":[],"sources":["../../src/actions/get-details-for-multiple-authors-at-once.ts"],"mappings":";;;cAIa,sDAAA,EAAwD,CAAA,CAAE,UAGD;AAAA,cACzD,uDAAA,EAAyD,CAAA,CAAE,UAAwB;AAAA,cAEnF,iDAAA,gCAAiD,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-details-for-multiple-authors-at-once.mjs

@@ -0,0 +1,16 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+const semanticscholarGetDetailsForMultipleAuthorsAtOnce = action("SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_AUTHORS_AT_ONCE", {
+	slug: "semanticscholar-get-details-for-multiple-authors-at-once",
+	name: "Get details for multiple authors at once",
+	description: "Retrieves detailed information for multiple authors from Semantic Scholar in a single API call. This endpoint allows users to efficiently fetch data for a batch of authors by providing their unique Semantic Scholar IDs. It's particularly useful for applications that need to gather information on multiple authors simultaneously, reducing the number of individual API calls required. The endpoint accepts a list of author IDs and returns comprehensive details for each author, which may include their publications, citations, and other relevant academic information. While the exact response structure is not specified in the given schema, users can expect rich metadata about the requested authors.",
+	input: z.object({
+		ids: z.array(z.string()).describe("A list of Semantic Scholar author IDs to retrieve details for. Author IDs are unique identifiers in the format of numeric strings (e.g., '144388777', '1688882'). You can obtain author IDs by searching for authors by name using the author search endpoint. The API will return author details for each valid ID, and null for any invalid or non-existent IDs."),
+		fields: z.string().describe("A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.<br><br> Examples: <ul>     <li><code>fields=name,affiliations,papers</code></li>     <li><code>fields=url,papers.year,papers.authors</code></li> </ul>").optional()
+	}).describe("Request schema for `GetDetailsForMultipleAuthorsAtOnce`"),
+	output: z.unknown()
+});
+//#endregion
+export { semanticscholarGetDetailsForMultipleAuthorsAtOnce };
+
+//# sourceMappingURL=get-details-for-multiple-authors-at-once.mjs.map

package/dist/actions/get-details-for-multiple-authors-at-once.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-authors-at-once.mjs","names":[],"sources":["../../src/actions/get-details-for-multiple-authors-at-once.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput: z.ZodTypeAny = z.object({\n  ids: z.array(z.string()).describe(\"A list of Semantic Scholar author IDs to retrieve details for. Author IDs are unique identifiers in the format of numeric strings (e.g., '144388777', '1688882'). You can obtain author IDs by searching for authors by name using the author search endpoint. The API will return author details for each valid ID, and null for any invalid or non-existent IDs.\"),\n  fields: z.string().describe(\"A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.<br><br> Examples: <ul>     <li><code>fields=name,affiliations,papers</code></li>     <li><code>fields=url,papers.year,papers.authors</code></li> </ul>\").optional(),\n}).describe(\"Request schema for `GetDetailsForMultipleAuthorsAtOnce`\");\nexport const SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput: z.ZodTypeAny = z.unknown();\n\nexport const semanticscholarGetDetailsForMultipleAuthorsAtOnce = action(\"SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_AUTHORS_AT_ONCE\", {\n  slug: \"semanticscholar-get-details-for-multiple-authors-at-once\",\n  name: \"Get details for multiple authors at once\",\n  description: \"Retrieves detailed information for multiple authors from Semantic Scholar in a single API call. This endpoint allows users to efficiently fetch data for a batch of authors by providing their unique Semantic Scholar IDs. It's particularly useful for applications that need to gather information on multiple authors simultaneously, reducing the number of individual API calls required. The endpoint accepts a list of author IDs and returns comprehensive details for each author, which may include their publications, citations, and other relevant academic information. While the exact response structure is not specified in the given schema, users can expect rich metadata about the requested authors.\",\n  input: SemanticscholarGetDetailsForMultipleAuthorsAtOnceInput,\n  output: SemanticscholarGetDetailsForMultipleAuthorsAtOnceOutput,\n});\n"],"mappings":";;AAUA,MAAa,oDAAoD,OAAO,4DAA4D;CAClI,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAVkF,EAAE,OAAO;EAC3F,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,oWAAoW;EACtY,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,2gBAA2gB,CAAC,CAAC,SAAS;CACpjB,CAAC,CAAC,CAAC,SAAS,yDAOH;CACP,QAPmF,EAAE,QAO7E;AACV,CAAC"}

package/dist/actions/get-details-for-multiple-papers-at-once.cjs

@@ -0,0 +1,41 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-details-for-multiple-papers-at-once.ts
+const SemanticscholarGetDetailsForMultiplePapersAtOnceInput = zod.z.object({
+	ids: zod.z.array(zod.z.string()).describe("A list of paper IDs to retrieve (maximum 500 IDs per request). Supports multiple ID formats: Semantic Scholar Paper ID (e.g., '649def34f8be52c8b66281af98ae884c09aef38b'), CorpusId (e.g., 'CorpusId:37220927'), DOI (e.g., '10.1038/nature14539'), ArXiv ID (e.g., 'arXiv:1706.03762'), PubMed ID (e.g., 'PMID:29446767'), PubMed Central ID (e.g., 'PMCID:PMC5833129'), MAG ID, ACL ID, or paper URL. Papers not found will return null in the response array.").optional(),
+	fields: zod.z.string().describe("A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul>     <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>embedding</code>, the default <a href=\"https://github.com/allenai/specter\">Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul>     <li><code>fields=title,url</code></li>     <li><code>fields=title,embedding.specter_v2</code></li>     <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>").optional()
+}).describe("Request schema for `GetDetailsForMultiplePapersAtOnce`");
+const SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema = zod.z.object({
+	url: zod.z.string().describe("Semantic Scholar URL for the paper").nullable().optional(),
+	year: zod.z.number().int().describe("Publication year").nullable().optional(),
+	title: zod.z.string().describe("Paper title").nullable().optional(),
+	venue: zod.z.string().describe("Publication venue").nullable().optional(),
+	authors: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())).describe("List of authors with authorId, name, and optional subfields").nullable().optional(),
+	journal: zod.z.record(zod.z.string(), zod.z.unknown()).describe("Journal information").nullable().optional(),
+	paperId: zod.z.string().describe("Unique Semantic Scholar paper ID").nullable().optional(),
+	abstract: zod.z.string().describe("Paper abstract").nullable().optional(),
+	citations: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())).describe("List of papers citing this paper").nullable().optional(),
+	embedding: zod.z.record(zod.z.string(), zod.z.unknown()).describe("Paper embedding vector (SPECTER)").nullable().optional(),
+	references: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())).describe("List of papers referenced by this paper").nullable().optional(),
+	citationCount: zod.z.number().int().describe("Total number of citations").nullable().optional(),
+	fieldsOfStudy: zod.z.array(zod.z.string()).describe("Fields of study").nullable().optional(),
+	openAccessPdf: zod.z.record(zod.z.string(), zod.z.unknown()).describe("Open access PDF information").nullable().optional(),
+	referenceCount: zod.z.number().int().describe("Number of references").nullable().optional(),
+	publicationDate: zod.z.string().describe("Publication date in YYYY-MM-DD format").nullable().optional(),
+	s2FieldsOfStudy: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())).describe("Semantic Scholar fields of study with categories").nullable().optional(),
+	publicationTypes: zod.z.array(zod.z.string()).describe("Types of publication (e.g., JournalArticle, Conference)").nullable().optional(),
+	publicationVenue: zod.z.record(zod.z.string(), zod.z.unknown()).describe("Detailed publication venue information").nullable().optional(),
+	influentialCitationCount: zod.z.number().int().describe("Number of influential citations").nullable().optional()
+}).passthrough().describe("Details for a single paper. Available fields vary based on the 'fields' parameter.");
+const SemanticscholarGetDetailsForMultiplePapersAtOnceOutput = zod.z.object({ details: zod.z.array(SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema.nullable()).describe("Array of paper details. Each entry contains the requested fields for a paper. If a paper ID is not found, the corresponding entry will be null. Papers appear in the same order as the input IDs.") }).passthrough().describe("Response schema for `GetDetailsForMultiplePapersAtOnce`");
+const semanticscholarGetDetailsForMultiplePapersAtOnce = require_action.action("SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_PAPERS_AT_ONCE", {
+	slug: "semanticscholar-get-details-for-multiple-papers-at-once",
+	name: "Get details for multiple papers at once",
+	description: "Retrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, significantly reducing the number of individual API requests needed. Key features: - Accepts multiple paper ID formats (Semantic Scholar ID, CorpusId, DOI, ArXiv, PMID, etc.) - Customizable field selection to retrieve only needed data - Papers not found return null in the corresponding array position - Results maintain the same order as input IDs - Supports nested field queries (e.g., authors.name, citations.title) Use this endpoint when you have a list of known paper IDs and want to retrieve their details simultaneously, rather than making individual requests for each paper.",
+	input: SemanticscholarGetDetailsForMultiplePapersAtOnceInput,
+	output: SemanticscholarGetDetailsForMultiplePapersAtOnceOutput
+});
+//#endregion
+exports.semanticscholarGetDetailsForMultiplePapersAtOnce = semanticscholarGetDetailsForMultiplePapersAtOnce;
+
+//# sourceMappingURL=get-details-for-multiple-papers-at-once.cjs.map

package/dist/actions/get-details-for-multiple-papers-at-once.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-papers-at-once.cjs","names":["z","action"],"sources":["../../src/actions/get-details-for-multiple-papers-at-once.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDetailsForMultiplePapersAtOnceInput: z.ZodTypeAny = z.object({\n  ids: z.array(z.string()).describe(\"A list of paper IDs to retrieve (maximum 500 IDs per request). Supports multiple ID formats: Semantic Scholar Paper ID (e.g., '649def34f8be52c8b66281af98ae884c09aef38b'), CorpusId (e.g., 'CorpusId:37220927'), DOI (e.g., '10.1038/nature14539'), ArXiv ID (e.g., 'arXiv:1706.03762'), PubMed ID (e.g., 'PMID:29446767'), PubMed Central ID (e.g., 'PMCID:PMC5833129'), MAG ID, ACL ID, or paper URL. Papers not found will return null in the response array.\").optional(),\n  fields: z.string().describe(\"A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul>     <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>embedding</code>, the default <a href=\\\"https://github.com/allenai/specter\\\">Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul>     <li><code>fields=title,url</code></li>     <li><code>fields=title,embedding.specter_v2</code></li>     <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>\").optional(),\n}).describe(\"Request schema for `GetDetailsForMultiplePapersAtOnce`\");\nconst SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema: z.ZodTypeAny = z.object({\n  url: z.string().describe(\"Semantic Scholar URL for the paper\").nullable().optional(),\n  year: z.number().int().describe(\"Publication year\").nullable().optional(),\n  title: z.string().describe(\"Paper title\").nullable().optional(),\n  venue: z.string().describe(\"Publication venue\").nullable().optional(),\n  authors: z.array(z.record(z.string(), z.unknown())).describe(\"List of authors with authorId, name, and optional subfields\").nullable().optional(),\n  journal: z.record(z.string(), z.unknown()).describe(\"Journal information\").nullable().optional(),\n  paperId: z.string().describe(\"Unique Semantic Scholar paper ID\").nullable().optional(),\n  abstract: z.string().describe(\"Paper abstract\").nullable().optional(),\n  citations: z.array(z.record(z.string(), z.unknown())).describe(\"List of papers citing this paper\").nullable().optional(),\n  embedding: z.record(z.string(), z.unknown()).describe(\"Paper embedding vector (SPECTER)\").nullable().optional(),\n  references: z.array(z.record(z.string(), z.unknown())).describe(\"List of papers referenced by this paper\").nullable().optional(),\n  citationCount: z.number().int().describe(\"Total number of citations\").nullable().optional(),\n  fieldsOfStudy: z.array(z.string()).describe(\"Fields of study\").nullable().optional(),\n  openAccessPdf: z.record(z.string(), z.unknown()).describe(\"Open access PDF information\").nullable().optional(),\n  referenceCount: z.number().int().describe(\"Number of references\").nullable().optional(),\n  publicationDate: z.string().describe(\"Publication date in YYYY-MM-DD format\").nullable().optional(),\n  s2FieldsOfStudy: z.array(z.record(z.string(), z.unknown())).describe(\"Semantic Scholar fields of study with categories\").nullable().optional(),\n  publicationTypes: z.array(z.string()).describe(\"Types of publication (e.g., JournalArticle, Conference)\").nullable().optional(),\n  publicationVenue: z.record(z.string(), z.unknown()).describe(\"Detailed publication venue information\").nullable().optional(),\n  influentialCitationCount: z.number().int().describe(\"Number of influential citations\").nullable().optional(),\n}).passthrough().describe(\"Details for a single paper. Available fields vary based on the 'fields' parameter.\");\nexport const SemanticscholarGetDetailsForMultiplePapersAtOnceOutput: z.ZodTypeAny = z.object({\n  details: z.array(SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema.nullable()).describe(\"Array of paper details. Each entry contains the requested fields for a paper. If a paper ID is not found, the corresponding entry will be null. Papers appear in the same order as the input IDs.\"),\n}).passthrough().describe(\"Response schema for `GetDetailsForMultiplePapersAtOnce`\");\n\nexport const semanticscholarGetDetailsForMultiplePapersAtOnce = action(\"SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_PAPERS_AT_ONCE\", {\n  slug: \"semanticscholar-get-details-for-multiple-papers-at-once\",\n  name: \"Get details for multiple papers at once\",\n  description: \"Retrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, significantly reducing the number of individual API requests needed. Key features: - Accepts multiple paper ID formats (Semantic Scholar ID, CorpusId, DOI, ArXiv, PMID, etc.) - Customizable field selection to retrieve only needed data - Papers not found return null in the corresponding array position - Results maintain the same order as input IDs - Supports nested field queries (e.g., authors.name, citations.title) Use this endpoint when you have a list of known paper IDs and want to retrieve their details simultaneously, rather than making individual requests for each paper.\",\n  input: SemanticscholarGetDetailsForMultiplePapersAtOnceInput,\n  output: SemanticscholarGetDetailsForMultiplePapersAtOnceOutput,\n});\n"],"mappings":"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"}

package/dist/actions/get-details-for-multiple-papers-at-once.d.cts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-details-for-multiple-papers-at-once.d.ts
+declare const SemanticscholarGetDetailsForMultiplePapersAtOnceInput: z.ZodTypeAny;
+declare const SemanticscholarGetDetailsForMultiplePapersAtOnceOutput: z.ZodTypeAny;
+declare const semanticscholarGetDetailsForMultiplePapersAtOnce: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDetailsForMultiplePapersAtOnce };
+//# sourceMappingURL=get-details-for-multiple-papers-at-once.d.cts.map

package/dist/actions/get-details-for-multiple-papers-at-once.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-papers-at-once.d.cts","names":[],"sources":["../../src/actions/get-details-for-multiple-papers-at-once.ts"],"mappings":";;;cAIa,qDAAA,EAAuD,CAAA,CAAE,UAGD;AAAA,cAuBxD,sDAAA,EAAwD,CAAA,CAAE,UAEa;AAAA,cAEvE,gDAAA,gCAAgD,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-details-for-multiple-papers-at-once.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+//#region src/actions/get-details-for-multiple-papers-at-once.d.ts
+declare const SemanticscholarGetDetailsForMultiplePapersAtOnceInput: z.ZodTypeAny;
+declare const SemanticscholarGetDetailsForMultiplePapersAtOnceOutput: z.ZodTypeAny;
+declare const semanticscholarGetDetailsForMultiplePapersAtOnce: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { semanticscholarGetDetailsForMultiplePapersAtOnce };
+//# sourceMappingURL=get-details-for-multiple-papers-at-once.d.mts.map

package/dist/actions/get-details-for-multiple-papers-at-once.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-papers-at-once.d.mts","names":[],"sources":["../../src/actions/get-details-for-multiple-papers-at-once.ts"],"mappings":";;;cAIa,qDAAA,EAAuD,CAAA,CAAE,UAGD;AAAA,cAuBxD,sDAAA,EAAwD,CAAA,CAAE,UAEa;AAAA,cAEvE,gDAAA,gCAAgD,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}

package/dist/actions/get-details-for-multiple-papers-at-once.mjs

@@ -0,0 +1,40 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/get-details-for-multiple-papers-at-once.ts
+const SemanticscholarGetDetailsForMultiplePapersAtOnceInput = z.object({
+	ids: z.array(z.string()).describe("A list of paper IDs to retrieve (maximum 500 IDs per request). Supports multiple ID formats: Semantic Scholar Paper ID (e.g., '649def34f8be52c8b66281af98ae884c09aef38b'), CorpusId (e.g., 'CorpusId:37220927'), DOI (e.g., '10.1038/nature14539'), ArXiv ID (e.g., 'arXiv:1706.03762'), PubMed ID (e.g., 'PMID:29446767'), PubMed Central ID (e.g., 'PMCID:PMC5833129'), MAG ID, ACL ID, or paper URL. Papers not found will return null in the response array.").optional(),
+	fields: z.string().describe("A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul>     <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>embedding</code>, the default <a href=\"https://github.com/allenai/specter\">Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul>     <li><code>fields=title,url</code></li>     <li><code>fields=title,embedding.specter_v2</code></li>     <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>").optional()
+}).describe("Request schema for `GetDetailsForMultiplePapersAtOnce`");
+const SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema = z.object({
+	url: z.string().describe("Semantic Scholar URL for the paper").nullable().optional(),
+	year: z.number().int().describe("Publication year").nullable().optional(),
+	title: z.string().describe("Paper title").nullable().optional(),
+	venue: z.string().describe("Publication venue").nullable().optional(),
+	authors: z.array(z.record(z.string(), z.unknown())).describe("List of authors with authorId, name, and optional subfields").nullable().optional(),
+	journal: z.record(z.string(), z.unknown()).describe("Journal information").nullable().optional(),
+	paperId: z.string().describe("Unique Semantic Scholar paper ID").nullable().optional(),
+	abstract: z.string().describe("Paper abstract").nullable().optional(),
+	citations: z.array(z.record(z.string(), z.unknown())).describe("List of papers citing this paper").nullable().optional(),
+	embedding: z.record(z.string(), z.unknown()).describe("Paper embedding vector (SPECTER)").nullable().optional(),
+	references: z.array(z.record(z.string(), z.unknown())).describe("List of papers referenced by this paper").nullable().optional(),
+	citationCount: z.number().int().describe("Total number of citations").nullable().optional(),
+	fieldsOfStudy: z.array(z.string()).describe("Fields of study").nullable().optional(),
+	openAccessPdf: z.record(z.string(), z.unknown()).describe("Open access PDF information").nullable().optional(),
+	referenceCount: z.number().int().describe("Number of references").nullable().optional(),
+	publicationDate: z.string().describe("Publication date in YYYY-MM-DD format").nullable().optional(),
+	s2FieldsOfStudy: z.array(z.record(z.string(), z.unknown())).describe("Semantic Scholar fields of study with categories").nullable().optional(),
+	publicationTypes: z.array(z.string()).describe("Types of publication (e.g., JournalArticle, Conference)").nullable().optional(),
+	publicationVenue: z.record(z.string(), z.unknown()).describe("Detailed publication venue information").nullable().optional(),
+	influentialCitationCount: z.number().int().describe("Number of influential citations").nullable().optional()
+}).passthrough().describe("Details for a single paper. Available fields vary based on the 'fields' parameter.");
+const semanticscholarGetDetailsForMultiplePapersAtOnce = action("SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_PAPERS_AT_ONCE", {
+	slug: "semanticscholar-get-details-for-multiple-papers-at-once",
+	name: "Get details for multiple papers at once",
+	description: "Retrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, significantly reducing the number of individual API requests needed. Key features: - Accepts multiple paper ID formats (Semantic Scholar ID, CorpusId, DOI, ArXiv, PMID, etc.) - Customizable field selection to retrieve only needed data - Papers not found return null in the corresponding array position - Results maintain the same order as input IDs - Supports nested field queries (e.g., authors.name, citations.title) Use this endpoint when you have a list of known paper IDs and want to retrieve their details simultaneously, rather than making individual requests for each paper.",
+	input: SemanticscholarGetDetailsForMultiplePapersAtOnceInput,
+	output: z.object({ details: z.array(SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema.nullable()).describe("Array of paper details. Each entry contains the requested fields for a paper. If a paper ID is not found, the corresponding entry will be null. Papers appear in the same order as the input IDs.") }).passthrough().describe("Response schema for `GetDetailsForMultiplePapersAtOnce`")
+});
+//#endregion
+export { semanticscholarGetDetailsForMultiplePapersAtOnce };
+
+//# sourceMappingURL=get-details-for-multiple-papers-at-once.mjs.map

package/dist/actions/get-details-for-multiple-papers-at-once.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-details-for-multiple-papers-at-once.mjs","names":[],"sources":["../../src/actions/get-details-for-multiple-papers-at-once.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SemanticscholarGetDetailsForMultiplePapersAtOnceInput: z.ZodTypeAny = z.object({\n  ids: z.array(z.string()).describe(\"A list of paper IDs to retrieve (maximum 500 IDs per request). Supports multiple ID formats: Semantic Scholar Paper ID (e.g., '649def34f8be52c8b66281af98ae884c09aef38b'), CorpusId (e.g., 'CorpusId:37220927'), DOI (e.g., '10.1038/nature14539'), ArXiv ID (e.g., 'arXiv:1706.03762'), PubMed ID (e.g., 'PMID:29446767'), PubMed Central ID (e.g., 'PMCID:PMC5833129'), MAG ID, ACL ID, or paper URL. Papers not found will return null in the response array.\").optional(),\n  fields: z.string().describe(\"A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul>     <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li>     <li>When requesting <code>embedding</code>, the default <a href=\\\"https://github.com/allenai/specter\\\">Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul>     <li><code>fields=title,url</code></li>     <li><code>fields=title,embedding.specter_v2</code></li>     <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>\").optional(),\n}).describe(\"Request schema for `GetDetailsForMultiplePapersAtOnce`\");\nconst SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema: z.ZodTypeAny = z.object({\n  url: z.string().describe(\"Semantic Scholar URL for the paper\").nullable().optional(),\n  year: z.number().int().describe(\"Publication year\").nullable().optional(),\n  title: z.string().describe(\"Paper title\").nullable().optional(),\n  venue: z.string().describe(\"Publication venue\").nullable().optional(),\n  authors: z.array(z.record(z.string(), z.unknown())).describe(\"List of authors with authorId, name, and optional subfields\").nullable().optional(),\n  journal: z.record(z.string(), z.unknown()).describe(\"Journal information\").nullable().optional(),\n  paperId: z.string().describe(\"Unique Semantic Scholar paper ID\").nullable().optional(),\n  abstract: z.string().describe(\"Paper abstract\").nullable().optional(),\n  citations: z.array(z.record(z.string(), z.unknown())).describe(\"List of papers citing this paper\").nullable().optional(),\n  embedding: z.record(z.string(), z.unknown()).describe(\"Paper embedding vector (SPECTER)\").nullable().optional(),\n  references: z.array(z.record(z.string(), z.unknown())).describe(\"List of papers referenced by this paper\").nullable().optional(),\n  citationCount: z.number().int().describe(\"Total number of citations\").nullable().optional(),\n  fieldsOfStudy: z.array(z.string()).describe(\"Fields of study\").nullable().optional(),\n  openAccessPdf: z.record(z.string(), z.unknown()).describe(\"Open access PDF information\").nullable().optional(),\n  referenceCount: z.number().int().describe(\"Number of references\").nullable().optional(),\n  publicationDate: z.string().describe(\"Publication date in YYYY-MM-DD format\").nullable().optional(),\n  s2FieldsOfStudy: z.array(z.record(z.string(), z.unknown())).describe(\"Semantic Scholar fields of study with categories\").nullable().optional(),\n  publicationTypes: z.array(z.string()).describe(\"Types of publication (e.g., JournalArticle, Conference)\").nullable().optional(),\n  publicationVenue: z.record(z.string(), z.unknown()).describe(\"Detailed publication venue information\").nullable().optional(),\n  influentialCitationCount: z.number().int().describe(\"Number of influential citations\").nullable().optional(),\n}).passthrough().describe(\"Details for a single paper. Available fields vary based on the 'fields' parameter.\");\nexport const SemanticscholarGetDetailsForMultiplePapersAtOnceOutput: z.ZodTypeAny = z.object({\n  details: z.array(SemanticscholarGetDetailsForMultiplePapersAtOnce_PaperDetailsSchema.nullable()).describe(\"Array of paper details. Each entry contains the requested fields for a paper. If a paper ID is not found, the corresponding entry will be null. Papers appear in the same order as the input IDs.\"),\n}).passthrough().describe(\"Response schema for `GetDetailsForMultiplePapersAtOnce`\");\n\nexport const semanticscholarGetDetailsForMultiplePapersAtOnce = action(\"SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_PAPERS_AT_ONCE\", {\n  slug: \"semanticscholar-get-details-for-multiple-papers-at-once\",\n  name: \"Get details for multiple papers at once\",\n  description: \"Retrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, significantly reducing the number of individual API requests needed. Key features: - Accepts multiple paper ID formats (Semantic Scholar ID, CorpusId, DOI, ArXiv, PMID, etc.) - Customizable field selection to retrieve only needed data - Papers not found return null in the corresponding array position - Results maintain the same order as input IDs - Supports nested field queries (e.g., authors.name, citations.title) Use this endpoint when you have a list of known paper IDs and want to retrieve their details simultaneously, rather than making individual requests for each paper.\",\n  input: SemanticscholarGetDetailsForMultiplePapersAtOnceInput,\n  output: SemanticscholarGetDetailsForMultiplePapersAtOnceOutput,\n});\n"],"mappings":"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"}

package/dist/actions/get-paper-recommendations.cjs

@@ -0,0 +1,83 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-paper-recommendations.ts
+const SemanticscholarGetPaperRecommendationsInput = zod.z.object({
+	limit: zod.z.number().int().default(100).describe("Maximum number of paper recommendations to return. Default is 100, maximum is 500.").optional(),
+	fields: zod.z.string().describe("Comma-separated list of fields to return for each recommended paper. If not specified, only paperId and title are returned. Available fields include: paperId, corpusId, externalIds, url, title, abstract, venue, publicationVenue, year, referenceCount, citationCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, s2FieldsOfStudy, publicationTypes, publicationDate, journal, citationStyles, authors, embedding, tldr. Use dot notation for nested fields (e.g., 'authors.authorId', 'citations.title').").optional(),
+	negative_paper_ids: zod.z.array(zod.z.string()).describe("Array of paper IDs that represent negative examples (papers you don't want similar recommendations for). This is optional and helps refine recommendations by excluding similar papers. Accepts the same ID formats as positive_paper_ids.").optional(),
+	positive_paper_ids: zod.z.array(zod.z.string()).describe("Array of paper IDs that represent positive examples (papers you like and want similar recommendations for). Supported ID formats include: Semantic Scholar ID (e.g., '649def34f8be52c8b66281af98ae884c09aef38b'), CorpusId (e.g., 'CorpusId:215416146'), DOI (e.g., 'DOI:10.18653/v1/N18-3011'), ArXiv (e.g., 'ARXIV:2106.15928'), MAG (e.g., 'MAG:112218234'), ACL (e.g., 'ACL:W12-3903'), PMID (e.g., 'PMID:19872477'), PMCID (e.g., 'PMCID:2323736'), or URL from supported sites.")
+}).describe("Request schema for GetPaperRecommendations");
+const SemanticscholarGetPaperRecommendations_TldrSchema = zod.z.object({
+	text: zod.z.string().describe("TLDR summary text").nullable().optional(),
+	model: zod.z.string().describe("Model used for generation").nullable().optional()
+}).describe("AI-generated TLDR summary");
+const SemanticscholarGetPaperRecommendations_AuthorSchema = zod.z.object({
+	url: zod.z.string().describe("Author profile URL").nullable().optional(),
+	name: zod.z.string().describe("Author name").nullable().optional(),
+	hIndex: zod.z.number().int().describe("h-index metric").nullable().optional(),
+	authorId: zod.z.string().describe("Semantic Scholar author ID").nullable().optional(),
+	homepage: zod.z.string().describe("Author homepage").nullable().optional(),
+	paperCount: zod.z.number().int().describe("Total number of papers").nullable().optional(),
+	externalIds: zod.z.object({}).describe("External IDs like ORCID, DBLP").nullable().optional(),
+	affiliations: zod.z.array(zod.z.string()).describe("Author affiliations").nullable().optional(),
+	citationCount: zod.z.number().int().describe("Total citation count").nullable().optional()
+}).describe("Author information");
+const SemanticscholarGetPaperRecommendations_JournalSchema = zod.z.object({
+	name: zod.z.string().describe("Journal name").nullable().optional(),
+	pages: zod.z.string().describe("Page range").nullable().optional(),
+	volume: zod.z.string().describe("Volume number").nullable().optional()
+}).describe("Journal metadata");
+const SemanticscholarGetPaperRecommendations_OpenAccessPdfSchema = zod.z.object({
+	url: zod.z.string().describe("URL to the open access PDF").nullable().optional(),
+	status: zod.z.string().describe("Open access status").nullable().optional(),
+	license: zod.z.string().describe("License information").nullable().optional(),
+	disclaimer: zod.z.string().describe("Disclaimer text if any").nullable().optional()
+}).describe("Open access PDF information");
+const SemanticscholarGetPaperRecommendations_S2FieldOfStudySchema = zod.z.object({
+	source: zod.z.string().describe("Classification source").nullable().optional(),
+	category: zod.z.string().describe("Field category").nullable().optional()
+}).describe("Semantic Scholar field of study classification");
+const SemanticscholarGetPaperRecommendations_PublicationVenueSchema = zod.z.object({
+	id: zod.z.string().describe("Venue identifier").nullable().optional(),
+	url: zod.z.string().describe("Venue URL").nullable().optional(),
+	name: zod.z.string().describe("Venue name").nullable().optional(),
+	type: zod.z.string().describe("Venue type (e.g., conference, journal)").nullable().optional(),
+	alternate_names: zod.z.array(zod.z.string()).describe("Alternative venue names").nullable().optional()
+}).describe("Publication venue details");
+const SemanticscholarGetPaperRecommendations_RecommendedPaperSchema = zod.z.object({
+	url: zod.z.string().describe("Paper URL on Semantic Scholar").nullable().optional(),
+	tldr: SemanticscholarGetPaperRecommendations_TldrSchema.nullable().optional(),
+	year: zod.z.number().int().describe("Publication year").nullable().optional(),
+	title: zod.z.string().describe("Paper title").nullable().optional(),
+	venue: zod.z.string().describe("Publication venue").nullable().optional(),
+	authors: zod.z.array(SemanticscholarGetPaperRecommendations_AuthorSchema).describe("Paper authors").nullable().optional(),
+	journal: SemanticscholarGetPaperRecommendations_JournalSchema.nullable().optional(),
+	paperId: zod.z.string().describe("Semantic Scholar paper ID"),
+	abstract: zod.z.string().describe("Paper abstract").nullable().optional(),
+	corpusId: zod.z.number().int().describe("Corpus ID").nullable().optional(),
+	embedding: zod.z.object({}).describe("Paper embedding vectors").nullable().optional(),
+	externalIds: zod.z.object({}).describe("External IDs (ArXiv, DOI, etc.)").nullable().optional(),
+	isOpenAccess: zod.z.boolean().describe("Whether paper is open access").nullable().optional(),
+	citationCount: zod.z.number().int().describe("Number of citations").nullable().optional(),
+	fieldsOfStudy: zod.z.array(zod.z.string()).describe("Fields of study").nullable().optional(),
+	openAccessPdf: SemanticscholarGetPaperRecommendations_OpenAccessPdfSchema.nullable().optional(),
+	citationStyles: zod.z.object({}).describe("Citation formats").nullable().optional(),
+	referenceCount: zod.z.number().int().describe("Number of references").nullable().optional(),
+	publicationDate: zod.z.string().describe("Publication date (YYYY-MM-DD)").nullable().optional(),
+	s2FieldsOfStudy: zod.z.array(SemanticscholarGetPaperRecommendations_S2FieldOfStudySchema).describe("Semantic Scholar field classifications").nullable().optional(),
+	publicationTypes: zod.z.array(zod.z.string()).describe("Publication types").nullable().optional(),
+	publicationVenue: SemanticscholarGetPaperRecommendations_PublicationVenueSchema.nullable().optional(),
+	influentialCitationCount: zod.z.number().int().describe("Number of influential citations").nullable().optional()
+}).describe("Recommended paper information");
+const SemanticscholarGetPaperRecommendationsOutput = zod.z.object({ recommendedPapers: zod.z.array(SemanticscholarGetPaperRecommendations_RecommendedPaperSchema).describe("List of recommended papers based on positive and negative examples") }).describe("Response schema for GetPaperRecommendations");
+const semanticscholarGetPaperRecommendations = require_action.action("SEMANTICSCHOLAR_GET_PAPER_RECOMMENDATIONS", {
+	slug: "semanticscholar-get-paper-recommendations",
+	name: "Get paper recommendations",
+	description: "Tool to get paper recommendations based on positive and negative example papers. Use when you need to find papers similar to ones you like (positive examples) and optionally dissimilar to ones you don't like (negative examples). The recommendation engine analyzes the provided examples and returns relevant papers from the Semantic Scholar database.",
+	input: SemanticscholarGetPaperRecommendationsInput,
+	output: SemanticscholarGetPaperRecommendationsOutput
+});
+//#endregion
+exports.semanticscholarGetPaperRecommendations = semanticscholarGetPaperRecommendations;
+
+//# sourceMappingURL=get-paper-recommendations.cjs.map