@multiplayer-app/agent 0.1.6 → 0.1.7

package/dist/config.js

@@ -24,7 +24,7 @@ function parseScope(raw) {
         return parsed && typeof parsed === 'object' ? parsed : undefined;
     }
     catch (error) {
-        throw new Error(`RESEARCH_SCOPE_JSON is not valid JSON: ${error.message}`);
+        throw new Error(`FILINGRAMP_RESEARCH_SCOPE_JSON is not valid JSON: ${error.message}`);
     }
 }
 function parsePositiveInt(raw) {
@@ -94,7 +94,7 @@ function loadConfigFromEnv(env = process.env) {
             anthropicApiKey: env[protocol_1.AGENT_ENV.ANTHROPIC_API_KEY],
         },
         filingRamp: filingRampFromEnv(env),
-        researchScope: parseScope(env[protocol_1.AGENT_ENV.RESEARCH_SCOPE_JSON]),
+        researchScope: parseScope(env[protocol_1.AGENT_ENV.FILINGRAMP_RESEARCH_SCOPE_JSON]),
         git: gitFromEnv(env, sessionId, workspaceDir),
     };
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -95,12 +95,16 @@ export type AgentSessionEvent = BaseEvent & (
     toolCallId?: string;
     steps: AgentProgressStep[];
 }
