@brivioio/api-server-types 7.16.0 → 7.18.0

package/dist/candidateSearchResults.types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Normalized, display/filter-friendly fields lifted from a CrustData profile.
+ * The complete raw profile is kept alongside in `profile`.
+ */
+export type TCandidateSnapshot = {
+    /** Stable identity — normalized LinkedIn handle (e.g. "in/foo-bar"). */
+    candidateKey: string;
+    crustdataPersonId: string | null;
+    linkedinUrl: string;
+    name: string;
+    headline: string;
+    avatarUrl: string | null;
+    location: string;
+    currentTitle: string;
+    currentCompany: string;
+};
+/**
+ * One candidate returned by a sourcing search — the raw pool before
+ * shortlisting. Every candidate found across the round's searches is stored
+ * here, tagged with the org / role / requirement version it was sourced under,
+ * with its complete CrustData profile retained.
+ */
+export interface ICandidateSearchResult {
+    _id: string;
+    organizationId: string;
+    jobRoleId: string;
+    requirementVersion: number;
+    sourcingRunId: string;
+    candidateKey: string;
+    crustdataPersonId: string | null;
+    linkedinUrl: string;
+    name: string;
+    headline: string;
+    avatarUrl: string | null;
+    location: string;
+    currentTitle: string;
+    currentCompany: string;
+    /** Complete CrustData profile row (stored verbatim). */
+    profile: unknown;
+    /** 1-based index of the search that first surfaced this candidate. */
+    foundBySearchIndex: number;
+    internalTags: {
+        key: string;
+        value: string;
+    }[];
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=candidateSearchResults.types.d.ts.map

package/dist/candidateSearchResults.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidateSearchResults.types.d.ts","sourceRoot":"","sources":["../src/candidateSearchResults.types.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/candidateSearchResults.types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,10 +1,14 @@
+export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
 export * from './meetingBots.types';
 export * from './organizationDomains.types';
 export * from './organizationUsers.types';
 export * from './organizations.types';
+export * from './requirements.types';
+export * from './shortlists.types';
 export * from './slackChannels.types';
 export * from './slackMessages.types';
 export * from './slackWorkspaces.types';
+export * from './sourcingRuns.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,9 +1,13 @@
+export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
 export * from './meetingBots.types';
 export * from './organizationDomains.types';
 export * from './organizationUsers.types';
 export * from './organizations.types';
+export * from './requirements.types';
+export * from './shortlists.types';
 export * from './slackChannels.types';
 export * from './slackMessages.types';
 export * from './slackWorkspaces.types';
+export * from './sourcingRuns.types';

package/dist/jobRoleChatHistory.types.d.ts

@@ -49,11 +49,21 @@ export type TUserMultiChoiceResponse = {
     selectedOptionIds: string[];
     customText?: string;
 };
+/**
+ * A recruiter's verdict on a calibration candidate.
+ * - `positive` / `negative` — thumbs up / down for taste calibration.
+ * - `shortlist` — strong signal: the recruiter wants Brivio to reach out to this
+ *   exact person. Downstream sourcing guarantees shortlisted candidates appear in
+ *   the role's shortlist regardless of search ranking.
+ * - `neutral` — no verdict given (card left untouched).
+ */
+export type TCandidateReviewSentiment = 'positive' | 'negative' | 'neutral' | 'shortlist';
 export type TUserCandidateReviewResponse = {
     type: EJobRoleChatMessageType.CANDIDATE_REVIEW;
     reviews: {
         candidateId: string;
-        sentiment: 'positive' | 'negative' | 'neutral';
+        sentiment: TCandidateReviewSentiment;
+        /** Mandatory whenever `sentiment` is not `neutral` — the recruiter must say why. */
         note?: string;
     }[];
 };

package/dist/jobRoleChatHistory.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobRoleChatHistory.types.d.ts","sourceRoot":"","sources":["../src/jobRoleChatHistory.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jobRoleChatHistory.types.d.ts","sourceRoot":"","sources":["../src/jobRoleChatHistory.types.ts"],"names":[],"mappings":"AACA,oBAAY,sBAAsB;IAChC,iBAAiB,qBAAqB;IACtC,KAAK,UAAU;CAChB;AAED,oBAAY,uBAAuB;IACjC,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;CACtC;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,uBAAuB,CAAC,aAAa,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,uBAAuB,CAAC,YAAY,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,uBAAuB,CAAC,gBAAgB,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,wBAAwB,GACxB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,uBAAuB,CAAC,aAAa,CAAC;IAC5C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,uBAAuB,CAAC,YAAY,CAAC;IAC3C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAE1F,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,uBAAuB,CAAC,gBAAgB,CAAC;IAC/C,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,yBAAyB,CAAC;QACrC,oFAAoF;QACpF,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,wBAAwB,GACxB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,sBAAsB,CAAC;QAC7B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;KACnB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,uBAAuB,CAAC;IACrC,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,mBAAmB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/requirements.types.d.ts

@@ -0,0 +1,92 @@
+import type { IResponse } from './utils.types';
+/**
+ * Where a role's candidate-facing job description came from. This is the JD that
+ * gets shared with candidates over email during sourcing — distinct from
+ * `requirementsText`, which is the agent's internal brain dump.
+ */
+export declare enum EJobDescriptionSource {
+    /** Recruiter uploaded a JD file (PDF / image) during closeout. */
+    ATTACHMENT = "attachment",
+    /** Recruiter pasted an external JD link (careers page, Notion, etc.). */
+    LINK = "link",
+    /** No JD provided — the agent drafted one and the recruiter confirmed it. */
+    GENERATED = "generated"
+}
+export interface IJobDescription {
+    source: EJobDescriptionSource;
+    /**
+     * Candidate-facing JD body (markdown). Always populated for `generated` and
+     * `attachment` (extracted text); for `link` it may be a short blurb alongside
+     * the URL.
+     */
+    content: string;
+    /** External URL when `source = link` (or a hosted copy of an attachment). */
+    url: string | null;
+    /** Server-side workspace path of the uploaded file when `source = attachment`. */
+    attachmentPath: string | null;
+    /** True once the recruiter has explicitly confirmed this JD in the chat. */
+    confirmedByUser: boolean;
+}
+/**
+ * One immutable snapshot of a role's requirements. A new version is committed at
+ * intake closeout (v1) and again whenever a post-closeout change touches the
+ * role. Downstream sourcing always reads the `isLatest` version, and every
+ * search / shortlist record is tagged with this `version` number so results are
+ * traceable to the exact requirement they were sourced against.
+ */
+export interface IRequirement {
+    _id: string;
+    organizationId: string;
+    jobRoleId: string;
+    /** Sequential per role, starting at 1. The canonical tag for search/shortlist records. */
+    version: number;
+    /** Full `requirements.md` brain dump as it stood when this version was committed. */
+    requirementsText: string;
+    jobDescription: IJobDescription;
+    /** One-line note on what triggered this version (e.g. "Initial intake", "Salary band raised"). */
+    changeSummary: string;
+    /** The chat message that led to this version; null when committed outside a user turn. */
+    triggeredByMessageId: string | null;
+    /** Timestamp of `triggeredByMessageId` — the "version timestamp". */
+    triggeredByMessageAt: string;
+    /** Exactly one version per role is `isLatest: true`. */
+    isLatest: boolean;
+    /** Org user who owned the triggering turn; null when agent-authored. */
+    createdBy: string | null;
+    internalTags: {
+        key: string;
+        value: string;
+    }[];
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export type TJobDescription = {
+    source: EJobDescriptionSource;
+    content: string;
+    url: string | null;
+    attachmentPath: string | null;
+    confirmedByUser: boolean;
+};
+export type TRequirementVersion = {
+    id: string;
+    organizationId: string;
+    jobRoleId: string;
+    version: number;
+    requirementsText: string;
+    jobDescription: TJobDescription;
+    changeSummary: string;
+    triggeredByMessageAt: string;
+    isLatest: boolean;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare namespace RequirementsAPITypes {
+    type TListRequirementVersionsResponse = IResponse<{
+        versions: TRequirementVersion[];
+    } | null>;
+    type TGetLatestRequirementVersionResponse = IResponse<{
+        version: TRequirementVersion | null;
+    } | null>;
+}
+//# sourceMappingURL=requirements.types.d.ts.map

package/dist/requirements.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.types.d.ts","sourceRoot":"","sources":["../src/requirements.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B,kEAAkE;IAClE,UAAU,eAAe;IACzB,yEAAyE;IACzE,IAAI,SAAS;IACb,6EAA6E;IAC7E,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kFAAkF;IAClF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,eAAe,CAAC;IAChC,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,eAAe,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,gCAAgC,GAAG,SAAS,CAAC;QACvD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;KACjC,GAAG,IAAI,CAAC,CAAC;IAEV,KAAY,oCAAoC,GAAG,SAAS,CAAC;QAC3D,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;KACrC,GAAG,IAAI,CAAC,CAAC;CACX"}

package/dist/requirements.types.js

@@ -0,0 +1,14 @@
+/**
+ * Where a role's candidate-facing job description came from. This is the JD that
+ * gets shared with candidates over email during sourcing — distinct from
+ * `requirementsText`, which is the agent's internal brain dump.
+ */
+export var EJobDescriptionSource;
+(function (EJobDescriptionSource) {
+    /** Recruiter uploaded a JD file (PDF / image) during closeout. */
+    EJobDescriptionSource["ATTACHMENT"] = "attachment";
+    /** Recruiter pasted an external JD link (careers page, Notion, etc.). */
+    EJobDescriptionSource["LINK"] = "link";
+    /** No JD provided — the agent drafted one and the recruiter confirmed it. */
+    EJobDescriptionSource["GENERATED"] = "generated";
+})(EJobDescriptionSource || (EJobDescriptionSource = {}));

package/dist/shortlists.types.d.ts

@@ -0,0 +1,92 @@
+import type { IResponse } from './utils.types';
+export declare enum EShortlistSource {
+    /** Surfaced and selected by the sourcing search + scoring. */
+    SEARCH = "search",
+    /** Force-included because the recruiter shortlisted them during calibration. */
+    CALIBRATION = "calibration_shortlist"
+}
+/**
+ * Per-axis fit breakdown (each 0-100). Drives the composite `fitScore` and gives
+ * the recruiter an explainable "why this rank".
+ */
+export type TFitSubScores = {
+    /** Depth + relevance of past and current experience. */
+    experience: number;
+    /** Tenure stability — penalizes excessive switching / very short recent stints. */
+    tenureStability: number;
+    /** Relevance of domain / industry / problem space to the role. */
+    domainRelevance: number;
+    /** Match against the role's location / work-type requirements. */
+    locationFit: number;
+    /** Fit against the team's revealed archetype (builder / big-tech / founder / etc.). */
+    archetypeFit: number;
+};
+/**
+ * A curated, ranked shortlist entry for a (role, requirementVersion). This is
+ * what the frontend shortlist page reads. The complete CrustData profile is
+ * retained in `fullProfile`.
+ */
+export interface IShortlist {
+    _id: string;
+    organizationId: string;
+    jobRoleId: string;
+    requirementVersion: number;
+    sourcingRunId: string;
+    candidateKey: string;
+    crustdataPersonId: string | null;
+    linkedinUrl: string;
+    name: string;
+    headline: string;
+    avatarUrl: string | null;
+    location: string;
+    currentTitle: string;
+    currentCompany: string;
+    /** Composite fit score 0-100. */
+    fitScore: number;
+    subScores: TFitSubScores;
+    /** 1-based rank within this (role, requirementVersion); 1 = best fit. */
+    rank: number;
+    /** 3-4 short tags, ~3-4 words each (e.g. "Strong 0→1 builder", "Fintech domain"). */
+    remarks: string[];
+    /** One short paragraph on why this candidate made the shortlist. */
+    reasoning: string;
+    source: EShortlistSource;
+    /** Complete CrustData profile (stored verbatim). */
+    fullProfile: unknown;
+    internalTags: {
+        key: string;
+        value: string;
+    }[];
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export type TShortlistEntry = {
+    id: string;
+    jobRoleId: string;
+    requirementVersion: number;
+    candidateKey: string;
+    linkedinUrl: string;
+    name: string;
+    headline: string;
+    avatarUrl: string | null;
+    location: string;
+    currentTitle: string;
+    currentCompany: string;
+    fitScore: number;
+    subScores: TFitSubScores;
+    rank: number;
+    remarks: string[];
+    reasoning: string;
+    source: EShortlistSource;
+    createdAt: string;
+};
+export declare namespace ShortlistsAPITypes {
+    type TGetShortlistResponse = IResponse<{
+        entries: TShortlistEntry[];
+        requirementVersion: number | null;
+        /** True when a newer requirement version exists than the one this shortlist was sourced from. */
+        stale: boolean;
+    } | null>;
+}
+//# sourceMappingURL=shortlists.types.d.ts.map

package/dist/shortlists.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortlists.types.d.ts","sourceRoot":"","sources":["../src/shortlists.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,oBAAY,gBAAgB;IAC1B,8DAA8D;IAC9D,MAAM,WAAW;IACjB,gFAAgF;IAChF,WAAW,0BAA0B;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,yBAAiB,kBAAkB,CAAC;IAClC,KAAY,qBAAqB,GAAG,SAAS,CAAC;QAC5C,OAAO,EAAE,eAAe,EAAE,CAAC;QAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,iGAAiG;QACjG,KAAK,EAAE,OAAO,CAAC;KAChB,GAAG,IAAI,CAAC,CAAC;CACX"}

package/dist/shortlists.types.js

@@ -0,0 +1,7 @@
+export var EShortlistSource;
+(function (EShortlistSource) {
+    /** Surfaced and selected by the sourcing search + scoring. */
+    EShortlistSource["SEARCH"] = "search";
+    /** Force-included because the recruiter shortlisted them during calibration. */
+    EShortlistSource["CALIBRATION"] = "calibration_shortlist";
+})(EShortlistSource || (EShortlistSource = {}));

package/dist/sourcingRuns.types.d.ts

@@ -0,0 +1,95 @@
+import type { IResponse } from './utils.types';
+export declare enum ESourcingRunStatus {
+    QUEUED = "queued",
+    PROCESSING = "processing",
+    SUCCESS = "success",
+    FAILED = "failed"
+}
+/**
+ * What kicked off a run. `closeout` fires automatically when intake commits the
+ * first requirements version; `manual` is a recruiter-triggered re-run (e.g.
+ * after a post-closeout requirement change marked the shortlist stale).
+ */
+export declare enum ESourcingRunTrigger {
+    CLOSEOUT = "closeout",
+    MANUAL = "manual"
+}
+/**
+ * One search the agent ran during the round. Searches are sequential and
+ * adaptive — each one is tailored from the previous results — and capped at 15
+ * per round.
+ */
+export type TSourcingSearchEntry = {
+    /** 1-based order within the round (1..15). */
+    index: number;
+    /** CrustData tool used, e.g. "people_search_db" / "company_search_db". */
+    tool: string;
+    /** Why this query was run / how it was tailored from prior results. */
+    rationale: string;
+    /** Short human-readable summary of the filters applied. */
+    filtersSummary: string;
+    /** How many rows the search returned. */
+    resultsCount: number;
+    /** Net-new candidates added to the pool after dedup. */
+    newCandidatesCount: number;
+    ranAt: string;
+};
+export interface ISourcingRun {
+    _id: string;
+    organizationId: string;
+    jobRoleId: string;
+    /** The requirements document this run sourced against. */
+    requirementId: string;
+    /** Denormalized requirement version for tagging / querying. */
+    requirementVersion: number;
+    status: ESourcingRunStatus;
+    trigger: ESourcingRunTrigger;
+    /** Sourcing agent SDK session id (for debugging / resume). */
+    agentSessionId: string;
+    /** Log of the searches run this round (max 15). */
+    searches: TSourcingSearchEntry[];
+    searchCount: number;
+    /** Distinct candidates found across all searches. */
+    poolSize: number;
+    /** Candidates committed to the shortlist for this run. */
+    shortlistSize: number;
+    failureReason: string | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    /** Org user who triggered a manual run; null for automatic closeout runs. */
+    triggeredBy: string | null;
+    internalTags: {
+        key: string;
+        value: string;
+    }[];
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export type TSourcingRunStatus = {
+    id: string;
+    jobRoleId: string;
+    requirementVersion: number;
+    status: ESourcingRunStatus;
+    trigger: ESourcingRunTrigger;
+    searchCount: number;
+    poolSize: number;
+    shortlistSize: number;
+    failureReason: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare namespace SourcingRunsAPITypes {
+    type TListSourcingRunsResponse = IResponse<{
+        runs: TSourcingRunStatus[];
+        /** True when the latest committed requirement version has no successful run yet. */
+        shortlistStale: boolean;
+        latestRequirementVersion: number | null;
+    } | null>;
+    type TTriggerSourcingRunResponse = IResponse<{
+        run: TSourcingRunStatus;
+    } | null>;
+}
+//# sourceMappingURL=sourcingRuns.types.d.ts.map

package/dist/sourcingRuns.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcingRuns.types.d.ts","sourceRoot":"","sources":["../src/sourcingRuns.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,yBAAyB,GAAG,SAAS,CAAC;QAChD,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAC3B,oFAAoF;QACpF,cAAc,EAAE,OAAO,CAAC;QACxB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;KACzC,GAAG,IAAI,CAAC,CAAC;IAEV,KAAY,2BAA2B,GAAG,SAAS,CAAC;QAClD,GAAG,EAAE,kBAAkB,CAAC;KACzB,GAAG,IAAI,CAAC,CAAC;CACX"}

package/dist/sourcingRuns.types.js

@@ -0,0 +1,17 @@
+export var ESourcingRunStatus;
+(function (ESourcingRunStatus) {
+    ESourcingRunStatus["QUEUED"] = "queued";
+    ESourcingRunStatus["PROCESSING"] = "processing";
+    ESourcingRunStatus["SUCCESS"] = "success";
+    ESourcingRunStatus["FAILED"] = "failed";
+})(ESourcingRunStatus || (ESourcingRunStatus = {}));
+/**
+ * What kicked off a run. `closeout` fires automatically when intake commits the
+ * first requirements version; `manual` is a recruiter-triggered re-run (e.g.
+ * after a post-closeout requirement change marked the shortlist stale).
+ */
+export var ESourcingRunTrigger;
+(function (ESourcingRunTrigger) {
+    ESourcingRunTrigger["CLOSEOUT"] = "closeout";
+    ESourcingRunTrigger["MANUAL"] = "manual";
+})(ESourcingRunTrigger || (ESourcingRunTrigger = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brivioio/api-server-types",
-  "version": "7.16.0",
+  "version": "7.18.0",
   "description": "TypeScript type definitions for Brivio API Server",
   "type": "module",
   "main": "dist/index.js",