lumnisai 0.5.43 → 0.5.44

package/dist/index.cjs

@@ -1044,6 +1044,12 @@ class CrmResource {
    * details through `accountRef`. Provider degradation and unknown deal stages
    * are returned explicitly and must not be treated as safe negative results.
    *
+   * Capped at 100 candidates per request; chunk longer lists and reassemble by
+   * `inputKey`. Provider selection comes from the resolved owner's active
+   * HubSpot/Attio connections: no active supported connection is
+   * `409 crm_not_connected`, and a connection-verification failure is a
+   * retryable `503 crm_connection_status_unavailable`.
+   *
    * @example
    * ```typescript
    * const context = await client.crm.accountContextBatch({
@@ -3242,7 +3248,13 @@ class ResponsesResource {
       throw new ValidationError("criteria_definitions cannot be empty");
     const criterionIds = /* @__PURE__ */ new Set();
     const columnNames = /* @__PURE__ */ new Set();
-    const validTypes = ["universal", "varying", "validation_only"];
+    const validTypes = [
+      "universal",
+      "post_hard",
+      "varying",
+      "post_soft",
+      "validation_only"
+    ];
     criteriaDefinitions.forEach((criterion, index) => {
       if (!this._isPlainObject(criterion))
         throw new ValidationError(`Criterion ${index} must be an object`);
@@ -3276,7 +3288,9 @@ class ResponsesResource {
     if (!this._isPlainObject(criteriaClassification))
       throw new ValidationError("criteria_classification must be an object");
     const universalCriteria = this._getParamValue(criteriaClassification, "universalCriteria", "universal_criteria");
+    const postHardCriteria = this._getParamValue(criteriaClassification, "postHardCriteria", "post_hard_criteria");
     const varyingCriteria = this._getParamValue(criteriaClassification, "varyingCriteria", "varying_criteria");
+    const postSoftCriteria = this._getParamValue(criteriaClassification, "postSoftCriteria", "post_soft_criteria");
     const validationOnlyCriteria = this._getParamValue(criteriaClassification, "validationOnlyCriteria", "validation_only_criteria");
     if (!Array.isArray(universalCriteria))
       throw new ValidationError("criteria_classification missing or invalid universal_criteria");
@@ -3284,6 +3298,10 @@ class ResponsesResource {
       throw new ValidationError("criteria_classification missing or invalid varying_criteria");
     if (!Array.isArray(validationOnlyCriteria))
       throw new ValidationError("criteria_classification missing or invalid validation_only_criteria");
+    if (postHardCriteria !== void 0 && !Array.isArray(postHardCriteria))
+      throw new ValidationError("criteria_classification has invalid post_hard_criteria");
+    if (postSoftCriteria !== void 0 && !Array.isArray(postSoftCriteria))
+      throw new ValidationError("criteria_classification has invalid post_soft_criteria");
   }
   _validateCompetitorPostEngagementParams(params) {
     const company = this._getParamValue(params, "company", "company");

package/dist/index.d.cts

@@ -2322,7 +2322,7 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
-type CriterionType = 'universal' | 'varying' | 'validation_only';
+type CriterionType = 'universal' | 'post_hard' | 'varying' | 'post_soft' | 'validation_only';
 type ColumnKind = 'extraction' | 'verdict';
 /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
 type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
@@ -2332,6 +2332,14 @@ interface CriterionDefinition {
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Exact user-prompt clause supporting the generated criterion, when available. */
+    sourceClauseQuote?: string;
+    /** The grounded fidelity audit edited, retyped, or added this criterion. */
+    auditMutated?: 'edited' | 'edited+retyped' | 'added';
+    /** The deterministic source-clause strength guard retyped this criterion. */
+    strengthGuardMutated?: boolean;
+    /** Machine-readable explanation for a deterministic strength retype. */
+    strengthGuardReason?: string;
     /** Expected answer shape for an extraction column. */
     answerFormat?: string;
     /** Whether this criterion extracts a value or produces a score-bearing verdict. */
@@ -2347,10 +2355,14 @@ interface CriterionDefinition {
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
+    postHardCriteria?: CriterionDefinition[];
     varyingCriteria: CriterionDefinition[];
+    postSoftCriteria?: CriterionDefinition[];
     validationOnlyCriteria: CriterionDefinition[];
     universalReasoning?: string;
+    postHardReasoning?: string;
     varyingReasoning?: string;
+    postSoftReasoning?: string;
     validationReasoning?: string;
 }
 interface AddCriterionRequest {
@@ -2419,7 +2431,7 @@ interface EvidenceSource {
 interface CriterionResult {
     /** Unique identifier matching criteria definition */
     criterionId: string;
-    /** Type: universal, varying, or validation_only */
+    /** Type encodes both requirement strength and evaluation stage. */
     criterionType: CriterionType;
     /** Column name for display */
     columnName: string;
@@ -2605,6 +2617,13 @@ interface ValidatedCandidate {
      * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
+    /**
+     * Legacy-named aggregate: true when any universal or post_hard criterion
+     * could not be decided from sufficient evidence.
+     */
+    anyUniversalUncertain?: boolean;
+    /** Explicit alias for anyUniversalUncertain covering every hard criterion. */
+    anyHardUncertain?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
      * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
@@ -2643,11 +2662,16 @@ interface ValidatedCandidate {
         jobCount?: number;
         signalSource?: string;
         sampleJobListings?: Array<{
+            jobId?: string | number | null;
             title?: string;
             description?: string;
             workplaceType?: string;
             country?: string;
             dateAdded?: string;
+            dateUpdated?: string;
+            checkedAt?: string;
+            url?: string | null;
+            source?: string | null;
         }>;
     };
     /** Raw profile data */
@@ -4613,7 +4637,8 @@ interface CrmAccountContextCandidateInput {
 }
 /**
  * Query exact-person and account/deal context across all configured CRMs.
- * The backend accepts 1..1000 candidates per request.
+ * The backend accepts 1..100 candidates per request; chunk longer lists
+ * client-side and reassemble by `inputKey`.
  */
 interface CrmAccountContextBatchRequest {
     /** UUID or email of the CRM owner whose context is queried. */
@@ -4730,8 +4755,9 @@ interface CrmAccountContextBatchResponse {
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
- * - `503 account_context_not_configured` — account-context serving data is not
- *   configured for the requested CRM owner.
+ * - `503 crm_connection_status_unavailable` (account context) — the provider
+ *   connection status could not be verified. Retryable; the response includes
+ *   a `Retry-After` header. Distinct from `409 crm_not_connected`.
  */
 declare class CrmResource {
     private readonly http;
@@ -4802,6 +4828,12 @@ declare class CrmResource {
      * details through `accountRef`. Provider degradation and unknown deal stages
      * are returned explicitly and must not be treated as safe negative results.
      *
+     * Capped at 100 candidates per request; chunk longer lists and reassemble by
+     * `inputKey`. Provider selection comes from the resolved owner's active
+     * HubSpot/Attio connections: no active supported connection is
+     * `409 crm_not_connected`, and a connection-verification failure is a
+     * retryable `503 crm_connection_status_unavailable`.
+     *
      * @example
      * ```typescript
      * const context = await client.crm.accountContextBatch({

package/dist/index.d.mts

@@ -2322,7 +2322,7 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
-type CriterionType = 'universal' | 'varying' | 'validation_only';
+type CriterionType = 'universal' | 'post_hard' | 'varying' | 'post_soft' | 'validation_only';
 type ColumnKind = 'extraction' | 'verdict';
 /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
 type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
@@ -2332,6 +2332,14 @@ interface CriterionDefinition {
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Exact user-prompt clause supporting the generated criterion, when available. */
+    sourceClauseQuote?: string;
+    /** The grounded fidelity audit edited, retyped, or added this criterion. */
+    auditMutated?: 'edited' | 'edited+retyped' | 'added';
+    /** The deterministic source-clause strength guard retyped this criterion. */
+    strengthGuardMutated?: boolean;
+    /** Machine-readable explanation for a deterministic strength retype. */
+    strengthGuardReason?: string;
     /** Expected answer shape for an extraction column. */
     answerFormat?: string;
     /** Whether this criterion extracts a value or produces a score-bearing verdict. */
@@ -2347,10 +2355,14 @@ interface CriterionDefinition {
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
+    postHardCriteria?: CriterionDefinition[];
     varyingCriteria: CriterionDefinition[];
+    postSoftCriteria?: CriterionDefinition[];
     validationOnlyCriteria: CriterionDefinition[];
     universalReasoning?: string;
+    postHardReasoning?: string;
     varyingReasoning?: string;
+    postSoftReasoning?: string;
     validationReasoning?: string;
 }
 interface AddCriterionRequest {
@@ -2419,7 +2431,7 @@ interface EvidenceSource {
 interface CriterionResult {
     /** Unique identifier matching criteria definition */
     criterionId: string;
-    /** Type: universal, varying, or validation_only */
+    /** Type encodes both requirement strength and evaluation stage. */
     criterionType: CriterionType;
     /** Column name for display */
     columnName: string;
@@ -2605,6 +2617,13 @@ interface ValidatedCandidate {
      * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
+    /**
+     * Legacy-named aggregate: true when any universal or post_hard criterion
+     * could not be decided from sufficient evidence.
+     */
+    anyUniversalUncertain?: boolean;
+    /** Explicit alias for anyUniversalUncertain covering every hard criterion. */
+    anyHardUncertain?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
      * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
@@ -2643,11 +2662,16 @@ interface ValidatedCandidate {
         jobCount?: number;
         signalSource?: string;
         sampleJobListings?: Array<{
+            jobId?: string | number | null;
             title?: string;
             description?: string;
             workplaceType?: string;
             country?: string;
             dateAdded?: string;
+            dateUpdated?: string;
+            checkedAt?: string;
+            url?: string | null;
+            source?: string | null;
         }>;
     };
     /** Raw profile data */
@@ -4613,7 +4637,8 @@ interface CrmAccountContextCandidateInput {
 }
 /**
  * Query exact-person and account/deal context across all configured CRMs.
- * The backend accepts 1..1000 candidates per request.
+ * The backend accepts 1..100 candidates per request; chunk longer lists
+ * client-side and reassemble by `inputKey`.
  */
 interface CrmAccountContextBatchRequest {
     /** UUID or email of the CRM owner whose context is queried. */
@@ -4730,8 +4755,9 @@ interface CrmAccountContextBatchResponse {
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
- * - `503 account_context_not_configured` — account-context serving data is not
- *   configured for the requested CRM owner.
+ * - `503 crm_connection_status_unavailable` (account context) — the provider
+ *   connection status could not be verified. Retryable; the response includes
+ *   a `Retry-After` header. Distinct from `409 crm_not_connected`.
  */
 declare class CrmResource {
     private readonly http;
@@ -4802,6 +4828,12 @@ declare class CrmResource {
      * details through `accountRef`. Provider degradation and unknown deal stages
      * are returned explicitly and must not be treated as safe negative results.
      *
+     * Capped at 100 candidates per request; chunk longer lists and reassemble by
+     * `inputKey`. Provider selection comes from the resolved owner's active
+     * HubSpot/Attio connections: no active supported connection is
+     * `409 crm_not_connected`, and a connection-verification failure is a
+     * retryable `503 crm_connection_status_unavailable`.
+     *
      * @example
      * ```typescript
      * const context = await client.crm.accountContextBatch({

package/dist/index.d.ts

@@ -2322,7 +2322,7 @@ interface AgentConfig {
 interface ModelOverrides {
     [key: string]: string;
 }
-type CriterionType = 'universal' | 'varying' | 'validation_only';
+type CriterionType = 'universal' | 'post_hard' | 'varying' | 'post_soft' | 'validation_only';
 type ColumnKind = 'extraction' | 'verdict';
 /** SLM relevance reranker tier (deep_people_search / people_scoring output). */
 type RelevanceTier = 'STRONG_MATCH' | 'PARTIAL_MATCH' | 'WEAK_MATCH';
@@ -2332,6 +2332,14 @@ interface CriterionDefinition {
     criterionText: string;
     criterionType: CriterionType;
     weight: number;
+    /** Exact user-prompt clause supporting the generated criterion, when available. */
+    sourceClauseQuote?: string;
+    /** The grounded fidelity audit edited, retyped, or added this criterion. */
+    auditMutated?: 'edited' | 'edited+retyped' | 'added';
+    /** The deterministic source-clause strength guard retyped this criterion. */
+    strengthGuardMutated?: boolean;
+    /** Machine-readable explanation for a deterministic strength retype. */
+    strengthGuardReason?: string;
     /** Expected answer shape for an extraction column. */
     answerFormat?: string;
     /** Whether this criterion extracts a value or produces a score-bearing verdict. */
@@ -2347,10 +2355,14 @@ interface CriterionDefinition {
 }
 interface CriteriaClassification {
     universalCriteria: CriterionDefinition[];
+    postHardCriteria?: CriterionDefinition[];
     varyingCriteria: CriterionDefinition[];
+    postSoftCriteria?: CriterionDefinition[];
     validationOnlyCriteria: CriterionDefinition[];
     universalReasoning?: string;
+    postHardReasoning?: string;
     varyingReasoning?: string;
+    postSoftReasoning?: string;
     validationReasoning?: string;
 }
 interface AddCriterionRequest {
@@ -2419,7 +2431,7 @@ interface EvidenceSource {
 interface CriterionResult {
     /** Unique identifier matching criteria definition */
     criterionId: string;
-    /** Type: universal, varying, or validation_only */
+    /** Type encodes both requirement strength and evaluation stage. */
     criterionType: CriterionType;
     /** Column name for display */
     columnName: string;
@@ -2605,6 +2617,13 @@ interface ValidatedCandidate {
      * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
+    /**
+     * Legacy-named aggregate: true when any universal or post_hard criterion
+     * could not be decided from sufficient evidence.
+     */
+    anyUniversalUncertain?: boolean;
+    /** Explicit alias for anyUniversalUncertain covering every hard criterion. */
+    anyHardUncertain?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
      * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
@@ -2643,11 +2662,16 @@ interface ValidatedCandidate {
         jobCount?: number;
         signalSource?: string;
         sampleJobListings?: Array<{
+            jobId?: string | number | null;
             title?: string;
             description?: string;
             workplaceType?: string;
             country?: string;
             dateAdded?: string;
+            dateUpdated?: string;
+            checkedAt?: string;
+            url?: string | null;
+            source?: string | null;
         }>;
     };
     /** Raw profile data */
@@ -4613,7 +4637,8 @@ interface CrmAccountContextCandidateInput {
 }
 /**
  * Query exact-person and account/deal context across all configured CRMs.
- * The backend accepts 1..1000 candidates per request.
+ * The backend accepts 1..100 candidates per request; chunk longer lists
+ * client-side and reassemble by `inputKey`.
  */
 interface CrmAccountContextBatchRequest {
     /** UUID or email of the CRM owner whose context is queried. */
@@ -4730,8 +4755,9 @@ interface CrmAccountContextBatchResponse {
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
- * - `503 account_context_not_configured` — account-context serving data is not
- *   configured for the requested CRM owner.
+ * - `503 crm_connection_status_unavailable` (account context) — the provider
+ *   connection status could not be verified. Retryable; the response includes
+ *   a `Retry-After` header. Distinct from `409 crm_not_connected`.
  */
 declare class CrmResource {
     private readonly http;
@@ -4802,6 +4828,12 @@ declare class CrmResource {
      * details through `accountRef`. Provider degradation and unknown deal stages
      * are returned explicitly and must not be treated as safe negative results.
      *
+     * Capped at 100 candidates per request; chunk longer lists and reassemble by
+     * `inputKey`. Provider selection comes from the resolved owner's active
+     * HubSpot/Attio connections: no active supported connection is
+     * `409 crm_not_connected`, and a connection-verification failure is a
+     * retryable `503 crm_connection_status_unavailable`.
+     *
      * @example
      * ```typescript
      * const context = await client.crm.accountContextBatch({

package/dist/index.mjs

@@ -1038,6 +1038,12 @@ class CrmResource {
    * details through `accountRef`. Provider degradation and unknown deal stages
    * are returned explicitly and must not be treated as safe negative results.
    *
+   * Capped at 100 candidates per request; chunk longer lists and reassemble by
+   * `inputKey`. Provider selection comes from the resolved owner's active
+   * HubSpot/Attio connections: no active supported connection is
+   * `409 crm_not_connected`, and a connection-verification failure is a
+   * retryable `503 crm_connection_status_unavailable`.
+   *
    * @example
    * ```typescript
    * const context = await client.crm.accountContextBatch({
@@ -3236,7 +3242,13 @@ class ResponsesResource {
       throw new ValidationError("criteria_definitions cannot be empty");
     const criterionIds = /* @__PURE__ */ new Set();
     const columnNames = /* @__PURE__ */ new Set();
-    const validTypes = ["universal", "varying", "validation_only"];
+    const validTypes = [
+      "universal",
+      "post_hard",
+      "varying",
+      "post_soft",
+      "validation_only"
+    ];
     criteriaDefinitions.forEach((criterion, index) => {
       if (!this._isPlainObject(criterion))
         throw new ValidationError(`Criterion ${index} must be an object`);
@@ -3270,7 +3282,9 @@ class ResponsesResource {
     if (!this._isPlainObject(criteriaClassification))
       throw new ValidationError("criteria_classification must be an object");
     const universalCriteria = this._getParamValue(criteriaClassification, "universalCriteria", "universal_criteria");
+    const postHardCriteria = this._getParamValue(criteriaClassification, "postHardCriteria", "post_hard_criteria");
     const varyingCriteria = this._getParamValue(criteriaClassification, "varyingCriteria", "varying_criteria");
+    const postSoftCriteria = this._getParamValue(criteriaClassification, "postSoftCriteria", "post_soft_criteria");
     const validationOnlyCriteria = this._getParamValue(criteriaClassification, "validationOnlyCriteria", "validation_only_criteria");
     if (!Array.isArray(universalCriteria))
       throw new ValidationError("criteria_classification missing or invalid universal_criteria");
@@ -3278,6 +3292,10 @@ class ResponsesResource {
       throw new ValidationError("criteria_classification missing or invalid varying_criteria");
     if (!Array.isArray(validationOnlyCriteria))
       throw new ValidationError("criteria_classification missing or invalid validation_only_criteria");
+    if (postHardCriteria !== void 0 && !Array.isArray(postHardCriteria))
+      throw new ValidationError("criteria_classification has invalid post_hard_criteria");
+    if (postSoftCriteria !== void 0 && !Array.isArray(postSoftCriteria))
+      throw new ValidationError("criteria_classification has invalid post_soft_criteria");
   }
   _validateCompetitorPostEngagementParams(params) {
     const company = this._getParamValue(params, "company", "company");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lumnisai",
   "type": "module",
-  "version": "0.5.43",
+  "version": "0.5.44",
   "description": "Official Node.js SDK for the Lumnis AI API",
   "author": "Lumnis AI",
   "license": "MIT",