-/** The agent needs the user before it can continue (confirm a large population, pick a scope). */
+/**
+ * The request_clarification call `toolCallId` needs the user before the agent can continue.
+ * The platform turns that call into a pending user action and sends the answer back as the
+ * next `message` command.
+ */
  | {
     type: 'question';
     messageId: string;
-    text: string;
-    options?: string[];
+    toolCallId: string;
+    question: string;
 } | {
     type: 'usage';
     messageId: string;
@@ -169,7 +173,7 @@ export declare const AGENT_ENV: {
     /** 'true' when the account may query industry (public) filings. */
     readonly FILINGRAMP_INDUSTRY_DATA: "FILINGRAMP_INDUSTRY_DATA";
     /** JSON ResearchScope the session was created with. */
-    readonly RESEARCH_SCOPE_JSON: "RESEARCH_SCOPE_JSON";
+    readonly FILINGRAMP_RESEARCH_SCOPE_JSON: "FILINGRAMP_RESEARCH_SCOPE_JSON";
     readonly GIT_SERVER_URL: "GIT_SERVER_URL";
     readonly GIT_REPOSITORY: "GIT_REPOSITORY";
     readonly GIT_REPOSITORY_DIR: "GIT_REPOSITORY_DIR";

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -84,7 +84,7 @@ exports.AGENT_ENV = {
     /** 'true' when the account may query industry (public) filings. */
     FILINGRAMP_INDUSTRY_DATA: 'FILINGRAMP_INDUSTRY_DATA',
     /** JSON ResearchScope the session was created with. */
-    RESEARCH_SCOPE_JSON: 'RESEARCH_SCOPE_JSON',
+    FILINGRAMP_RESEARCH_SCOPE_JSON: 'FILINGRAMP_RESEARCH_SCOPE_JSON',
     GIT_SERVER_URL: 'GIT_SERVER_URL',
     GIT_REPOSITORY: 'GIT_REPOSITORY',
     GIT_REPOSITORY_DIR: 'GIT_REPOSITORY_DIR',

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";AAAA,yFAAyF;AACzF,6FAA6F;AAC7F,wFAAwF;AACxF,8FAA8F;AAC9F,wEAAwE;AACxE,EAAE;AACF,8CAA8C;AAC9C,kFAAkF;AAClF,6DAA6D;;;AAM7D,4CAEC;AA+ED,oDAGC;AAoBD,kDAQC;AApHY,QAAA,mBAAmB,GAAG,qBAA8B,CAAA;AACpD,QAAA,qBAAqB,GAAG,uBAAgC,CAAA;AAErE,kGAAkG;AAClG,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,OAAO,iBAAiB,SAAS,EAAE,CAAA;AACrC,CAAC;AA+ED,SAAgB,oBAAoB,CAAC,KAAwB;;IAC3D,mFAAmF;IACnF,OAAO,qBAAqB,KAAK,CAAC,SAAS,IAAI,MAAA,KAAK,CAAC,UAAU,mCAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,EAAE,CAAA;AACnG,CAAC;AAEY,QAAA,yBAAyB,GAAqC;IACzE,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,UAAU;IACV,UAAU;IACV,OAAO;IACP,OAAO;IACP,cAAc;IACd,MAAM;IACN,OAAO;IACP,WAAW;IACX,SAAS;CACV,CAAA;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,KAAK,GAAG,KAAmC,CAAA;IACjD,OAAO,CACL,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,iCAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CACtE,CAAA;AACH,CAAC;AAED,8FAA8F;AAC9F,8FAA8F;AAC9F,+FAA+F;AAC/F,iDAAiD;AAEpC,QAAA,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,uFAAuF;IACvF,UAAU,EAAE,YAAY;IACxB,wCAAwC;IACxC,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,6DAA6D;IAC7D,sBAAsB,EAAE,wBAAwB;IAChD,wFAAwF;IACxF,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,aAAa;IACb,kBAAkB,EAAE,oBAAoB;IACxC,gDAAgD;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,2CAA2C;IAC3C,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,wFAAwF;IACxF,qBAAqB,EAAE,uBAAuB;IAC9C,qFAAqF;IACrF,oBAAoB,EAAE,sBAAsB;IAC5C,aAAa;IACb,wBAAwB,EAAE,0BAA0B;IACpD,mEAAmE;IACnE,wBAAwB,EAAE,0BAA0B;IACpD,uDAAuD;IACvD,mBAAmB,EAAE,qBAAqB;IAC1C,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,oFAAoF;IACpF,UAAU,EAAE,YAAY;IACxB,aAAa;IACb,gBAAgB,EAAE,kBAAkB;CAC5B,CAAA;AAEG,QAAA,qBAAqB,GAAsB;IACtD,iBAAS,CAAC,kBAAkB;IAC5B,iBAAS,CAAC,kBAAkB;IAC5B,iBAAS,CAAC,iBAAiB;IAC3B,iBAAS,CAAC,qBAAqB;IAC/B,iBAAS,CAAC,wBAAwB;IAClC,iBAAS,CAAC,gBAAgB;IAC1B,iBAAS,CAAC,gBAAgB;CAC3B,CAAA"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";AAAA,yFAAyF;AACzF,6FAA6F;AAC7F,wFAAwF;AACxF,8FAA8F;AAC9F,wEAAwE;AACxE,EAAE;AACF,8CAA8C;AAC9C,kFAAkF;AAClF,6DAA6D;;;AAM7D,4CAEC;AAmFD,oDAGC;AAoBD,kDAQC;AAxHY,QAAA,mBAAmB,GAAG,qBAA8B,CAAA;AACpD,QAAA,qBAAqB,GAAG,uBAAgC,CAAA;AAErE,kGAAkG;AAClG,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,OAAO,iBAAiB,SAAS,EAAE,CAAA;AACrC,CAAC;AAmFD,SAAgB,oBAAoB,CAAC,KAAwB;;IAC3D,mFAAmF;IACnF,OAAO,qBAAqB,KAAK,CAAC,SAAS,IAAI,MAAA,KAAK,CAAC,UAAU,mCAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,EAAE,CAAA;AACnG,CAAC;AAEY,QAAA,yBAAyB,GAAqC;IACzE,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,UAAU;IACV,UAAU;IACV,OAAO;IACP,OAAO;IACP,cAAc;IACd,MAAM;IACN,OAAO;IACP,WAAW;IACX,SAAS;CACV,CAAA;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,KAAK,GAAG,KAAmC,CAAA;IACjD,OAAO,CACL,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,iCAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CACtE,CAAA;AACH,CAAC;AAED,8FAA8F;AAC9F,8FAA8F;AAC9F,+FAA+F;AAC/F,iDAAiD;AAEpC,QAAA,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,uFAAuF;IACvF,UAAU,EAAE,YAAY;IACxB,wCAAwC;IACxC,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,6DAA6D;IAC7D,sBAAsB,EAAE,wBAAwB;IAChD,wFAAwF;IACxF,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,aAAa;IACb,kBAAkB,EAAE,oBAAoB;IACxC,gDAAgD;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,2CAA2C;IAC3C,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,wFAAwF;IACxF,qBAAqB,EAAE,uBAAuB;IAC9C,qFAAqF;IACrF,oBAAoB,EAAE,sBAAsB;IAC5C,aAAa;IACb,wBAAwB,EAAE,0BAA0B;IACpD,mEAAmE;IACnE,wBAAwB,EAAE,0BAA0B;IACpD,uDAAuD;IACvD,8BAA8B,EAAE,gCAAgC;IAChE,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,oFAAoF;IACpF,UAAU,EAAE,YAAY;IACxB,aAAa;IACb,gBAAgB,EAAE,kBAAkB;CAC5B,CAAA;AAEG,QAAA,qBAAqB,GAAsB;IACtD,iBAAS,CAAC,kBAAkB;IAC5B,iBAAS,CAAC,kBAAkB;IAC5B,iBAAS,CAAC,iBAAiB;IAC3B,iBAAS,CAAC,qBAAqB;IAC/B,iBAAS,CAAC,wBAAwB;IAClC,iBAAS,CAAC,gBAAgB;IAC1B,iBAAS,CAAC,gBAAgB;CAC3B,CAAA"}

package/dist/research/filingramp-contract.d.ts

@@ -0,0 +1,45 @@
+export interface FilingsFilter {
+    field: string;
+    comparisonOperator: string;
+    value: unknown;
+}
+/** What the model may pass: operator optional (the field decides), scalar or list values. */
+export interface FilterInput {
+    field: string;
+    comparisonOperator?: string;
+    value: unknown;
+}
+/** Filing records and summary groupBy use singular names; the filter contract uses plurals. */
+export declare const FILING_FILTER_ALIASES: Record<string, string>;
+export type FilingsEndpoint = 'search' | 'count' | 'summary' | 'objections';
+/** Summary groupBy values (singular), with the plural filter names accepted as aliases. */
+export declare const SUMMARY_GROUP_FIELDS: readonly ["businessType", "company", "createdMonth", "dispositionMonth", "filingType", "source", "state", "statusId", "submittedMonth", "subTypeOfInsurance", "typeOfInsurance"];
+export declare function normalizeSummaryGroupBy(groupBy: string[] | undefined): string[] | undefined;
+/**
+ * Filings filters as the API accepts them. Plural names, one array per list field, the operator
+ * the field takes; unknown fields and mismatched date/boolean operators fail with the accepted
+ * values, so the model corrects the call instead of guessing again.
+ */
+export declare function normalizeFilingsFilters(filters: FilterInput[] | undefined, endpoint: FilingsEndpoint): FilingsFilter[];
+export declare const DOCUMENT_INDEXES: readonly ["filings", "objections", "responses", "library_forms", "library_rates", "circulars"];
+export type DocumentIndex = (typeof DOCUMENT_INDEXES)[number];
+/** Resource types a document hit can carry (OpenSearchEnum.Resource.Type in ramp-schemas). */
+export declare const DOCUMENT_RESOURCE_TYPES: readonly ["FILING", "FILING_ATTACHMENT", "FILING_DISPOSITION", "FILING_FORM", "FILING_RATE", "FILING_SUPPORTING", "OBJECTION", "OBJECTION_LETTER", "RESPONSE", "RESPONSE_LETTER", "LIBRARY_FORM_ATTACHMENT", "LIBRARY_RATE_ATTACHMENT", "CIRCULAR_ATTACHMENT", "CIRCULAR_FORM", "CIRCULAR_RATE"];
+export interface DocumentIndexGroup {
+    indexes: DocumentIndex[];
+    /** Filter fields every index in the group accepts. */
+    fields: readonly string[];
+}
+/** One request per set of indexes that share a filter vocabulary (objections and responses do). */
+export declare function documentIndexGroups(indexes: readonly DocumentIndex[]): DocumentIndexGroup[];
+export declare function documentFilterField(field: string): string;
+/**
+ * Document filters for one index group. Filters on fields the group does not accept are
+ * returned separately instead of failing the request: the model usually means them for the
+ * filing indexes in the same call.
+ */
+export declare function normalizeDocumentFilters(filters: FilterInput[] | undefined, group: DocumentIndexGroup): {
+    filters: FilingsFilter[];
+    ignored: string[];
+};
+//# sourceMappingURL=filingramp-contract.d.ts.map

package/dist/research/filingramp-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-contract.d.ts","sourceRoot":"","sources":["../../src/research/filingramp-contract.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf;AAkBD,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqBxD,CAAA;AA0CD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAA;AAsB3E,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,kLAGvB,CAAA;AAeV,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,aAAa,EAAE,CAWtH;AAMD,eAAO,MAAM,gBAAgB,gGAAiG,CAAA;AAC9H,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,kSAI1B,CAAA;AAwCV,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,sDAAsD;IACtD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,kBAAkB,EAAE,CAU3F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,EAClC,KAAK,EAAE,kBAAkB,GACxB;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAYjD"}

package/dist/research/filingramp-contract.js

@@ -0,0 +1,277 @@
+"use strict";
+// The FilingRamp request contract, enforced before any HTTP call. The filings part mirrors the
+// FilingsFilters card in services/api/src/lib/filingramp-skill-document.ts (the catalog the
+// orchestrator's workers get); the document-search part mirrors ramp-web-api's
+// search.schema.js for POST /content-search/global. Both APIs reject a request outright on one
+// wrong operator or field name, and their Joi messages name positions, not fixes — so the
+// tools normalize what has a single right answer (plural field names, one value instead of a
+// list, the operator a field accepts) and fail early with the accepted values for the rest.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCUMENT_RESOURCE_TYPES = exports.DOCUMENT_INDEXES = exports.SUMMARY_GROUP_FIELDS = exports.FILING_FILTER_ALIASES = void 0;
+exports.normalizeSummaryGroupBy = normalizeSummaryGroupBy;
+exports.normalizeFilingsFilters = normalizeFilingsFilters;
+exports.documentIndexGroups = documentIndexGroups;
+exports.documentFilterField = documentFilterField;
+exports.normalizeDocumentFilters = normalizeDocumentFilters;
+const list = (defaultOperator) => ({ kind: 'list', operators: ['cn', 'in'], defaultOperator });
+const date = { kind: 'date', operators: ['eq', 'gt', 'gte', 'lt', 'lte'], defaultOperator: 'eq' };
+// ---------------------------------------------------------------------------------------------
+// Filings endpoints: /v2/search/filings, /count, /summary and /objections.
+// ---------------------------------------------------------------------------------------------
+/** Filing records and summary groupBy use singular names; the filter contract uses plurals. */
+exports.FILING_FILTER_ALIASES = {
+    state: 'states',
+    typeOfInsurance: 'typeOfInsurances',
+    subTypeOfInsurance: 'subTypeOfInsurances',
+    filingType: 'filingTypes',
+    statusId: 'statusIds',
+    status: 'statuses',
+    company: 'companies',
+    businessType: 'businessTypes',
+    trackingNumber: 'trackingNumbers',
+    author: 'authors',
+    reviewer: 'reviewers',
+    productName: 'productNames',
+    projectName: 'projectNames',
+    projectNumber: 'projectNumbers',
+    customTrackingNumber: 'customTrackingNumbers',
+    stateTrackingNumber: 'stateTrackingNumbers',
+    line: 'typeOfInsurances',
+    lines: 'typeOfInsurances',
+    subLine: 'subTypeOfInsurances',
+    subLines: 'subTypeOfInsurances',
+};
+const FILINGS_FIELD_RULES = {
+    // Names and labels: "cn" (contains) unless the user asked for an exact match.
+    authors: list('cn'),
+    companies: list('cn'),
+    contacts: list('cn'),
+    reviewers: list('cn'),
+    primaryReviewers: list('cn'),
+    productNames: list('cn'),
+    projectNames: list('cn'),
+    typeOfInsurances: list('cn'),
+    subTypeOfInsurances: list('cn'),
+    'form.formNumbers': list('cn'),
+    'form.formNames': list('cn'),
+    'rate.ruleNumbers': list('cn'),
+    'rate.rateNames': list('cn'),
+    'generalInformation.companyTrackingNumbers': list('cn'),
+    // Codes and identifiers: exact.
+    states: list('in'),
+    statusIds: list('in'),
+    statuses: list('in'),
+    filingTypes: list('in'),
+    businessTypes: list('in'),
+    trackingNumbers: list('in'),
+    customTrackingNumbers: list('in'),
+    stateTrackingNumbers: list('in'),
+    projectNumbers: list('in'),
+    rampProjectNumbers: list('in'),
+    productIds: list('in'),
+    projectIds: list('in'),
+    workspaceIds: list('in'),
+    createdAt: date,
+    updatedAt: date,
+    dateSubmitted: date,
+    'disposition.dispositionDate': date,
+    'objection.letterDate': { kind: 'date', operators: ['gte', 'lte'], defaultOperator: 'gte' },
+    'objection.respondByDate': { kind: 'date', operators: ['gte', 'lte'], defaultOperator: 'gte' },
+    hasObjection: { kind: 'boolean', operators: ['ex'], defaultOperator: 'ex' },
+    'objection.isHidden': { kind: 'boolean', operators: ['eq'], defaultOperator: 'eq' },
+};
+const SEARCH_FIELDS = [
+    'authors', 'companies', 'contacts', 'reviewers', 'primaryReviewers', 'productNames', 'projectNames', 'typeOfInsurances',
+    'subTypeOfInsurances', 'form.formNumbers', 'form.formNames', 'rate.ruleNumbers', 'rate.rateNames',
+    'generalInformation.companyTrackingNumbers', 'states', 'statusIds', 'statuses', 'filingTypes', 'businessTypes',
+    'trackingNumbers', 'customTrackingNumbers', 'stateTrackingNumbers', 'projectNumbers', 'rampProjectNumbers', 'productIds',
+    'projectIds', 'workspaceIds', 'createdAt', 'updatedAt', 'dateSubmitted', 'hasObjection',
+];
+const FILINGS_ENDPOINT_FIELDS = {
+    search: SEARCH_FIELDS,
+    count: SEARCH_FIELDS,
+    summary: [...SEARCH_FIELDS, 'disposition.dispositionDate'],
+    objections: [
+        'authors', 'contacts', 'filingTypes', 'generalInformation.companyTrackingNumbers', 'objection.isHidden',
+        'objection.letterDate', 'objection.respondByDate', 'productIds', 'productNames', 'projectIds', 'projectNames',
+        'projectNumbers', 'rampProjectNumbers', 'reviewers', 'states', 'subTypeOfInsurances', 'trackingNumbers',
+        'typeOfInsurances', 'workspaceIds',
+    ],
+};
+/** Summary groupBy values (singular), with the plural filter names accepted as aliases. */
+exports.SUMMARY_GROUP_FIELDS = [
+    'businessType', 'company', 'createdMonth', 'dispositionMonth', 'filingType', 'source', 'state', 'statusId',
+    'submittedMonth', 'subTypeOfInsurance', 'typeOfInsurance',
+];
+const SUMMARY_GROUP_ALIASES = {
+    states: 'state',
+    typeOfInsurances: 'typeOfInsurance',
+    subTypeOfInsurances: 'subTypeOfInsurance',
+    filingTypes: 'filingType',
+    statusIds: 'statusId',
+    companies: 'company',
+    businessTypes: 'businessType',
+    sources: 'source',
+    line: 'typeOfInsurance',
+    subLine: 'subTypeOfInsurance',
+};
+function normalizeSummaryGroupBy(groupBy) {
+    if (!(groupBy === null || groupBy === void 0 ? void 0 : groupBy.length))
+        return undefined;
+    const out = groupBy.map((name) => { var _a; return (_a = SUMMARY_GROUP_ALIASES[name.trim()]) !== null && _a !== void 0 ? _a : name.trim(); });
+    const unknown = out.filter((name) => !exports.SUMMARY_GROUP_FIELDS.includes(name));
+    if (unknown.length) {
+        throw new Error(`summarize_filings groupBy accepts ${exports.SUMMARY_GROUP_FIELDS.join(', ')}; not ${unknown.join(', ')}.`);
+    }
+    return [...new Set(out)];
+}
+/**
+ * Filings filters as the API accepts them. Plural names, one array per list field, the operator
+ * the field takes; unknown fields and mismatched date/boolean operators fail with the accepted
+ * values, so the model corrects the call instead of guessing again.
+ */
+function normalizeFilingsFilters(filters, endpoint) {
+    if (!(filters === null || filters === void 0 ? void 0 : filters.length))
+        return [];
+    const allowed = FILINGS_ENDPOINT_FIELDS[endpoint];
+    return filters.map((filter) => {
+        var _a;
+        const field = (_a = exports.FILING_FILTER_ALIASES[filter.field.trim()]) !== null && _a !== void 0 ? _a : filter.field.trim();
+        const rule = FILINGS_FIELD_RULES[field];
+        if (!rule || !allowed.includes(field)) {
+            throw new Error(`"${filter.field}" is not a filter field here. Accepted: ${allowed.join(', ')}.`);
+        }
+        return normalizeWithRule({ ...filter, field }, rule);
+    });
+}
+// ---------------------------------------------------------------------------------------------
+// Document search: POST /v1/content-search/global (OpenSearch).
+// ---------------------------------------------------------------------------------------------
+exports.DOCUMENT_INDEXES = ['filings', 'objections', 'responses', 'library_forms', 'library_rates', 'circulars'];
+/** Resource types a document hit can carry (OpenSearchEnum.Resource.Type in ramp-schemas). */
+exports.DOCUMENT_RESOURCE_TYPES = [
+    'FILING', 'FILING_ATTACHMENT', 'FILING_DISPOSITION', 'FILING_FORM', 'FILING_RATE', 'FILING_SUPPORTING',
+    'OBJECTION', 'OBJECTION_LETTER', 'RESPONSE', 'RESPONSE_LETTER', 'LIBRARY_FORM_ATTACHMENT', 'LIBRARY_RATE_ATTACHMENT',
+    'CIRCULAR_ATTACHMENT', 'CIRCULAR_FORM', 'CIRCULAR_RATE',
+];
+const COMMON_RECORD_FIELDS = ['accountIds', 'archived', 'createdAt', 'updatedAt', 'productIds', 'projectIds', 'workspaceIds', 'resourceTypes'];
+const FILING_RECORD_FIELDS = [...COMMON_RECORD_FIELDS, 'authors', 'contacts', 'projectNumbers', 'states', 'statuses', 'subTypeOfInsurance', 'typeOfInsurance'];
+/** Filter fields each index accepts; a filter outside the set fails the whole request. */
+const DOCUMENT_INDEX_FIELDS = {
+    filings: [...FILING_RECORD_FIELDS, 'dateSubmitted', 'filingTypes', 'reviewers'],
+    objections: [...FILING_RECORD_FIELDS, 'respondByDate', 'submitterNames'],
+    responses: [...FILING_RECORD_FIELDS, 'respondByDate', 'submitterNames'],
+    circulars: ['archived', 'createdAt', 'updatedAt', 'resourceTypes', 'bureauActions', 'bureaus', 'circularNumbers', 'dates', 'entityTypes', 'isPublished', 'linesOfBusiness', 'titles', 'types'],
+    library_forms: ['resourceTypes', 'editionDates', 'formNumbers'],
+    library_rates: ['resourceTypes'],
+};
+const DOCUMENT_DATE_FIELDS = new Set(['createdAt', 'dates', 'dateSubmitted', 'respondByDate', 'updatedAt']);
+const DOCUMENT_BOOLEAN_FIELDS = new Set(['archived', 'isPublished']);
+const DOCUMENT_PARTIAL_FIELDS = new Set(['authors', 'contacts', 'projectNumbers', 'reviewers', 'submitterNames', 'titles']);
+/** The filings API's plurals and record names, mapped onto OpenSearch's vocabulary. */
+const DOCUMENT_FILTER_ALIASES = {
+    typeOfInsurances: 'typeOfInsurance',
+    subTypeOfInsurances: 'subTypeOfInsurance',
+    line: 'typeOfInsurance',
+    lines: 'typeOfInsurance',
+    state: 'states',
+    status: 'statuses',
+    filingType: 'filingTypes',
+    resourceType: 'resourceTypes',
+    productId: 'productIds',
+    projectId: 'projectIds',
+};
+function documentFieldRule(field) {
+    if (DOCUMENT_BOOLEAN_FIELDS.has(field))
+        return { kind: 'boolean', operators: ['eq'], defaultOperator: 'eq' };
+    if (DOCUMENT_DATE_FIELDS.has(field))
+        return date;
+    if (DOCUMENT_PARTIAL_FIELDS.has(field))
+        return { kind: 'list', operators: ['cn'], defaultOperator: 'cn' };
+    return { kind: 'list', operators: ['in'], defaultOperator: 'in' };
+}
+/** One request per set of indexes that share a filter vocabulary (objections and responses do). */
+function documentIndexGroups(indexes) {
+    const groups = new Map();
+    for (const index of indexes) {
+        const fields = DOCUMENT_INDEX_FIELDS[index];
+        const key = fields.join('|');
+        const group = groups.get(key);
+        if (group)
+            group.indexes.push(index);
+        else
+            groups.set(key, { indexes: [index], fields });
+    }
+    return [...groups.values()];
+}
+function documentFilterField(field) {
+    var _a;
+    const trimmed = field.trim();
+    return (_a = DOCUMENT_FILTER_ALIASES[trimmed]) !== null && _a !== void 0 ? _a : trimmed;
+}
+/**
+ * Document filters for one index group. Filters on fields the group does not accept are
+ * returned separately instead of failing the request: the model usually means them for the
+ * filing indexes in the same call.
+ */
+function normalizeDocumentFilters(filters, group) {
+    const out = [];
+    const ignored = [];
+    for (const filter of filters !== null && filters !== void 0 ? filters : []) {
+        const field = documentFilterField(filter.field);
+        if (!group.fields.includes(field)) {
+            ignored.push(filter.field);
+            continue;
+        }
+        out.push(normalizeWithRule({ ...filter, field }, documentFieldRule(field)));
+    }
+    return { filters: out, ignored };
+}
+// ---------------------------------------------------------------------------------------------
+function normalizeWithRule(filter, rule) {
+    var _a;
+    const requested = (_a = filter.comparisonOperator) === null || _a === void 0 ? void 0 : _a.trim();
+    switch (rule.kind) {
+        case 'list': {
+            const raw = Array.isArray(filter.value) ? filter.value : [filter.value];
+            let value = raw.map((item) => (item === undefined || item === null ? '' : String(item).trim())).filter(Boolean);
+            if (filter.field === 'states')
+                value = value.map((state) => state.toUpperCase());
+            if (!value.length)
+                throw new Error(`"${filter.field}" needs at least one value (a string array).`);
+            // "eq" on a list field means an exact match; anything else the field does not take falls
+            // back to its default, so a slip in the operator never costs a round trip.
+            const operator = requested && rule.operators.includes(requested) ? requested : requested === 'eq' && rule.operators.includes('in') ? 'in' : rule.defaultOperator;
+            return { field: filter.field, comparisonOperator: operator, value: [...new Set(value)] };
+        }
+        case 'date': {
+            const operator = requested || rule.defaultOperator;
+            if (!rule.operators.includes(operator)) {
+                throw new Error(`"${filter.field}" takes one date string with ${rule.operators.join('/')}, not "${operator}".`);
+            }
+            const value = Array.isArray(filter.value) ? filter.value[0] : filter.value;
+            if (typeof value !== 'string' || !value.trim())
+                throw new Error(`"${filter.field}" needs one date string (YYYY-MM-DD).`);
+            return { field: filter.field, comparisonOperator: operator, value: value.trim() };
+        }
+        case 'boolean': {
+            const operator = requested || rule.defaultOperator;
+            if (!rule.operators.includes(operator)) {
+                throw new Error(`"${filter.field}" takes a boolean with "${rule.defaultOperator}", not "${operator}".`);
+            }
+            const value = Array.isArray(filter.value) ? filter.value[0] : filter.value;
+            const bool = typeof value === 'boolean' ? value : value === 'true' ? true : value === 'false' ? false : undefined;
+            if (bool === undefined)
+                throw new Error(`"${filter.field}" needs a boolean value.`);
+            return { field: filter.field, comparisonOperator: operator, value: bool };
+        }
+        case 'number': {
+            const operator = requested || rule.defaultOperator;
+            const value = Number(Array.isArray(filter.value) ? filter.value[0] : filter.value);
+            if (!Number.isFinite(value))
+                throw new Error(`"${filter.field}" needs a number.`);
+            return { field: filter.field, comparisonOperator: operator, value };
+        }
+    }
+}
+//# sourceMappingURL=filingramp-contract.js.map

package/dist/research/filingramp-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-contract.js","sourceRoot":"","sources":["../../src/research/filingramp-contract.ts"],"names":[],"mappings":"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"}

package/dist/research/filingramp-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filingramp-contract.test.d.ts.map

package/dist/research/filingramp-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-contract.test.d.ts","sourceRoot":"","sources":["../../src/research/filingramp-contract.test.ts"],"names":[],"mappings":""}

package/dist/research/filingramp-contract.test.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const filingramp_contract_1 = require("./filingramp-contract");
+(0, node_test_1.describe)('filings filter contract', () => {
+    (0, node_test_1.it)('wraps single values, upper-cases states and picks the operator the field takes', () => {
+        strict_1.default.deepEqual((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'states', value: 'tx' }], 'count'), [
+            { field: 'states', comparisonOperator: 'in', value: ['TX'] },
+        ]);
+        strict_1.default.deepEqual((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'typeOfInsurance', value: ['Homeowners'] }], 'count'), [
+            { field: 'typeOfInsurances', comparisonOperator: 'cn', value: ['Homeowners'] },
+        ]);
+    });
+    (0, node_test_1.it)('reads "eq" on a list field as an exact match and drops operators the field cannot take', () => {
+        strict_1.default.equal((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'filingTypes', comparisonOperator: 'eq', value: ['Form'] }], 'search')[0].comparisonOperator, 'in');
+        strict_1.default.equal((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'typeOfInsurances', comparisonOperator: 'ex', value: ['04.0'] }], 'search')[0].comparisonOperator, 'cn');
+    });
+    (0, node_test_1.it)('rejects empty values and unknown fields with the accepted list', () => {
+        strict_1.default.throws(() => (0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'typeOfInsurances', comparisonOperator: 'cn', value: [''] }], 'count'), /at least one value/);
+        strict_1.default.throws(() => (0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'resourceTypes', comparisonOperator: 'in', value: ['FILING'] }], 'count'), /not a filter field here\. Accepted: .*states/);
+        strict_1.default.throws(() => (0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'disposition.dispositionDate', comparisonOperator: 'gte', value: '2024-01-01' }], 'count'), /not a filter field/);
+        strict_1.default.doesNotThrow(() => (0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'disposition.dispositionDate', comparisonOperator: 'gte', value: '2024-01-01' }], 'summary'));
+    });
+    (0, node_test_1.it)('keeps dates as one string with a range operator and booleans with ex', () => {
+        strict_1.default.deepEqual((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'dateSubmitted', comparisonOperator: 'gte', value: ['2024-01-01'] }], 'search'), [
+            { field: 'dateSubmitted', comparisonOperator: 'gte', value: '2024-01-01' },
+        ]);
+        strict_1.default.throws(() => (0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'dateSubmitted', comparisonOperator: 'in', value: ['2024-01-01'] }], 'search'), /one date string with eq\/gt\/gte\/lt\/lte/);
+        strict_1.default.deepEqual((0, filingramp_contract_1.normalizeFilingsFilters)([{ field: 'hasObjection', value: 'true' }], 'search'), [
+            { field: 'hasObjection', comparisonOperator: 'ex', value: true },
+        ]);
+    });
+    (0, node_test_1.it)('maps plural groupBy names to the summary vocabulary and rejects the rest', () => {
+        strict_1.default.deepEqual((0, filingramp_contract_1.normalizeSummaryGroupBy)(['states', 'typeOfInsurance']), ['state', 'typeOfInsurance']);
+        strict_1.default.throws(() => (0, filingramp_contract_1.normalizeSummaryGroupBy)(['typeOfInsurances', 'month']), /groupBy accepts .*submittedMonth.*; not month/);
+        strict_1.default.equal((0, filingramp_contract_1.normalizeSummaryGroupBy)([]), undefined);
+    });
+});
+(0, node_test_1.describe)('document search contract', () => {
+    (0, node_test_1.it)('groups indexes by filter vocabulary', () => {
+        const groups = (0, filingramp_contract_1.documentIndexGroups)(['filings', 'objections', 'library_forms', 'responses']);
+        strict_1.default.deepEqual(groups.map((group) => group.indexes), [['filings'], ['objections', 'responses'], ['library_forms']]);
+        strict_1.default.ok(groups[0].fields.includes('dateSubmitted'));
+        strict_1.default.ok(!groups[2].fields.includes('states'));
+    });
+    (0, node_test_1.it)('converts the filings vocabulary and sets exact or partial operators per field', () => {
+        const [filings] = (0, filingramp_contract_1.documentIndexGroups)(['filings']);
+        const { filters, ignored } = (0, filingramp_contract_1.normalizeDocumentFilters)([
+            { field: 'typeOfInsurances', comparisonOperator: 'cn', value: ['04.0 Homeowners'] },
+            { field: 'state', value: 'tx' },
+            { field: 'authors', comparisonOperator: 'in', value: 'Smith' },
+            { field: 'dateSubmitted', comparisonOperator: 'gte', value: '2024-01-01' },
+        ], filings);
+        strict_1.default.deepEqual(filters, [
+            { field: 'typeOfInsurance', comparisonOperator: 'in', value: ['04.0 Homeowners'] },
+            { field: 'states', comparisonOperator: 'in', value: ['TX'] },
+            { field: 'authors', comparisonOperator: 'cn', value: ['Smith'] },
+            { field: 'dateSubmitted', comparisonOperator: 'gte', value: '2024-01-01' },
+        ]);
+        strict_1.default.deepEqual(ignored, []);
+    });
+    (0, node_test_1.it)('sets aside filters an index group cannot take instead of failing the request', () => {
+        const [library] = (0, filingramp_contract_1.documentIndexGroups)(['library_forms']);
+        const { filters, ignored } = (0, filingramp_contract_1.normalizeDocumentFilters)([
+            { field: 'states', value: ['TX'] },
+            { field: 'formNumbers', value: 'HO 3' },
+        ], library);
+        strict_1.default.deepEqual(filters, [{ field: 'formNumbers', comparisonOperator: 'in', value: ['HO 3'] }]);
+        strict_1.default.deepEqual(ignored, ['states']);
+    });
+});
+//# sourceMappingURL=filingramp-contract.test.js.map

package/dist/research/filingramp-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-contract.test.js","sourceRoot":"","sources":["../../src/research/filingramp-contract.test.ts"],"names":[],"mappings":"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"}

package/dist/research/filingramp-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filingramp-tools.d.ts","sourceRoot":"","sources":["../../src/research/filingramp-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAmHhF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CA0U3F"}
+{"version":3,"file":"filingramp-tools.d.ts","sourceRoot":"","sources":["../../src/research/filingramp-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAwJhF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAiZ3F"}