@inflexa-ai/harness 0.42.0 → 0.42.2

package/dist/tools/lib/amass-client.d.ts

@@ -0,0 +1,586 @@
+/**
+ * Pure async client functions for the Amass Data Platform API: RegulatoryCore
+ * (the FDA and EMA authorizations, with the parsed sections of their labels,
+ * reviews, SmPCs and EPARs) and PatentCore (patents).
+ *
+ * The schemas mirror the published OpenAPI document
+ * (`https://api.amass.tech/api/doc/openapi.json`). A live key verified them on
+ * 2026-09-30, and the golden fixtures under `__fixtures__/amass/` hold those
+ * answers.
+ *
+ * Absence policy: a base field is always present, and an absent value is an
+ * explicit `null` (`therapeuticIndication`, `grantDate`). A field that only an
+ * `include` parameter adds (`fdaDetails`, `emaDetails`, `claims`,
+ * `description`) is an omitted key when the request does not ask for it. Thus
+ * a base field carries `.nullable()`, and an include field carries
+ * `.nullable().optional()`. A lookup item omits `amassIds` when it carries
+ * `error`, and omits `error` when it carries `amassIds`.
+ *
+ * A response enum is a plain string here. Amass grows those vocabularies, and
+ * one unknown value would otherwise reject a whole search. The input filters
+ * of the tools carry the enums of the OpenAPI document.
+ *
+ * Status policy: only a 404 and a lookup item with `NOT_FOUND` are an absence.
+ * `isUnexpectedApiError` reads every 4xx as an absence, which would turn a
+ * rejected key (401) or a refused organization (403) into "no such record".
+ * Thus this client classifies each status itself.
+ *
+ * Every call spends credits: a search costs 5 credits for each 20 records of
+ * `limit`, and a get, a lookup (whatever its item count) or a 404 costs 1.
+ */
+import { type ResultAsync } from "neverthrow";
+import { z } from "zod";
+import { type ApiError } from "./api-utils.js";
+/** The error channel of the client. `invalid_input` is the one outcome that the caller can repair. */
+export type AmassError = {
+    readonly type: "invalid_input";
+    readonly status: number;
+    readonly message: string;
+} | {
+    readonly type: "unauthorized";
+    readonly message: string;
+} | {
+    readonly type: "forbidden";
+    readonly message: string;
+} | {
+    readonly type: "rejected";
+    readonly status: number | null;
+    readonly code: string;
+    readonly message: string;
+} | {
+    readonly type: "api";
+    readonly error: ApiError;
+};
+/** Render an `AmassError` as a one-line message for the model or for a throw. */
+export declare function describeAmassError(e: AmassError): string;
+export declare const AmassErrorEnvelopeSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        status: z.ZodNumber;
+        code: z.ZodString;
+        message: z.ZodString;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const AmassLookupResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        input: z.ZodRecord<z.ZodString, z.ZodString>;
+        amassIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LookupItem = Readonly<Record<string, string>>;
+/**
+ * The lookup forms of an FDA application number. Amass stores the number with its
+ * prefix (`NDA021588`) and answers `NOT_FOUND` for the bare `021588`. A bare number
+ * thus goes as all three prefixes, in one request at the price of one.
+ */
+export declare function fdaApplicationForms(input: string): string[];
+/**
+ * The lookup form of an NDC. Amass stores the two-segment product NDC (`0078-0401`)
+ * and answers `NOT_FOUND` for the package NDC (`0078-0401-05`).
+ */
+export declare function productNdcOf(input: string): string;
+export declare const REGULATORY_AGENCIES: readonly ["FDA", "EMA"];
+export declare const REGULATORY_MOLECULE_TYPES: readonly ["SMALL_MOLECULE", "ANTIBODY", "PROTEIN", "ENZYME", "OLIGONUCLEOTIDE", "GENE", "CELL", "ANTIBODY_DRUG_CONJUGATE", "VACCINE_COMPONENT", "VACCINE", "OLIGOSACCHARIDE", "UNKNOWN"];
+export declare const REGULATORY_AUTHORIZATION_STATUSES: readonly ["ACTIVE", "APPROVED_NOT_MARKETED", "CONDITIONAL", "SUSPENDED", "WITHDRAWN_VOLUNTARY", "WITHDRAWN_FORCED", "REVOKED", "LAPSED_SUNSET", "REFUSED", "WITHDRAWN_DURING_REVIEW", "EXPIRED", "UNKNOWN"];
+export declare const REGULATORY_DESIGNATIONS: readonly ["PRIORITY_REVIEW", "BREAKTHROUGH_THERAPY", "FAST_TRACK", "RMAT", "ACCELERATED_APPROVAL", "ACCELERATED_ASSESSMENT", "PRIME", "CONDITIONAL_MA", "EXCEPTIONAL_CIRCUMSTANCES"];
+declare const FdaDetailsSchema: z.ZodObject<{
+    applicationNumber: z.ZodNullable<z.ZodString>;
+    prescriptionClass: z.ZodNullable<z.ZodString>;
+    submissionClassCode: z.ZodNullable<z.ZodString>;
+    labelDate: z.ZodNullable<z.ZodString>;
+    labelUrl: z.ZodNullable<z.ZodString>;
+    ndc: z.ZodArray<z.ZodString>;
+    splSetId: z.ZodArray<z.ZodString>;
+    withdrawalDate: z.ZodNullable<z.ZodString>;
+    withdrawalReason: z.ZodNullable<z.ZodString>;
+    withdrawalSourceUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const EmaDetailsSchema: z.ZodObject<{
+    productNumber: z.ZodNullable<z.ZodString>;
+    category: z.ZodNullable<z.ZodString>;
+    opinionStatus: z.ZodNullable<z.ZodString>;
+    isBiosimilar: z.ZodNullable<z.ZodBoolean>;
+    isAdvancedTherapy: z.ZodNullable<z.ZodBoolean>;
+    isGenericOrHybrid: z.ZodNullable<z.ZodBoolean>;
+    additionalMonitoring: z.ZodNullable<z.ZodBoolean>;
+    pharmacotherapeuticGroup: z.ZodNullable<z.ZodString>;
+    patientSafety: z.ZodNullable<z.ZodString>;
+    latestProcedure: z.ZodNullable<z.ZodString>;
+    revisionNumber: z.ZodNullable<z.ZodNumber>;
+    smpcUrl: z.ZodNullable<z.ZodString>;
+    smpcDate: z.ZodNullable<z.ZodString>;
+    opinionAdoptedDate: z.ZodNullable<z.ZodString>;
+    europeanCommissionDecisionDate: z.ZodNullable<z.ZodString>;
+    withdrawalOfApplicationDate: z.ZodNullable<z.ZodString>;
+    refusalOfMarketingAuthorisationDate: z.ZodNullable<z.ZodString>;
+    withdrawalExpiryRevocationLapseDate: z.ZodNullable<z.ZodString>;
+    firstPublishedDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const RegulatoryBaseSchema: z.ZodObject<{
+    amassId: z.ZodString;
+    agency: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    activeSubstance: z.ZodNullable<z.ZodString>;
+    moleculeType: z.ZodNullable<z.ZodString>;
+    authorizationStatus: z.ZodNullable<z.ZodString>;
+    procedureType: z.ZodNullable<z.ZodString>;
+    therapeuticIndication: z.ZodNullable<z.ZodString>;
+    marketingAuthorisationHolder: z.ZodNullable<z.ZodString>;
+    authorizationDate: z.ZodNullable<z.ZodString>;
+    firstAuthorizationDate: z.ZodNullable<z.ZodString>;
+    sourceUrl: z.ZodNullable<z.ZodString>;
+    isOrphan: z.ZodNullable<z.ZodBoolean>;
+    designations: z.ZodArray<z.ZodObject<{
+        axis: z.ZodString;
+        type: z.ZodString;
+        agency: z.ZodString;
+        nativeName: z.ZodNullable<z.ZodString>;
+        basis: z.ZodNullable<z.ZodString>;
+        indication: z.ZodNullable<z.ZodString>;
+        postMarketingObligation: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    authorizationsByAgency: z.ZodArray<z.ZodObject<{
+        amassId: z.ZodString;
+        agency: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        authorizationStatus: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    fdaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        applicationNumber: z.ZodNullable<z.ZodString>;
+        prescriptionClass: z.ZodNullable<z.ZodString>;
+        submissionClassCode: z.ZodNullable<z.ZodString>;
+        labelDate: z.ZodNullable<z.ZodString>;
+        labelUrl: z.ZodNullable<z.ZodString>;
+        ndc: z.ZodArray<z.ZodString>;
+        splSetId: z.ZodArray<z.ZodString>;
+        withdrawalDate: z.ZodNullable<z.ZodString>;
+        withdrawalReason: z.ZodNullable<z.ZodString>;
+        withdrawalSourceUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    emaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        productNumber: z.ZodNullable<z.ZodString>;
+        category: z.ZodNullable<z.ZodString>;
+        opinionStatus: z.ZodNullable<z.ZodString>;
+        isBiosimilar: z.ZodNullable<z.ZodBoolean>;
+        isAdvancedTherapy: z.ZodNullable<z.ZodBoolean>;
+        isGenericOrHybrid: z.ZodNullable<z.ZodBoolean>;
+        additionalMonitoring: z.ZodNullable<z.ZodBoolean>;
+        pharmacotherapeuticGroup: z.ZodNullable<z.ZodString>;
+        patientSafety: z.ZodNullable<z.ZodString>;
+        latestProcedure: z.ZodNullable<z.ZodString>;
+        revisionNumber: z.ZodNullable<z.ZodNumber>;
+        smpcUrl: z.ZodNullable<z.ZodString>;
+        smpcDate: z.ZodNullable<z.ZodString>;
+        opinionAdoptedDate: z.ZodNullable<z.ZodString>;
+        europeanCommissionDecisionDate: z.ZodNullable<z.ZodString>;
+        withdrawalOfApplicationDate: z.ZodNullable<z.ZodString>;
+        refusalOfMarketingAuthorisationDate: z.ZodNullable<z.ZodString>;
+        withdrawalExpiryRevocationLapseDate: z.ZodNullable<z.ZodString>;
+        firstPublishedDate: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const RegulatorySearchResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        amassId: z.ZodString;
+        agency: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        activeSubstance: z.ZodNullable<z.ZodString>;
+        moleculeType: z.ZodNullable<z.ZodString>;
+        authorizationStatus: z.ZodNullable<z.ZodString>;
+        procedureType: z.ZodNullable<z.ZodString>;
+        therapeuticIndication: z.ZodNullable<z.ZodString>;
+        marketingAuthorisationHolder: z.ZodNullable<z.ZodString>;
+        authorizationDate: z.ZodNullable<z.ZodString>;
+        firstAuthorizationDate: z.ZodNullable<z.ZodString>;
+        sourceUrl: z.ZodNullable<z.ZodString>;
+        isOrphan: z.ZodNullable<z.ZodBoolean>;
+        designations: z.ZodArray<z.ZodObject<{
+            axis: z.ZodString;
+            type: z.ZodString;
+            agency: z.ZodString;
+            nativeName: z.ZodNullable<z.ZodString>;
+            basis: z.ZodNullable<z.ZodString>;
+            indication: z.ZodNullable<z.ZodString>;
+            postMarketingObligation: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        authorizationsByAgency: z.ZodArray<z.ZodObject<{
+            amassId: z.ZodString;
+            agency: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            authorizationStatus: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        fdaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            applicationNumber: z.ZodNullable<z.ZodString>;
+            prescriptionClass: z.ZodNullable<z.ZodString>;
+            submissionClassCode: z.ZodNullable<z.ZodString>;
+            labelDate: z.ZodNullable<z.ZodString>;
+            labelUrl: z.ZodNullable<z.ZodString>;
+            ndc: z.ZodArray<z.ZodString>;
+            splSetId: z.ZodArray<z.ZodString>;
+            withdrawalDate: z.ZodNullable<z.ZodString>;
+            withdrawalReason: z.ZodNullable<z.ZodString>;
+            withdrawalSourceUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+        emaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            productNumber: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            opinionStatus: z.ZodNullable<z.ZodString>;
+            isBiosimilar: z.ZodNullable<z.ZodBoolean>;
+            isAdvancedTherapy: z.ZodNullable<z.ZodBoolean>;
+            isGenericOrHybrid: z.ZodNullable<z.ZodBoolean>;
+            additionalMonitoring: z.ZodNullable<z.ZodBoolean>;
+            pharmacotherapeuticGroup: z.ZodNullable<z.ZodString>;
+            patientSafety: z.ZodNullable<z.ZodString>;
+            latestProcedure: z.ZodNullable<z.ZodString>;
+            revisionNumber: z.ZodNullable<z.ZodNumber>;
+            smpcUrl: z.ZodNullable<z.ZodString>;
+            smpcDate: z.ZodNullable<z.ZodString>;
+            opinionAdoptedDate: z.ZodNullable<z.ZodString>;
+            europeanCommissionDecisionDate: z.ZodNullable<z.ZodString>;
+            withdrawalOfApplicationDate: z.ZodNullable<z.ZodString>;
+            refusalOfMarketingAuthorisationDate: z.ZodNullable<z.ZodString>;
+            withdrawalExpiryRevocationLapseDate: z.ZodNullable<z.ZodString>;
+            firstPublishedDate: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+        documentSections: z.ZodArray<z.ZodObject<{
+            documentSectionId: z.ZodString;
+            amassId: z.ZodString;
+            docType: z.ZodString;
+            path: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            textType: z.ZodNullable<z.ZodString>;
+            sourceUrl: z.ZodNullable<z.ZodString>;
+            sourceDate: z.ZodNullable<z.ZodString>;
+            matchedText: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RegulatoryRecordResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        amassId: z.ZodString;
+        agency: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        activeSubstance: z.ZodNullable<z.ZodString>;
+        moleculeType: z.ZodNullable<z.ZodString>;
+        authorizationStatus: z.ZodNullable<z.ZodString>;
+        procedureType: z.ZodNullable<z.ZodString>;
+        therapeuticIndication: z.ZodNullable<z.ZodString>;
+        marketingAuthorisationHolder: z.ZodNullable<z.ZodString>;
+        authorizationDate: z.ZodNullable<z.ZodString>;
+        firstAuthorizationDate: z.ZodNullable<z.ZodString>;
+        sourceUrl: z.ZodNullable<z.ZodString>;
+        isOrphan: z.ZodNullable<z.ZodBoolean>;
+        designations: z.ZodArray<z.ZodObject<{
+            axis: z.ZodString;
+            type: z.ZodString;
+            agency: z.ZodString;
+            nativeName: z.ZodNullable<z.ZodString>;
+            basis: z.ZodNullable<z.ZodString>;
+            indication: z.ZodNullable<z.ZodString>;
+            postMarketingObligation: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        authorizationsByAgency: z.ZodArray<z.ZodObject<{
+            amassId: z.ZodString;
+            agency: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            authorizationStatus: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        fdaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            applicationNumber: z.ZodNullable<z.ZodString>;
+            prescriptionClass: z.ZodNullable<z.ZodString>;
+            submissionClassCode: z.ZodNullable<z.ZodString>;
+            labelDate: z.ZodNullable<z.ZodString>;
+            labelUrl: z.ZodNullable<z.ZodString>;
+            ndc: z.ZodArray<z.ZodString>;
+            splSetId: z.ZodArray<z.ZodString>;
+            withdrawalDate: z.ZodNullable<z.ZodString>;
+            withdrawalReason: z.ZodNullable<z.ZodString>;
+            withdrawalSourceUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+        emaDetails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            productNumber: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            opinionStatus: z.ZodNullable<z.ZodString>;
+            isBiosimilar: z.ZodNullable<z.ZodBoolean>;
+            isAdvancedTherapy: z.ZodNullable<z.ZodBoolean>;
+            isGenericOrHybrid: z.ZodNullable<z.ZodBoolean>;
+            additionalMonitoring: z.ZodNullable<z.ZodBoolean>;
+            pharmacotherapeuticGroup: z.ZodNullable<z.ZodString>;
+            patientSafety: z.ZodNullable<z.ZodString>;
+            latestProcedure: z.ZodNullable<z.ZodString>;
+            revisionNumber: z.ZodNullable<z.ZodNumber>;
+            smpcUrl: z.ZodNullable<z.ZodString>;
+            smpcDate: z.ZodNullable<z.ZodString>;
+            opinionAdoptedDate: z.ZodNullable<z.ZodString>;
+            europeanCommissionDecisionDate: z.ZodNullable<z.ZodString>;
+            withdrawalOfApplicationDate: z.ZodNullable<z.ZodString>;
+            refusalOfMarketingAuthorisationDate: z.ZodNullable<z.ZodString>;
+            withdrawalExpiryRevocationLapseDate: z.ZodNullable<z.ZodString>;
+            firstPublishedDate: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+        documentSections: z.ZodArray<z.ZodObject<{
+            documentSectionId: z.ZodString;
+            amassId: z.ZodString;
+            docType: z.ZodString;
+            path: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            textType: z.ZodNullable<z.ZodString>;
+            sourceUrl: z.ZodNullable<z.ZodString>;
+            sourceDate: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const RegulatorySectionResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        documentSectionId: z.ZodString;
+        amassId: z.ZodString;
+        docType: z.ZodString;
+        path: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        textType: z.ZodNullable<z.ZodString>;
+        sourceUrl: z.ZodNullable<z.ZodString>;
+        sourceDate: z.ZodNullable<z.ZodString>;
+        content: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type RegulatoryBase = z.infer<typeof RegulatoryBaseSchema>;
+/** The sections of one source document. The document fields appear once, not on every section. */
+export interface SectionGroup<S> {
+    readonly docType: string;
+    readonly sourceUrl: string | null;
+    readonly sourceDate: string | null;
+    readonly sections: S[];
+}
+/** One entry of a table of contents. */
+export interface SectionEntry {
+    readonly documentSectionId: string;
+    readonly path: string | null;
+    readonly title: string | null;
+}
+/** One matched section of a search, with the excerpt that drove the match. */
+export interface MatchedSectionEntry extends SectionEntry {
+    readonly matchedText: string | null;
+}
+/** The fields of an authorization that both the search and the details answer carry. */
+export interface AuthorizationSummary {
+    readonly amassId: string;
+    readonly agency: string;
+    readonly name: string | null;
+    readonly activeSubstance: string | null;
+    readonly moleculeType: string | null;
+    readonly authorizationStatus: string | null;
+    readonly procedureType: string | null;
+    readonly therapeuticIndication: string | null;
+    readonly marketingAuthorisationHolder: string | null;
+    readonly authorizationDate: string | null;
+    readonly firstAuthorizationDate: string | null;
+    readonly isOrphan: boolean | null;
+    readonly designations: RegulatoryBase["designations"];
+    readonly otherAuthorizations: RegulatoryBase["authorizationsByAgency"];
+    readonly sourceUrl: string | null;
+}
+/** The matched sections that a search row keeps. The count still reports all of them. */
+export declare const MAX_MATCHED_SECTIONS = 5;
+export interface AuthorizationSearchRow extends AuthorizationSummary {
+    readonly matchedSectionCount: number;
+    readonly matchedDocuments: SectionGroup<MatchedSectionEntry>[];
+}
+export declare function mapRegulatorySearchRow(record: z.infer<typeof RegulatorySearchResponseSchema>["data"][number]): AuthorizationSearchRow;
+export interface AuthorizationRecord extends AuthorizationSummary {
+    readonly fdaDetails: z.infer<typeof FdaDetailsSchema> | null;
+    readonly emaDetails: z.infer<typeof EmaDetailsSchema> | null;
+    readonly sectionCount: number;
+    readonly documents: SectionGroup<SectionEntry>[];
+}
+export declare function mapRegulatoryRecord(record: z.infer<typeof RegulatoryRecordResponseSchema>["data"]): AuthorizationRecord;
+export interface RegulatorySection {
+    readonly amassId: string;
+    readonly documentSectionId: string;
+    readonly docType: string;
+    readonly path: string | null;
+    readonly title: string | null;
+    readonly sourceUrl: string | null;
+    readonly sourceDate: string | null;
+    readonly content: string | null;
+}
+export interface RegulatorySearchParams {
+    readonly query: string;
+    readonly limit: number;
+    readonly agency?: readonly string[];
+    readonly authorizationStatus?: readonly string[];
+    readonly moleculeType?: readonly string[];
+    readonly hasDesignation?: readonly string[];
+    readonly isOrphan?: boolean;
+    readonly minAuthorizationDate?: string;
+    readonly maxAuthorizationDate?: string;
+    readonly amassId?: string;
+}
+export declare function searchRegulatoryRecords(params: RegulatorySearchParams, headers: Record<string, string>): ResultAsync<AuthorizationSearchRow[], AmassError>;
+/** One authorization with its table of contents, or `null` when Amass holds no such ID. */
+export declare function getRegulatoryRecord(amassId: string, headers: Record<string, string>): ResultAsync<AuthorizationRecord | null, AmassError>;
+/** The full text of one document section, or `null` when Amass holds no such section. */
+export declare function getRegulatorySection(amassId: string, documentSectionId: string, headers: Record<string, string>): ResultAsync<RegulatorySection | null, AmassError>;
+/** The identifiers that the RegulatoryCore lookup accepts. Exactly one is set. */
+export interface RegulatoryIdentifier {
+    readonly fdaApplicationNumber?: string;
+    readonly emaProductNumber?: string;
+    readonly ndc?: string;
+    readonly splSetId?: string;
+}
+export declare function regulatoryLookupItems(id: RegulatoryIdentifier): LookupItem[];
+export declare function lookupRegulatoryIds(id: RegulatoryIdentifier, headers: Record<string, string>): ResultAsync<string[], AmassError>;
+declare const PatentBaseSchema: z.ZodObject<{
+    amassId: z.ZodString;
+    publicationNumber: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    applicationNumber: z.ZodNullable<z.ZodString>;
+    countryCode: z.ZodNullable<z.ZodString>;
+    kindCode: z.ZodNullable<z.ZodString>;
+    familyId: z.ZodNullable<z.ZodString>;
+    familyMembers: z.ZodArray<z.ZodString>;
+    title: z.ZodNullable<z.ZodString>;
+    abstract: z.ZodNullable<z.ZodString>;
+    language: z.ZodNullable<z.ZodString>;
+    nonEnglishFallback: z.ZodNullable<z.ZodBoolean>;
+    cpcCodes: z.ZodArray<z.ZodString>;
+    inventors: z.ZodArray<z.ZodString>;
+    assignees: z.ZodArray<z.ZodString>;
+    publicationDate: z.ZodNullable<z.ZodString>;
+    filingDate: z.ZodNullable<z.ZodString>;
+    grantDate: z.ZodNullable<z.ZodString>;
+    priorityDate: z.ZodNullable<z.ZodString>;
+    citedPatents: z.ZodArray<z.ZodString>;
+    hasClaims: z.ZodNullable<z.ZodBoolean>;
+    hasDescription: z.ZodNullable<z.ZodBoolean>;
+    nplCount: z.ZodNullable<z.ZodNumber>;
+    citedByCount: z.ZodNullable<z.ZodNumber>;
+    claims: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const PatentSearchResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        amassId: z.ZodString;
+        publicationNumber: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        applicationNumber: z.ZodNullable<z.ZodString>;
+        countryCode: z.ZodNullable<z.ZodString>;
+        kindCode: z.ZodNullable<z.ZodString>;
+        familyId: z.ZodNullable<z.ZodString>;
+        familyMembers: z.ZodArray<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        abstract: z.ZodNullable<z.ZodString>;
+        language: z.ZodNullable<z.ZodString>;
+        nonEnglishFallback: z.ZodNullable<z.ZodBoolean>;
+        cpcCodes: z.ZodArray<z.ZodString>;
+        inventors: z.ZodArray<z.ZodString>;
+        assignees: z.ZodArray<z.ZodString>;
+        publicationDate: z.ZodNullable<z.ZodString>;
+        filingDate: z.ZodNullable<z.ZodString>;
+        grantDate: z.ZodNullable<z.ZodString>;
+        priorityDate: z.ZodNullable<z.ZodString>;
+        citedPatents: z.ZodArray<z.ZodString>;
+        hasClaims: z.ZodNullable<z.ZodBoolean>;
+        hasDescription: z.ZodNullable<z.ZodBoolean>;
+        nplCount: z.ZodNullable<z.ZodNumber>;
+        citedByCount: z.ZodNullable<z.ZodNumber>;
+        claims: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const PatentRecordResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        amassId: z.ZodString;
+        publicationNumber: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        applicationNumber: z.ZodNullable<z.ZodString>;
+        countryCode: z.ZodNullable<z.ZodString>;
+        kindCode: z.ZodNullable<z.ZodString>;
+        familyId: z.ZodNullable<z.ZodString>;
+        familyMembers: z.ZodArray<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        abstract: z.ZodNullable<z.ZodString>;
+        language: z.ZodNullable<z.ZodString>;
+        nonEnglishFallback: z.ZodNullable<z.ZodBoolean>;
+        cpcCodes: z.ZodArray<z.ZodString>;
+        inventors: z.ZodArray<z.ZodString>;
+        assignees: z.ZodArray<z.ZodString>;
+        publicationDate: z.ZodNullable<z.ZodString>;
+        filingDate: z.ZodNullable<z.ZodString>;
+        grantDate: z.ZodNullable<z.ZodString>;
+        priorityDate: z.ZodNullable<z.ZodString>;
+        citedPatents: z.ZodArray<z.ZodString>;
+        hasClaims: z.ZodNullable<z.ZodBoolean>;
+        hasDescription: z.ZodNullable<z.ZodBoolean>;
+        nplCount: z.ZodNullable<z.ZodNumber>;
+        citedByCount: z.ZodNullable<z.ZodNumber>;
+        claims: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type PatentBase = z.infer<typeof PatentBaseSchema>;
+/** A patent with its citation counts. The citation lists stay out: a cited patent can carry thousands. */
+export interface PatentSummary {
+    readonly amassId: string;
+    readonly publicationNumber: string | null;
+    readonly applicationNumber: string | null;
+    readonly countryCode: string | null;
+    readonly kindCode: string | null;
+    readonly familyId: string | null;
+    readonly familyMemberCount: number;
+    readonly title: string | null;
+    readonly abstract: string | null;
+    readonly assignees: string[];
+    readonly inventors: string[];
+    readonly cpcCodes: string[];
+    readonly publicationDate: string | null;
+    readonly filingDate: string | null;
+    readonly grantDate: string | null;
+    readonly priorityDate: string | null;
+    readonly citedPatentCount: number;
+    readonly citedByCount: number | null;
+    readonly nplCount: number | null;
+    readonly hasClaims: boolean | null;
+    readonly hasDescription: boolean | null;
+    readonly url: string | null;
+}
+export declare function mapPatentSummary(record: PatentBase): PatentSummary;
+export interface PatentRecord extends PatentSummary {
+    readonly familyMembers: string[];
+    readonly language: string | null;
+    readonly nonEnglishFallback: boolean | null;
+    readonly claims?: string | null;
+    readonly description?: string | null;
+}
+export declare function mapPatentRecord(record: PatentBase): PatentRecord;
+export interface PatentSearchParams {
+    readonly query: string;
+    readonly limit: number;
+    readonly assignee?: readonly string[];
+    readonly inventor?: string;
+    readonly cpcCodes?: readonly string[];
+    readonly countryCode?: readonly string[];
+    readonly minPublicationDate?: string;
+    readonly maxPublicationDate?: string;
+    readonly minFilingDate?: string;
+    readonly maxFilingDate?: string;
+    readonly minPriorityDate?: string;
+    readonly maxPriorityDate?: string;
+    readonly minGrantDate?: string;
+    readonly maxGrantDate?: string;
+}
+export declare function searchPatentRecords(params: PatentSearchParams, headers: Record<string, string>): ResultAsync<PatentSummary[], AmassError>;
+export declare function getPatentRecord(amassId: string, include: {
+    readonly claims: boolean;
+    readonly description: boolean;
+}, headers: Record<string, string>): ResultAsync<PatentRecord | null, AmassError>;
+/** The identifiers that the PatentCore lookup accepts. Exactly one is set. */
+export interface PatentIdentifier {
+    readonly publicationNumber?: string;
+    readonly applicationNumber?: string;
+}
+export declare function lookupPatentIds(id: PatentIdentifier, headers: Record<string, string>): ResultAsync<string[], AmassError>;
+export {};