@brivioio/api-server-types 7.27.0 → 7.29.0

package/dist/candidateConversations.types.d.ts

@@ -1,3 +1,5 @@
+import type { TCandidateEmailMessageView } from './candidateEmailMessages.types';
+import type { IResponse } from './utils.types';
 /**
  * Lifecycle of a single candidate↔company email thread. The communication agent
  * advances this as the conversation progresses; the scheduler reads it to decide
@@ -30,6 +32,32 @@ export declare enum ECandidateInterest {
     ON_THE_FENCE = "on_the_fence",
     NOT_INTERESTED = "not_interested"
 }
+/**
+ * Structured details the reply agent gathers from an interested candidate over
+ * the thread. Role-facing answers (CTC, notice, location, switch intent) live
+ * here on the stable conversation; the phone is also mirrored onto the
+ * candidate-level `candidateContacts`, and the CV is stored in S3 with its
+ * extracted text kept here for downstream evaluation. Empty strings / nulls mean
+ * "not yet collected".
+ */
+export interface ICollectedInfo {
+    currentLocation: string;
+    currentCtc: string;
+    expectedCtc: string;
+    noticePeriod: string;
+    /** Whether the candidate is genuinely open to changing jobs. Null = unknown. */
+    openToSwitch: boolean | null;
+    /** Whether the candidate is open to relocation (if the role needs it). Null = unknown. */
+    openToRelocation: boolean | null;
+    phone: string;
+    cvReceived: boolean;
+    /** S3 object key for the candidate's CV, once received. */
+    cvStorageKey: string;
+    /** Extracted plain text of the CV (for evaluation). */
+    cvText: string;
+    /** Freeform agent notes on what's gathered and what's still outstanding. */
+    notes: string;
+}
 /**
  * A stable, threaded email conversation between the company (represented by the
  * agent) and one candidate, for one role. Keyed by (organization, role,
@@ -82,6 +110,16 @@ export interface ICandidateConversation {
     nextActionAt: Date | null;
     /** Message-ID header of the last email on the thread, for In-Reply-To threading. */
     lastMessageIdHeader: string;
