@inflexa-ai/harness 0.42.1 → 0.42.2

package/dist/agents/conversation-agent.js

@@ -29,7 +29,7 @@ import { conversationPrompt } from "../prompts/conversation.js";
 import { composeSystemPrompt } from "./system-prompt.js";
 // Bio-lookup leaf tools (pure — no dependencies).
 import { searchGeneTool, searchProteinTool, lookupAnnotationTool, searchInteractionsTool, alphafoldPredictionTool, chemblTool, pubchemTool, openTargetsTool, searchFaersTool, searchClinicalTrialsTool, searchGeoDatasetsTool, genePreclinicalProfileTool, targetSafetyTool, } from "../tools/bio/index.js";
-import { createNcbiTools, createChemDbTools } from "../tools/bio/keys.js";
+import { createAmassTools, createNcbiTools, createChemDbTools } from "../tools/bio/keys.js";
 // Dependency-bearing tool factories.
 import { createGeneratePlanTool, createInspectRunTool, createInspectDataProfileTool, createGenerateAnalogyReportTool, createSearchSemanticScholarTool, searchArxivTool, } from "../tools/research/index.js";
 import { createEditFileTool, createFileStatTool, createGrepTool, createListFilesTool, createReadFileTool, createSessionWorkspaceMutator, createShowPlanTool, createWorkspaceSearchTool, createWriteFileTool, showFileTool, } from "../tools/workspace/index.js";
@@ -52,6 +52,7 @@ export function createConversationAgent(deps) {
     const workingMemory = createWorkingMemory(pool);
     const ncbi = createNcbiTools(bioKeys);
     const chemDb = createChemDbTools(bioKeys, { ...(deps.logger ? { logger: deps.logger } : {}) });
+    const amass = createAmassTools(bioKeys);
     // The write path of this agent: coordinates resolve per call from the
     // session's analysis scope, the write prefix is the analysis root, and
     // every successful write emits a `write-file` provenance session event.
@@ -92,6 +93,9 @@ export function createConversationAgent(deps) {
         chemDb.drugGeneInteractions,
         searchFaersTool,
         searchClinicalTrialsTool,
+        // FDA and EMA authorizations with their label text, and patents (Amass; keyed).
+        amass.regulatoryApprovals,
+        amass.patents,
         searchGeoDatasetsTool,
         // Preclinical — baseline expression + mouse knockout in one call.
         genePreclinicalProfileTool,

package/dist/agents/sandbox/drug-repurposing-agent.js

@@ -32,6 +32,7 @@ export const meta = {
         "opentargets",
         "searchClinicalTrials",
         "searchFaers",
+        "searchRegulatoryApprovals",
         "geneDiseaseEvidence",
         "drugGeneInteractions",
         "genePreclinicalProfile",

package/dist/agents/sandbox/shared.js

@@ -28,7 +28,7 @@ import { createInspectRunTool } from "../../tools/research/inspect-run.js";
 import { createInspectDataProfileTool } from "../../tools/research/inspect-data-profile.js";
 // Bio leaf tools.
 import { chemblTool, genePreclinicalProfileTool, lookupAnnotationTool, openTargetsTool, pubchemTool, searchClinicalTrialsTool, searchFaersTool, searchGeneTool, searchGeoDatasetsTool, searchInteractionsTool, targetSafetyTool, } from "../../tools/bio/index.js";
-import { createNcbiTools, createChemDbTools } from "../../tools/bio/keys.js";
+import { createAmassTools, createNcbiTools, createChemDbTools } from "../../tools/bio/keys.js";
 // Workspace read surface.
 import { createFileStatTool, createGrepTool, createListFilesTool, createReadFileTool, createWorkspaceSearchTool } from "../../tools/workspace/index.js";
 import { createScanInputsTool } from "../../tools/workspace/scan-inputs.js";
@@ -58,6 +58,7 @@ export const BASE_SANDBOX_TOOLS = ["listAvailablePackages", "listAvailableRefs",
 function resolveSandboxTools(deps, tools) {
     const ncbi = createNcbiTools(deps.bioKeys);
     const chemDb = createChemDbTools(deps.bioKeys, { ...(deps.logger ? { logger: deps.logger } : {}) });
+    const amass = createAmassTools(deps.bioKeys);
     if (tools.includes("resolve_citation") && deps.citationResolver === undefined) {
         throw new Error('createSandboxAgent: SandboxToolName "resolve_citation" requires a CitationResolver dependency.');
     }
@@ -97,6 +98,7 @@ function resolveSandboxTools(deps, tools) {
         searchFaers: searchFaersTool,
         searchClinicalTrials: searchClinicalTrialsTool,
         searchGeoDatasets: searchGeoDatasetsTool,
+        searchRegulatoryApprovals: amass.regulatoryApprovals,
         targetSafety: targetSafetyTool,
         comptox: chemDb.comptox,
     };

package/dist/agents/sandbox/types.d.ts

@@ -12,7 +12,7 @@
  * in the tool's `perSource` report; the rest of the call still answers.
  */
 /** Closed allowlist of tools any sandbox agent may declare. */
-export type SandboxToolName = "listAvailablePackages" | "listAvailableRefs" | "scanInputs" | "resolveLibraryId" | "queryDocs" | "inspectRun" | "pubmed" | "resolve_citation" | "searchGene" | "lookupAnnotation" | "searchInteractions" | "chembl" | "pubchem" | "opentargets" | "geneDiseaseEvidence" | "drugGeneInteractions" | "genePreclinicalProfile" | "searchFaers" | "searchClinicalTrials" | "searchGeoDatasets" | "targetSafety" | "comptox";
+export type SandboxToolName = "listAvailablePackages" | "listAvailableRefs" | "scanInputs" | "resolveLibraryId" | "queryDocs" | "inspectRun" | "pubmed" | "resolve_citation" | "searchGene" | "lookupAnnotation" | "searchInteractions" | "chembl" | "pubchem" | "opentargets" | "geneDiseaseEvidence" | "drugGeneInteractions" | "genePreclinicalProfile" | "searchFaers" | "searchClinicalTrials" | "searchGeoDatasets" | "searchRegulatoryApprovals" | "targetSafety" | "comptox";
 /** Planner-facing metadata + tool allowlist for one sandbox agent. */
 export interface AgentMeta {
     /** Stable agent id — also the key in the catalog and the `AgentDefinition.id`. */

package/dist/prompts/sandbox/drug-repurposing-agent.d.ts

@@ -1 +1 @@
-export declare const drugRepurposingAgentPrompt = "# Drug Repurposing Agent\n\nYou are a computational drug repurposing specialist. You identify\nexisting drugs for new therapeutic indications using signature-based,\ntarget-based, network-based, and genetics-based approaches. You\nintegrate evidence from multiple sources to rank and prioritize\nrepurposing candidates.\n\n## Skills\n\nYour skills: `drug-repurposing`, `cheminformatics`,\n`genomic-variants`, `shared/omics-general`.\n\n`drug-repurposing` carries connectivity scoring, network proximity, genetic\nevidence scoring, and multi-evidence integration patterns. `cheminformatics`\nhas the RDKit/datamol API references for assessing candidate compound\nproperties. `genomic-variants` has the Mendelian randomization reference,\nthe test of whether a target's disease association is causal.\n\n## Keyed Sources\n\nSome sources need an API key that a deployment can lack. When a source is\nunavailable, skip the analyses that depend on it, note the gap, and do not\ninvent its output.\n\n- `drug_gene_interactions` \u2014 its `drugbank` source requires\n  DRUGBANK_API_KEY; `dgidb` (the default) and `pharmgkb` are public\n- `gene_disease_evidence` \u2014 its `disgenet` source requires\n  DISGENET_API_KEY; `gwas` and `clinvar` are public\n- EPA CTX tool (`comptox`, datasets toxcast / hazard / chemical /\n  exposure) \u2014 requires EPA_CCTE_API_KEY\n\nBoth multi-source tools report per-corpus availability in `perSource`:\nan unconfigured key degrades that ONE source to `unavailable` and the\nrest of the call still answers. Read `perSource` before concluding that\nevidence is absent.\n\n## Core Capabilities\n\n1. **Signature-based repurposing** \u2014 query disease DE signatures\n   against drug perturbation profiles using CMap-style connectivity\n   scoring (gseapy.prerank). Drugs that REVERSE the disease\n   signature are therapeutic candidates.\n\n2. **Target-based repurposing** \u2014 map disease-relevant targets to\n   existing drugs via ChEMBL (`chembl`, actions compounds / drug /\n   mechanism) and `drug_gene_interactions`.\n   Prioritize approved and clinical-stage drugs.\n\n3. **Genetics-based repurposing** \u2014 use `gene_disease_evidence` to\n   identify targets with causal disease links, then map to existing\n   drugs. Genetic support increases clinical success probability ~2x.\n\n4. **Network proximity analysis** \u2014 compute PPI network proximity\n   between drug target sets and disease gene modules. Closer\n   proximity = more likely to modulate disease biology.\n\n5. **Clinical evidence mining** \u2014 use `search_clinical_trials` to\n   check if candidates are already in trials for the target\n   indication. Use `pubmed` for published evidence.\n\n6. **Safety assessment** \u2014 use `search_faers` to assess real-world\n   safety for the proposed patient population. Flag drugs with\n   contraindications for the target indication.\n\n## Candidate Ranking\n\nChoose the repurposing approaches that the available data supports. Check\neach candidate against clinical trials, literature, and safety data, then\nrank candidates by a composite score across evidence lines. Report the\ncandidate table with its evidence breakdown, the evidence heatmap, and the\nlimitations.\n\n## Tool Usage for Candidate Discovery\n\n### From Targets (ChEMBL workflow)\n1. `chembl({action:\"targets\"})` \u2014 resolve gene symbols to target ChEMBL IDs.\n2. `chembl({action:\"compounds\", searchType:\"target\"})` \u2014 find active compounds.\n3. `chembl({action:\"drug\"})` \u2014 check approval status and existing indications.\n4. `chembl({action:\"mechanism\"})` \u2014 verify mechanism relevance.\n\n### From Targets (interaction workflow)\n1. `drug_gene_interactions({direction:\"gene_to_drugs\"})` \u2014 find drugs for\n   a gene set. Add `sources:[\"dgidb\",\"drugbank\"]` and\n   `includeDrugRecord:true` when you need the curated DrugBank record\n   (description, modality, approval groups) for a shortlisted candidate \u2014\n   not for the whole discovery sweep. DrugBank here carries no indication\n   and no toxicity.\n2. Take the existing indications from `chembl({action:\"drug\"})` and the\n   safety profile from `search_faers`.\n\n### From Genetic Evidence\n1. `gene_disease_evidence({queryType:\"disease\"})` \u2014 GWAS associations,\n   DisGeNET scores and ClinVar classifications for the indication in one\n   call.\n2. `opentargets({action:\"target\"})` \u2014 check target tractability and drug scores.\n\n### Validation Layer\n1. `search_clinical_trials` \u2014 existing trials for drug + indication.\n2. `search_faers` \u2014 adverse event profile.\n3. `pubmed` \u2014 published evidence.\n\n### Preclinical Target Intelligence\n1. `gene_preclinical_profile` (geneSymbol) \u2014 returns both halves in one\n   call: cross-species baseline expression, confirming the target is\n   expressed in tissues relevant to the new indication and that\n   model-organism surrogates are sensible; and the mouse-KO phenotype +\n   viability (per-zygosity breakdown plus a derived top-line lethal /\n   subviable / viable). A complete-penetrance lethal KO is a hard\n   tractability flag; a clean viable KO with no organ-system phenotypes\n   is a positive tractability signal.\n2. Treat empty/null outputs as valid \"no data\" (not all genes have\n   IMPC mouse lines; Bgee can be sparse for dog/macaque). Do NOT retry.\n\n## Required Figures\n\n- **Candidate ranking bar chart** \u2014 top candidates by composite\n  score, colored by number of evidence lines.\n- **Evidence heatmap** \u2014 candidates x evidence types, showing which\n  evidence supports each candidate.\n- **Connectivity score plot** \u2014 NES distribution for signature-based\n  hits (if applicable).\n\n## Domain Anti-Patterns\n\n- Presenting computational repurposing candidates as validated\n  therapeutics. They are hypotheses.\n- Connectivity scoring without permutation significance testing.\n- Ranking candidates by a single evidence type.\n- Ignoring existing indications \u2014 a drug already approved for the\n  target disease is not a repurposing candidate.\n- Skipping safety assessment for proposed new patient populations.\n- Using outdated perturbation databases without noting the version.\n- Ignoring drug-drug interactions when proposing repurposed drugs for\n  patients likely on existing therapies.\n\n## Output Naming\n\n- `output/repurposing_candidates.csv` \u2014 ranked candidate table\n  with drug, existing indication, proposed indication, composite\n  score, evidence components, development stage.\n- `output/connectivity_results.csv` \u2014 full connectivity scoring\n  results (if signature-based).\n- `output/genetic_evidence.csv` \u2014 per-target genetic evidence\n  scores (if genetics-based).\n- `figures/candidate_ranking.{png,pdf}`\n- `figures/evidence_heatmap.{png,pdf}`\n";
+export declare const drugRepurposingAgentPrompt = "# Drug Repurposing Agent\n\nYou are a computational drug repurposing specialist. You identify\nexisting drugs for new therapeutic indications using signature-based,\ntarget-based, network-based, and genetics-based approaches. You\nintegrate evidence from multiple sources to rank and prioritize\nrepurposing candidates.\n\n## Skills\n\nYour skills: `drug-repurposing`, `cheminformatics`,\n`genomic-variants`, `shared/omics-general`.\n\n`drug-repurposing` carries connectivity scoring, network proximity, genetic\nevidence scoring, and multi-evidence integration patterns. `cheminformatics`\nhas the RDKit/datamol API references for assessing candidate compound\nproperties. `genomic-variants` has the Mendelian randomization reference,\nthe test of whether a target's disease association is causal.\n\n## Keyed Sources\n\nSome sources need an API key that a deployment can lack. When a source is\nunavailable, skip the analyses that depend on it, note the gap, and do not\ninvent its output.\n\n- `drug_gene_interactions` \u2014 its `drugbank` source requires\n  DRUGBANK_API_KEY; `dgidb` (the default) and `pharmgkb` are public\n- `gene_disease_evidence` \u2014 its `disgenet` source requires\n  DISGENET_API_KEY; `gwas` and `clinvar` are public\n- EPA CTX tool (`comptox`, datasets toxcast / hazard / chemical /\n  exposure) \u2014 requires EPA_CCTE_API_KEY\n- `search_regulatory_approvals` (FDA and EMA authorizations and their\n  label text) \u2014 requires AMASS_API_KEY\n\nBoth multi-source tools report per-corpus availability in `perSource`:\nan unconfigured key degrades that ONE source to `unavailable` and the\nrest of the call still answers. Read `perSource` before concluding that\nevidence is absent.\n\n## Core Capabilities\n\n1. **Signature-based repurposing** \u2014 query disease DE signatures\n   against drug perturbation profiles using CMap-style connectivity\n   scoring (gseapy.prerank). Drugs that REVERSE the disease\n   signature are therapeutic candidates.\n\n2. **Target-based repurposing** \u2014 map disease-relevant targets to\n   existing drugs via ChEMBL (`chembl`, actions compounds / drug /\n   mechanism) and `drug_gene_interactions`.\n   Prioritize approved and clinical-stage drugs.\n\n3. **Genetics-based repurposing** \u2014 use `gene_disease_evidence` to\n   identify targets with causal disease links, then map to existing\n   drugs. Genetic support increases clinical success probability ~2x.\n\n4. **Network proximity analysis** \u2014 compute PPI network proximity\n   between drug target sets and disease gene modules. Closer\n   proximity = more likely to modulate disease biology.\n\n5. **Clinical evidence mining** \u2014 use `search_clinical_trials` to\n   check if candidates are already in trials for the target\n   indication. Use `pubmed` for published evidence.\n\n6. **Safety assessment** \u2014 use `search_faers` to assess real-world\n   safety for the proposed patient population. Flag drugs with\n   contraindications for the target indication.\n\n## Candidate Ranking\n\nChoose the repurposing approaches that the available data supports. Check\neach candidate against clinical trials, literature, and safety data, then\nrank candidates by a composite score across evidence lines. Report the\ncandidate table with its evidence breakdown, the evidence heatmap, and the\nlimitations.\n\n## Tool Usage for Candidate Discovery\n\n### From Targets (ChEMBL workflow)\n1. `chembl({action:\"targets\"})` \u2014 resolve gene symbols to target ChEMBL IDs.\n2. `chembl({action:\"compounds\", searchType:\"target\"})` \u2014 find active compounds.\n3. `chembl({action:\"drug\"})` \u2014 check approval status and existing indications.\n4. `chembl({action:\"mechanism\"})` \u2014 verify mechanism relevance.\n\n### From Targets (interaction workflow)\n1. `drug_gene_interactions({direction:\"gene_to_drugs\"})` \u2014 find drugs for\n   a gene set. Add `sources:[\"dgidb\",\"drugbank\"]` and\n   `includeDrugRecord:true` when you need the curated DrugBank record\n   (description, modality, approval groups) for a shortlisted candidate \u2014\n   not for the whole discovery sweep. DrugBank here carries no indication\n   and no toxicity.\n2. Take the existing indications from `chembl({action:\"drug\"})` and the\n   safety profile from `search_faers`.\n\n### From Genetic Evidence\n1. `gene_disease_evidence({queryType:\"disease\"})` \u2014 GWAS associations,\n   DisGeNET scores and ClinVar classifications for the indication in one\n   call.\n2. `opentargets({action:\"target\"})` \u2014 check target tractability and drug scores.\n\n### Validation Layer\n1. `search_clinical_trials` \u2014 existing trials for drug + indication.\n2. `search_faers` \u2014 adverse event profile.\n3. `pubmed` \u2014 published evidence.\n4. `search_regulatory_approvals` \u2014 the authorization status of a\n   candidate at the FDA and the EMA, its approved indications, its\n   designations, and the safety sections of its label (boxed warning,\n   contraindications). Read the matched excerpts of a search first, then\n   only the `section` that you cite.\n\n### Preclinical Target Intelligence\n1. `gene_preclinical_profile` (geneSymbol) \u2014 returns both halves in one\n   call: cross-species baseline expression, confirming the target is\n   expressed in tissues relevant to the new indication and that\n   model-organism surrogates are sensible; and the mouse-KO phenotype +\n   viability (per-zygosity breakdown plus a derived top-line lethal /\n   subviable / viable). A complete-penetrance lethal KO is a hard\n   tractability flag; a clean viable KO with no organ-system phenotypes\n   is a positive tractability signal.\n2. Treat empty/null outputs as valid \"no data\" (not all genes have\n   IMPC mouse lines; Bgee can be sparse for dog/macaque). Do NOT retry.\n\n## Required Figures\n\n- **Candidate ranking bar chart** \u2014 top candidates by composite\n  score, colored by number of evidence lines.\n- **Evidence heatmap** \u2014 candidates x evidence types, showing which\n  evidence supports each candidate.\n- **Connectivity score plot** \u2014 NES distribution for signature-based\n  hits (if applicable).\n\n## Domain Anti-Patterns\n\n- Presenting computational repurposing candidates as validated\n  therapeutics. They are hypotheses.\n- Connectivity scoring without permutation significance testing.\n- Ranking candidates by a single evidence type.\n- Ignoring existing indications \u2014 a drug already approved for the\n  target disease is not a repurposing candidate.\n- Skipping safety assessment for proposed new patient populations.\n- Using outdated perturbation databases without noting the version.\n- Ignoring drug-drug interactions when proposing repurposed drugs for\n  patients likely on existing therapies.\n\n## Output Naming\n\n- `output/repurposing_candidates.csv` \u2014 ranked candidate table\n  with drug, existing indication, proposed indication, composite\n  score, evidence components, development stage.\n- `output/connectivity_results.csv` \u2014 full connectivity scoring\n  results (if signature-based).\n- `output/genetic_evidence.csv` \u2014 per-target genetic evidence\n  scores (if genetics-based).\n- `figures/candidate_ranking.{png,pdf}`\n- `figures/evidence_heatmap.{png,pdf}`\n";

package/dist/prompts/sandbox/drug-repurposing-agent.js

@@ -29,6 +29,8 @@ invent its output.
   DISGENET_API_KEY; \`gwas\` and \`clinvar\` are public
 - EPA CTX tool (\`comptox\`, datasets toxcast / hazard / chemical /
   exposure) — requires EPA_CCTE_API_KEY
+- \`search_regulatory_approvals\` (FDA and EMA authorizations and their
+  label text) — requires AMASS_API_KEY
 
 Both multi-source tools report per-corpus availability in \`perSource\`:
 an unconfigured key degrades that ONE source to \`unavailable\` and the
@@ -99,6 +101,11 @@ limitations.
 1. \`search_clinical_trials\` — existing trials for drug + indication.
 2. \`search_faers\` — adverse event profile.
 3. \`pubmed\` — published evidence.
+4. \`search_regulatory_approvals\` — the authorization status of a
+   candidate at the FDA and the EMA, its approved indications, its
+   designations, and the safety sections of its label (boxed warning,
+   contraindications). Read the matched excerpts of a search first, then
+   only the \`section\` that you cite.
 
 ### Preclinical Target Intelligence
 1. \`gene_preclinical_profile\` (geneSymbol) — returns both halves in one

package/dist/tools/bio/index.d.ts

@@ -34,5 +34,7 @@ export * from "./gene-preclinical-profile.js";
 export * from "./search-clinical-trials.js";
 export * from "./search-geo-datasets.js";
 export * from "./search-faers.js";
+export * from "./search-regulatory-approvals.js";
+export * from "./search-patents.js";
 export * from "./target-safety.js";
 export * from "./comptox.js";

package/dist/tools/bio/index.js

@@ -41,6 +41,9 @@ export * from "./gene-preclinical-profile.js";
 export * from "./search-clinical-trials.js";
 export * from "./search-geo-datasets.js";
 export * from "./search-faers.js";
+// Regulatory authorizations and patents (Amass)
+export * from "./search-regulatory-approvals.js";
+export * from "./search-patents.js";
 // Safety / toxicology
 export * from "./target-safety.js";
 export * from "./comptox.js";

package/dist/tools/bio/keys.d.ts

@@ -14,6 +14,7 @@ export interface BioToolKeys {
     readonly ncbi?: string;
     readonly github?: string;
     readonly semanticScholar?: string;
+    readonly amass?: string;
 }
 /**
  * The NCBI-backed literature tool, built from the shared key slice.
@@ -43,3 +44,13 @@ export declare function createChemDbTools(keys: BioToolKeys, deps?: {
     drugGeneInteractions: Tool;
     comptox: Tool;
 };
+/**
+ * The Amass tools: FDA and EMA authorizations, and patents.
+ *
+ * The key is optional. With no key, each tool is still built, and a call throws
+ * before it reaches Amass, the same as `comptox` without its EPA key.
+ */
+export declare function createAmassTools(keys: BioToolKeys): {
+    regulatoryApprovals: Tool;
+    patents: Tool;
+};

package/dist/tools/bio/keys.js

@@ -2,6 +2,8 @@ import { createComptoxTool } from "./comptox.js";
 import { createDrugGeneInteractionsTool } from "./drug-gene-interactions.js";
 import { createGeneDiseaseEvidenceTool } from "./gene-disease-evidence.js";
 import { createPubMedTool } from "./pubmed.js";
+import { createSearchPatentsTool } from "./search-patents.js";
+import { createSearchRegulatoryApprovalsTool } from "./search-regulatory-approvals.js";
 /**
  * The NCBI-backed literature tool, built from the shared key slice.
  *
@@ -39,3 +41,16 @@ export function createChemDbTools(keys, deps = {}) {
         comptox: createComptoxTool({ apiKey: keys.epaCcte }),
     };
 }
+/**
+ * The Amass tools: FDA and EMA authorizations, and patents.
+ *
+ * The key is optional. With no key, each tool is still built, and a call throws
+ * before it reaches Amass, the same as `comptox` without its EPA key.
+ */
+export function createAmassTools(keys) {
+    const apiKey = keys.amass ?? "";
+    return {
+        regulatoryApprovals: createSearchRegulatoryApprovalsTool({ apiKey }),
+        patents: createSearchPatentsTool({ apiKey }),
+    };
+}

package/dist/tools/bio/search-clinical-trials.d.ts

@@ -26,6 +26,6 @@ export declare const searchClinicalTrialsTool: import("../define-tool.js").Tool<
     query?: string | undefined;
     nctId?: string | undefined;
     phase?: "EARLY_PHASE1" | "PHASE1" | "PHASE2" | "PHASE3" | "PHASE4" | undefined;
-    status?: "RECRUITING" | "ACTIVE_NOT_RECRUITING" | "COMPLETED" | "NOT_YET_RECRUITING" | "TERMINATED" | "WITHDRAWN" | "SUSPENDED" | undefined;
+    status?: "SUSPENDED" | "RECRUITING" | "ACTIVE_NOT_RECRUITING" | "COMPLETED" | "NOT_YET_RECRUITING" | "TERMINATED" | "WITHDRAWN" | undefined;
 }, ClinicalTrialsOutput>;
 export {};

package/dist/tools/bio/search-patents.d.ts

@@ -0,0 +1,46 @@
+/**
+ * search_patents — patents from Amass PatentCore behind one `action`
+ * discriminator: a search that returns no claims and no description, and the
+ * details of one patent, with the claims and the description on request.
+ *
+ * The input is a flat object with an `action` discriminator — not a
+ * `z.discriminatedUnion`, which `defineTool` rejects (model tool calling needs a
+ * top-level `"type":"object"`).
+ */
+import { type PatentRecord, type PatentSummary } from "../lib/amass-client.js";
+type PatentsOutput = {
+    patents: PatentSummary[];
+} | {
+    status: "found";
+    patent: PatentRecord;
+} | {
+    status: "not_found";
+} | {
+    status: "ambiguous";
+    candidates: string[];
+};
+export declare function createSearchPatentsTool(deps: {
+    apiKey: string;
+}): import("../define-tool.js").Tool<{
+    action: "search" | "details";
+    limit: number;
+    includeClaims: boolean;
+    includeDescription: boolean;
+    query?: string | undefined;
+    assignee?: string[] | undefined;
+    inventor?: string | undefined;
+    cpcCodes?: string[] | undefined;
+    countryCode?: string[] | undefined;
+    minPublicationDate?: string | undefined;
+    maxPublicationDate?: string | undefined;
+    minFilingDate?: string | undefined;
+    maxFilingDate?: string | undefined;
+    minPriorityDate?: string | undefined;
+    maxPriorityDate?: string | undefined;
+    minGrantDate?: string | undefined;
+    maxGrantDate?: string | undefined;
+    amassId?: string | undefined;
+    publicationNumber?: string | undefined;
+    applicationNumber?: string | undefined;
+}, PatentsOutput>;
+export {};

package/dist/tools/bio/search-patents.js

@@ -0,0 +1,134 @@
+/**
+ * search_patents — patents from Amass PatentCore behind one `action`
+ * discriminator: a search that returns no claims and no description, and the
+ * details of one patent, with the claims and the description on request.
+ *
+ * The input is a flat object with an `action` discriminator — not a
+ * `z.discriminatedUnion`, which `defineTool` rejects (model tool calling needs a
+ * top-level `"type":"object"`).
+ */
+import { err, ok } from "neverthrow";
+import { z } from "zod";
+import { defineTool } from "../define-tool.js";
+import { describeAmassError, getPatentRecord, lookupPatentIds, searchPatentRecords, } from "../lib/amass-client.js";
+import { getAmassHeaders } from "../lib/amass-config.js";
+/** The largest `limit` that still costs one search price (5 credits for each 20 records). */
+const MAX_LIMIT = 20;
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const IDENTIFIER_FIELDS = ["amassId", "publicationNumber", "applicationNumber"];
+function dateField(description) {
+    return z.string().regex(ISO_DATE).optional().describe(`'search' only. ${description}, YYYY-MM-DD.`);
+}
+const inputSchema = z
+    .object({
+    action: z
+        .enum(["search", "details"])
+        .default("search")
+        .describe("'search' (default) — find patents with `query`. 'details' — read one patent by ONE identifier."),
+    query: z
+        .string()
+        .optional()
+        .describe("Required for 'search'. Keywords matched over the title, the abstract, the claims and the description: a compound, a target, a " +
+        "method or a formulation ('imatinib mesylate crystal form', 'KRAS G12C inhibitor')."),
+    assignee: z.array(z.string()).optional().describe("'search' only. Keep the patents of any of these assignees, e.g. ['Novartis']."),
+    inventor: z.string().optional().describe("'search' only. Keep the patents of this inventor name."),
+    cpcCodes: z.array(z.string()).optional().describe("'search' only. Keep these Cooperative Patent Classification codes, e.g. ['A61K', 'C07D']."),
+    countryCode: z.array(z.string()).optional().describe("'search' only. Keep these jurisdictions, e.g. ['US', 'EP', 'WO']."),
+    minPublicationDate: dateField("Earliest publication date"),
+    maxPublicationDate: dateField("Latest publication date"),
+    minFilingDate: dateField("Earliest filing date"),
+    maxFilingDate: dateField("Latest filing date"),
+    minPriorityDate: dateField("Earliest priority date — the effective date of the invention, the one for prior art"),
+    maxPriorityDate: dateField("Latest priority date"),
+    minGrantDate: dateField("Earliest grant date (drops each patent that was never granted)"),
+    maxGrantDate: dateField("Latest grant date"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_LIMIT)
+        .default(10)
+        .describe(`'search' only. Max patents to return (default 10, max ${MAX_LIMIT}). There are no pages: narrow with the filters.`),
+    amassId: z.string().optional().describe("'details' only. The Amass ID of one patent ('AMPC_…'), as a search returns it."),
+    publicationNumber: z.string().optional().describe("'details' only. A publication number, e.g. 'US-10266485-B2'."),
+    applicationNumber: z.string().optional().describe("'details' only. An application number; it can match more than one publication."),
+    includeClaims: z.boolean().default(false).describe("'details' only. Add the full claims text. It can run to tens of thousands of characters."),
+    includeDescription: z
+        .boolean()
+        .default(false)
+        .describe("'details' only. Add the full description text. It is often longer than the claims; ask for it only when you must read it."),
+})
+    .refine((d) => d.action !== "search" || (d.query !== undefined && d.query.trim().length > 0), {
+    message: "query is required when action is 'search'.",
+    path: ["query"],
+})
+    .refine((d) => d.action !== "details" || IDENTIFIER_FIELDS.filter((field) => d[field] !== undefined).length === 1, {
+    message: "action 'details' takes exactly one of amassId, publicationNumber, and applicationNumber.",
+    path: ["action"],
+});
+/** A request that Amass rejected as invalid is the caller's to repair; every other failure is terminal. */
+function failure(e) {
+    if (e.type === "invalid_input")
+        return err({ error: describeAmassError(e), retryable: false, cause: e });
+    throw new Error(describeAmassError(e));
+}
+export function createSearchPatentsTool(deps) {
+    return defineTool({
+        id: "search_patents",
+        description: "Patents from Amass PatentCore, across the patent offices (US, EP, WO, CN, JP, …), with one member for each patent family: the " +
+            "title, the abstract, the assignees, the inventors, the CPC codes, the priority, filing, publication and grant dates, and the citation " +
+            "counts. Answers 'who patented this compound, target or method, and when?' and 'what does this patent claim?'.\n" +
+            "action 'search' (the default) returns patents with no claims and no description. action 'details' takes ONE identifier and returns " +
+            "the patent with its family members; set includeClaims or includeDescription for the full text.\n" +
+            "ACCEPTED IDENTIFIERS for 'details': amassId ('AMPC_…'), publicationNumber ('US-10266485-B2') or applicationNumber.\n" +
+            "status 'not_found' is a valid no-data answer and status 'ambiguous' lists the candidate amassIds of an application number that " +
+            "matches more than one publication — call 'details' again with one of them. An empty search is also valid no-data. Do not retry any " +
+            "of these unchanged.\n" +
+            "Requires AMASS_API_KEY — a missing key fails terminally: do NOT retry, tell the user the key needs configuring and proceed without " +
+            "Amass patent data. Every call spends the user's Amass credits.",
+        inputSchema,
+        describeCall: "none",
+        execute: async (input) => {
+            const headers = getAmassHeaders(deps.apiKey);
+            if (input.action === "search") {
+                const patents = await searchPatentRecords({
+                    query: input.query,
+                    limit: input.limit,
+                    ...(input.assignee ? { assignee: input.assignee } : {}),
+                    ...(input.inventor ? { inventor: input.inventor } : {}),
+                    ...(input.cpcCodes ? { cpcCodes: input.cpcCodes } : {}),
+                    ...(input.countryCode ? { countryCode: input.countryCode } : {}),
+                    ...(input.minPublicationDate ? { minPublicationDate: input.minPublicationDate } : {}),
+                    ...(input.maxPublicationDate ? { maxPublicationDate: input.maxPublicationDate } : {}),
+                    ...(input.minFilingDate ? { minFilingDate: input.minFilingDate } : {}),
+                    ...(input.maxFilingDate ? { maxFilingDate: input.maxFilingDate } : {}),
+                    ...(input.minPriorityDate ? { minPriorityDate: input.minPriorityDate } : {}),
+                    ...(input.maxPriorityDate ? { maxPriorityDate: input.maxPriorityDate } : {}),
+                    ...(input.minGrantDate ? { minGrantDate: input.minGrantDate } : {}),
+                    ...(input.maxGrantDate ? { maxGrantDate: input.maxGrantDate } : {}),
+                }, headers);
+                if (patents.isErr())
+                    return failure(patents.error);
+                return ok({ patents: patents.value });
+            }
+            let amassId = input.amassId;
+            if (amassId === undefined) {
+                const ids = await lookupPatentIds({
+                    ...(input.publicationNumber === undefined ? {} : { publicationNumber: input.publicationNumber }),
+                    ...(input.applicationNumber === undefined ? {} : { applicationNumber: input.applicationNumber }),
+                }, headers);
+                if (ids.isErr())
+                    return failure(ids.error);
+                if (ids.value.length === 0)
+                    return ok({ status: "not_found" });
+                if (ids.value.length > 1)
+                    return ok({ status: "ambiguous", candidates: ids.value });
+                amassId = ids.value[0];
+            }
+            const patent = await getPatentRecord(amassId, { claims: input.includeClaims, description: input.includeDescription }, headers);
+            if (patent.isErr())
+                return failure(patent.error);
+            return ok(patent.value ? { status: "found", patent: patent.value } : { status: "not_found" });
+        },
+    });
+}

package/dist/tools/bio/search-regulatory-approvals.d.ts

@@ -0,0 +1,49 @@
+/**
+ * search_regulatory_approvals — the FDA and EMA drug authorizations of Amass
+ * RegulatoryCore, with the parsed sections of their labels, reviews, SmPCs and
+ * EPARs, behind one `action` discriminator.
+ *
+ * The three actions read the text in three sizes: `search` gives the matched
+ * excerpts, `details` the table of contents, and `section` the full text of one
+ * section. Thus an agent reads only the section that it cites.
+ *
+ * The input is a flat object with an `action` discriminator — not a
+ * `z.discriminatedUnion`, which `defineTool` rejects (model tool calling needs a
+ * top-level `"type":"object"`).
+ */
+import { type AuthorizationRecord, type AuthorizationSearchRow, type RegulatorySection } from "../lib/amass-client.js";
+type RegulatoryApprovalsOutput = {
+    authorizations: AuthorizationSearchRow[];
+} | {
+    status: "found";
+    authorization: AuthorizationRecord;
+} | {
+    status: "found";
+    section: RegulatorySection;
+} | {
+    status: "not_found";
+} | {
+    status: "ambiguous";
+    candidates: string[];
+};
+export declare function createSearchRegulatoryApprovalsTool(deps: {
+    apiKey: string;
+}): import("../define-tool.js").Tool<{
+    action: "search" | "details" | "section";
+    limit: number;
+    query?: string | undefined;
+    agency?: ("FDA" | "EMA")[] | undefined;
+    authorizationStatus?: ("UNKNOWN" | "ACTIVE" | "APPROVED_NOT_MARKETED" | "CONDITIONAL" | "SUSPENDED" | "WITHDRAWN_VOLUNTARY" | "WITHDRAWN_FORCED" | "REVOKED" | "LAPSED_SUNSET" | "REFUSED" | "WITHDRAWN_DURING_REVIEW" | "EXPIRED")[] | undefined;
+    moleculeType?: ("UNKNOWN" | "SMALL_MOLECULE" | "ANTIBODY" | "PROTEIN" | "ENZYME" | "OLIGONUCLEOTIDE" | "GENE" | "CELL" | "ANTIBODY_DRUG_CONJUGATE" | "VACCINE_COMPONENT" | "VACCINE" | "OLIGOSACCHARIDE")[] | undefined;
+    hasDesignation?: ("PRIORITY_REVIEW" | "BREAKTHROUGH_THERAPY" | "FAST_TRACK" | "RMAT" | "ACCELERATED_APPROVAL" | "ACCELERATED_ASSESSMENT" | "PRIME" | "CONDITIONAL_MA" | "EXCEPTIONAL_CIRCUMSTANCES")[] | undefined;
+    isOrphan?: boolean | undefined;
+    minAuthorizationDate?: string | undefined;
+    maxAuthorizationDate?: string | undefined;
+    amassId?: string | undefined;
+    fdaApplicationNumber?: string | undefined;
+    emaProductNumber?: string | undefined;
+    ndc?: string | undefined;
+    splSetId?: string | undefined;
+    documentSectionId?: string | undefined;
+}, RegulatoryApprovalsOutput>;
+export {};

package/dist/tools/bio/search-regulatory-approvals.js

@@ -0,0 +1,158 @@
+/**
+ * search_regulatory_approvals — the FDA and EMA drug authorizations of Amass
+ * RegulatoryCore, with the parsed sections of their labels, reviews, SmPCs and
+ * EPARs, behind one `action` discriminator.
+ *
+ * The three actions read the text in three sizes: `search` gives the matched
+ * excerpts, `details` the table of contents, and `section` the full text of one
+ * section. Thus an agent reads only the section that it cites.
+ *
+ * The input is a flat object with an `action` discriminator — not a
+ * `z.discriminatedUnion`, which `defineTool` rejects (model tool calling needs a
+ * top-level `"type":"object"`).
+ */
+import { err, ok } from "neverthrow";
+import { z } from "zod";
+import { defineTool } from "../define-tool.js";
+import { describeAmassError, getRegulatoryRecord, getRegulatorySection, lookupRegulatoryIds, MAX_MATCHED_SECTIONS, REGULATORY_AGENCIES, REGULATORY_AUTHORIZATION_STATUSES, REGULATORY_DESIGNATIONS, REGULATORY_MOLECULE_TYPES, searchRegulatoryRecords, } from "../lib/amass-client.js";
+import { getAmassHeaders } from "../lib/amass-config.js";
+/** The largest `limit` that still costs one search price (5 credits for each 20 records). */
+const MAX_LIMIT = 20;
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const IDENTIFIER_FIELDS = ["amassId", "fdaApplicationNumber", "emaProductNumber", "ndc", "splSetId"];
+const inputSchema = z
+    .object({
+    action: z
+        .enum(["search", "details", "section"])
+        .default("search")
+        .describe("'search' (default) — find authorizations with `query`. 'details' — read one authorization and the table of contents of its " +
+        "source documents, by ONE identifier. 'section' — read the full text of one document section, by `amassId` and `documentSectionId`."),
+    query: z
+        .string()
+        .optional()
+        .describe("Required for 'search'. Free text matched across the product metadata and the full text of the source documents: a brand or " +
+        "substance name ('Gleevec', 'imatinib'), an indication, or a label topic ('hepatotoxicity', 'QT prolongation')."),
+    agency: z.array(z.enum(REGULATORY_AGENCIES)).optional().describe("'search' only. Keep the authorizations of these agencies. Omit for both."),
+    authorizationStatus: z
+        .array(z.enum(REGULATORY_AUTHORIZATION_STATUSES))
+        .optional()
+        .describe("'search' only. Keep these authorization statuses, e.g. ['ACTIVE'] or the withdrawals. Omit for every status."),
+    moleculeType: z.array(z.enum(REGULATORY_MOLECULE_TYPES)).optional().describe("'search' only. Keep these molecule types."),
+    hasDesignation: z
+        .array(z.enum(REGULATORY_DESIGNATIONS))
+        .optional()
+        .describe("'search' only. Keep the authorizations that carry any of these designations."),
+    isOrphan: z.boolean().optional().describe("'search' only. true keeps the FDA Orphan Drug / EMA Orphan Medicine authorizations; false drops them."),
+    minAuthorizationDate: z.string().regex(ISO_DATE).optional().describe("'search' only. Earliest authorization date, YYYY-MM-DD."),
+    maxAuthorizationDate: z.string().regex(ISO_DATE).optional().describe("'search' only. Latest authorization date, YYYY-MM-DD."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_LIMIT)
+        .default(10)
+        .describe(`'search' only. Max authorizations to return (default 10, max ${MAX_LIMIT}). There are no pages: narrow with the filters.`),
+    amassId: z
+        .string()
+        .optional()
+        .describe("The Amass ID of one authorization ('AMRC_…'), as a search returns it. With 'search' it limits the full-text match to the documents " +
+        "of that one record. With 'details' it is the identifier. 'section' requires it."),
+    fdaApplicationNumber: z
+        .string()
+        .optional()
+        .describe("'details' only. An FDA application number: 'NDA021588', 'BLA125085', or the bare '021588' (each prefix is tried)."),
+    emaProductNumber: z.string().optional().describe("'details' only. An EMA product number, e.g. 'EMEA/H/C/000406'."),
+    ndc: z.string().optional().describe("'details' only. A US National Drug Code, as the product code '0078-0401' or the package code '0078-0401-05'."),
+    splSetId: z.string().optional().describe("'details' only. The Set ID of an FDA Structured Product Label."),
+    documentSectionId: z
+        .string()
+        .optional()
+        .describe("Required for 'section'. One section ID ('AMRCDS_…') from a search excerpt or from the table of contents of 'details'."),
+})
+    .refine((d) => d.action !== "search" || (d.query !== undefined && d.query.trim().length > 0), {
+    message: "query is required when action is 'search'.",
+    path: ["query"],
+})
+    .refine((d) => d.action !== "details" || IDENTIFIER_FIELDS.filter((field) => d[field] !== undefined).length === 1, {
+    message: "action 'details' takes exactly one of amassId, fdaApplicationNumber, emaProductNumber, ndc, and splSetId.",
+    path: ["action"],
+})
+    .refine((d) => d.action !== "section" || (d.amassId !== undefined && d.documentSectionId !== undefined), {
+    message: "action 'section' requires both amassId and documentSectionId.",
+    path: ["documentSectionId"],
+});
+/** A request that Amass rejected as invalid is the caller's to repair; every other failure is terminal. */
+function failure(e) {
+    if (e.type === "invalid_input")
+        return err({ error: describeAmassError(e), retryable: false, cause: e });
+    throw new Error(describeAmassError(e));
+}
+export function createSearchRegulatoryApprovalsTool(deps) {
+    return defineTool({
+        id: "search_regulatory_approvals",
+        description: "The drug authorizations of the U.S. Food and Drug Administration (FDA) and the European Medicines Agency (EMA), from Amass " +
+            "RegulatoryCore: the status, the approved indication, the marketing authorization holder, the dates, the orphan status and the " +
+            "designations (breakthrough, PRIME, accelerated approval, …), plus the full text of the source documents — FDA labels and reviews, " +
+            "EMA SmPCs and EPARs — parsed into sections. Answers 'is this drug approved, where, and for what?', 'what does its label say about X?', " +
+            "and 'which drugs carry this designation?'.\n" +
+            "action 'search' (the default) returns authorizations, each with at most " +
+            `${MAX_MATCHED_SECTIONS} matched document sections (a matchedText excerpt each) and matchedSectionCount, the true count. ` +
+            "action 'details' takes ONE identifier and returns the authorization with the FDA or EMA specifics (application number, NDCs, SmPC, " +
+            "withdrawal) and the table of contents of its documents, with no text. action 'section' returns the full text of one section. Read in " +
+            "that order: the excerpt, then the table of contents, then only the section to cite.\n" +
+            "ACCEPTED IDENTIFIERS for 'details': amassId ('AMRC_…'), fdaApplicationNumber ('NDA021588'; a bare number is tried as NDA, BLA and " +
+            "ANDA), emaProductNumber, ndc (product or package code) or splSetId.\n" +
+            "status 'not_found' is a valid no-data answer and status 'ambiguous' lists the candidate amassIds of an identifier that matches more " +
+            "than one record — call 'details' again with one of them. An empty search is also valid no-data. Do not retry any of these unchanged.\n" +
+            "Requires AMASS_API_KEY — a missing key fails terminally: do NOT retry, tell the user the key needs configuring and proceed without " +
+            "Amass regulatory data. Every call spends the user's Amass credits.",
+        inputSchema,
+        describeCall: "none",
+        execute: async (input) => {
+            const headers = getAmassHeaders(deps.apiKey);
+            if (input.action === "search") {
+                const rows = await searchRegulatoryRecords({
+                    query: input.query,
+                    limit: input.limit,
+                    ...(input.agency ? { agency: input.agency } : {}),
+                    ...(input.authorizationStatus ? { authorizationStatus: input.authorizationStatus } : {}),
+                    ...(input.moleculeType ? { moleculeType: input.moleculeType } : {}),
+                    ...(input.hasDesignation ? { hasDesignation: input.hasDesignation } : {}),
+                    ...(input.isOrphan === undefined ? {} : { isOrphan: input.isOrphan }),
+                    ...(input.minAuthorizationDate ? { minAuthorizationDate: input.minAuthorizationDate } : {}),
+                    ...(input.maxAuthorizationDate ? { maxAuthorizationDate: input.maxAuthorizationDate } : {}),
+                    ...(input.amassId ? { amassId: input.amassId } : {}),
+                }, headers);
+                if (rows.isErr())
+                    return failure(rows.error);
+                return ok({ authorizations: rows.value });
+            }
+            if (input.action === "section") {
+                const section = await getRegulatorySection(input.amassId, input.documentSectionId, headers);
+                if (section.isErr())
+                    return failure(section.error);
+                return ok(section.value ? { status: "found", section: section.value } : { status: "not_found" });
+            }
+            let amassId = input.amassId;
+            if (amassId === undefined) {
+                const ids = await lookupRegulatoryIds({
+                    ...(input.fdaApplicationNumber === undefined ? {} : { fdaApplicationNumber: input.fdaApplicationNumber }),
+                    ...(input.emaProductNumber === undefined ? {} : { emaProductNumber: input.emaProductNumber }),
+                    ...(input.ndc === undefined ? {} : { ndc: input.ndc }),
+                    ...(input.splSetId === undefined ? {} : { splSetId: input.splSetId }),
+                }, headers);
+                if (ids.isErr())
+                    return failure(ids.error);
+                if (ids.value.length === 0)
+                    return ok({ status: "not_found" });
+                if (ids.value.length > 1)
+                    return ok({ status: "ambiguous", candidates: ids.value });
+                amassId = ids.value[0];
+            }
+            const record = await getRegulatoryRecord(amassId, headers);
+            if (record.isErr())
+                return failure(record.error);
+            return ok(record.value ? { status: "found", authorization: record.value } : { status: "not_found" });
+        },
+    });
+}