+    /** Details collected from the candidate over the thread (interested path). */
+    collectedInfo: ICollectedInfo;
+    /**
+     * Set true when the candidate is interested AND all required info is captured —
+     * the signal for the downstream profile-evaluation agent (later phase) to score
+     * them and write a match decision onto the shortlist.
+     */
+    readyForEvaluation: boolean;
+    /** When the profile-evaluation agent last scored this candidate; null until run. */
+    evaluatedAt: Date | null;
     closedAt: Date | null;
     closedReason: string;
     internalTags: {
@@ -92,4 +130,52 @@ export interface ICandidateConversation {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Read-only details the team sees about what we've collected from a candidate
+ * over the thread (dashboard conversation view).
+ */
+export type TConversationCollectedInfo = {
+    currentLocation: string;
+    currentCtc: string;
+    expectedCtc: string;
+    noticePeriod: string;
+    openToSwitch: boolean | null;
+    openToRelocation: boolean | null;
+    phone: string;
+    cvReceived: boolean;
+    notes: string;
+};
+/**
+ * One candidate↔company conversation as the dashboard shows it: the thread header
+ * (status, interest, counters) plus its messages. Messages are
+ * `TCandidateEmailMessageView` (defined in candidateEmailMessages.types).
+ */
+export type TConversationThread = {
+    id: string;
+    jobRoleId: string;
+    candidateKey: string;
+    status: ECandidateConversationStatus;
+    interest: ECandidateInterest;
+    subject: string;
+    emailsSentCount: number;
+    reminderStage: number;
+    pocLoopedIn: boolean;
+    lastOutboundAt: string | null;
+    lastInboundAt: string | null;
+    collectedInfo: TConversationCollectedInfo;
+    readyForEvaluation: boolean;
+    evaluatedAt: string | null;
+    createdAt: string;
+    /** The full email thread, oldest first. */
+    messages: TCandidateEmailMessageView[];
+};
+export declare namespace CandidateConversationsAPITypes {
+    /**
+     * GET a single candidate's conversation thread for a role (read-only, for the
+     * dashboard). `null` when no conversation exists for that candidate yet.
+     */
+    type TGetConversationResponse = IResponse<{
+        conversation: TConversationThread | null;
+    } | null>;
+}
 //# sourceMappingURL=candidateConversations.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"candidateConversations.types.d.ts","sourceRoot":"","sources":["../src/candidateConversations.types.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,oBAAY,4BAA4B;IACtC,8EAA8E;IAC9E,WAAW,gBAAgB;IAC3B,+EAA+E;IAC/E,kBAAkB,uBAAuB;IACzC,mEAAmE;IACnE,gBAAgB,qBAAqB;IACrC,mFAAmF;IACnF,YAAY,iBAAiB;IAC7B,kFAAkF;IAClF,eAAe,oBAAoB;IACnC,0EAA0E;IAC1E,iBAAiB,sBAAsB;IACvC,mCAAmC;IACnC,qBAAqB,0BAA0B;IAC/C,gEAAgE;IAChE,kBAAkB,uBAAuB;IACzC,wEAAwE;IACxE,YAAY,iBAAiB;CAC9B;AAED,yEAAyE;AACzE,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,4BAA4B,CAAC;IACrC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,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"}
+{"version":3,"file":"candidateConversations.types.d.ts","sourceRoot":"","sources":["../src/candidateConversations.types.ts"],"names":[],"mappings":"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"}

package/dist/candidateEmailMessages.types.d.ts

@@ -46,6 +46,32 @@ export interface IEmailAttachment {
     /** S3 object key where the attachment bytes are stored. */
     storageKey: string;
 }
+/** An attachment as the dashboard shows it (no storage internals beyond the key). */
+export type TEmailAttachmentView = {
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    storageKey: string;
+};
+/**
+ * One email on a conversation, as the dashboard renders it (read-only). Plain
+ * fields only — no threading internals.
+ */
+export type TCandidateEmailMessageView = {
+    id: string;
+    direction: EEmailDirection;
+    purpose: EEmailPurpose;
+    subject: string;
+    body: string;
+    fromAddress: string;
+    toAddresses: string[];
+    ccAddresses: string[];
+    attachments: TEmailAttachmentView[];
+    deliveryStatus: EEmailDeliveryStatus;
+    sentAt: string | null;
+    receivedAt: string | null;
+    createdAt: string;
+};
 /**
  * One email on a candidate conversation — sent by us or received from the
  * candidate / POC. This is the durable audit trail: every email's purpose, body,

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

@@ -1 +1 @@
-{"version":3,"file":"candidateEmailMessages.types.d.ts","sourceRoot":"","sources":["../src/candidateEmailMessages.types.ts"],"names":[],"mappings":"AACA,oBAAY,eAAe;IACzB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,sDAAsD;IACtD,cAAc,mBAAmB;IACjC,qDAAqD;IACrD,QAAQ,aAAa;IACrB,qEAAqE;IACrE,YAAY,iBAAiB;IAC7B,kFAAkF;IAClF,YAAY,iBAAiB;IAC7B,+EAA+E;IAC/E,WAAW,gBAAgB;IAC3B,2EAA2E;IAC3E,mBAAmB,wBAAwB;IAC3C,6CAA6C;IAC7C,iBAAiB,sBAAsB;IACvC,kEAAkE;IAClE,WAAW,gBAAgB;IAC3B,kCAAkC;IAClC,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,cAAc,EAAE,oBAAoB,CAAC;IACrC,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"candidateEmailMessages.types.d.ts","sourceRoot":"","sources":["../src/candidateEmailMessages.types.ts"],"names":[],"mappings":"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"}

package/dist/shortlists.types.d.ts

@@ -1,3 +1,4 @@
+import type { ECandidateConversationStatus, ECandidateInterest } from './candidateConversations.types';
 import type { IResponse } from './utils.types';
 export declare enum EShortlistSource {
     /** Surfaced and selected by the sourcing search + scoring. */
@@ -54,6 +55,62 @@ export type TShortlistFeedback = {
     submittedAt: string | null;
     updatedAt: string;
 };
+/**
+ * How well a candidate matches the role after the full end-to-end evaluation
+ * (profile + collected info + CV, weighed against the role's latest requirements,
+ * calibration, and team feedback). This is the team-facing verdict on the
+ * shortlist, distinct from the sourcing-time `fitScore`.
+ */
+export declare enum EShortlistMatchLevel {
+    /** Spot on — meets the bar across the board. */
+    EXACT = "exact",
+    /** Partial / "sort of" — a real fit with some gaps. */
+    SORTA = "sorta",
+    /** Low match — notable gaps against the requirements. */
+    LOW = "low",
+    /** Not a match. */
+    NONE = "none"
+}
+/**
+ * The profile-evaluation agent's verdict on a candidate, written onto the
+ * shortlist entry once the candidate is interested and their details are
+ * collected. Visible to the team in the dashboard.
+ */
+export interface IShortlistEvaluation {
+    matchLevel: EShortlistMatchLevel;
+    /** 0-100 overall rating from the evaluation (separate from sourcing `fitScore`). */
+    rating: number;
+    /** Short, team-facing summary of the verdict. */
+    summary: string;
+    /** A few concrete strengths against the role. */
+    strengths: string[];
+    /** A few concrete gaps / risks against the role. */
+    concerns: string[];
+    /** The requirement version this evaluation was made against. */
+    requirementVersion: number;
+    decidedAt: string;
+}
+export type TShortlistEvaluation = {
+    matchLevel: EShortlistMatchLevel;
+    rating: number;
+    summary: string;
+    strengths: string[];
+    concerns: string[];
+    requirementVersion: number;
+    decidedAt: string;
+};
+/**
+ * The candidate's outreach/conversation state, surfaced onto the shortlist entry
+ * so the team sees where each candidate stands in the email flow at a glance.
+ * Null when no conversation has been provisioned for the candidate yet.
+ */
+export type TShortlistOutreachStatus = {
+    status: ECandidateConversationStatus;
+    interest: ECandidateInterest;
+    emailsSentCount: number;
+    lastOutboundAt: string | null;
+    lastInboundAt: string | null;
+};
 /**
  * Per-axis fit breakdown (each 0-100). Drives the composite `fitScore` and gives
  * the recruiter an explainable "why this rank".
@@ -101,6 +158,11 @@ export interface IShortlist {
     source: EShortlistSource;
     /** Per-teammate verdict + note on this candidate; empty until anyone reviews. */
     feedback: IShortlistFeedback[];
+    /**
+     * The profile-evaluation agent's verdict, written once the candidate is
+     * interested and their info is collected. Null until evaluated.
+     */
+    evaluation: IShortlistEvaluation | null;
     internalTags: {
         key: string;
         value: string;
@@ -128,6 +190,10 @@ export type TShortlistEntry = {
     reasoning: string;
     source: EShortlistSource;
     feedback: TShortlistFeedback[];
+    /** End-to-end match verdict from the evaluation agent; null until evaluated. */
+    evaluation: TShortlistEvaluation | null;
+    /** Where the candidate stands in the email outreach flow; null if not provisioned. */
+    outreach: TShortlistOutreachStatus | null;
     createdAt: string;
 };
 /**

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

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

package/dist/shortlists.types.js

@@ -29,3 +29,20 @@ export var EShortlistFeedbackStatus;
     EShortlistFeedbackStatus["DRAFT"] = "draft";
     EShortlistFeedbackStatus["SUBMITTED"] = "submitted";
 })(EShortlistFeedbackStatus || (EShortlistFeedbackStatus = {}));
+/**
+ * How well a candidate matches the role after the full end-to-end evaluation
+ * (profile + collected info + CV, weighed against the role's latest requirements,
+ * calibration, and team feedback). This is the team-facing verdict on the
+ * shortlist, distinct from the sourcing-time `fitScore`.
+ */
+export var EShortlistMatchLevel;
+(function (EShortlistMatchLevel) {
+    /** Spot on — meets the bar across the board. */
+    EShortlistMatchLevel["EXACT"] = "exact";
+    /** Partial / "sort of" — a real fit with some gaps. */
+    EShortlistMatchLevel["SORTA"] = "sorta";
+    /** Low match — notable gaps against the requirements. */
+    EShortlistMatchLevel["LOW"] = "low";
+    /** Not a match. */
+    EShortlistMatchLevel["NONE"] = "none";
+})(EShortlistMatchLevel || (EShortlistMatchLevel = {}));

package/package.json

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