lumnisai 0.5.36 → 0.5.37

package/dist/index.cjs

@@ -3870,6 +3870,8 @@ class ResponsesResource {
    * The backend searches for the audience, collects their reaction history,
    * saves the normalized package, and produces grounded views from it. Pass
    * `reusePackageFrom` to re-cook a saved package without collecting again.
+   * `companyContext` and `contentDirection` steer post ideas only; collection,
+   * curation, and engagement analysis remain an unbiased read of the audience.
    *
    * @param query - Natural-language description of the audience. A nonblank
    *   message is required even when reusing a package.
@@ -3888,6 +3890,10 @@ class ResponsesResource {
       params.postsEnableFiltering = options.postsEnableFiltering;
     if (options.exaResultsPerQuery !== void 0)
       params.exaResultsPerQuery = options.exaResultsPerQuery;
+    if (options.companyContext !== void 0)
+      params.companyContext = options.companyContext;
+    if (options.contentDirection !== void 0)
+      params.contentDirection = options.contentDirection;
     if (options.reusePackageFrom !== void 0)
       params.reusePackageFrom = options.reusePackageFrom;
     if (options.outputs !== void 0)

package/dist/index.d.cts

@@ -1138,6 +1138,16 @@ interface ContentIntelligenceOptions {
     postsEnableFiltering?: boolean;
     /** Results requested from each Exa people-search query. The search lane defaults to 100. */
     exaResultsPerQuery?: number;
+    /**
+     * Company the post ideas are for. Used only to tailor post ideas; it does not
+     * affect search, curation, engagement analysis, or grounding of neutral drafts.
+     */
+    companyContext?: string;
+    /**
+     * Requested content style, angle, format, or exclusions. Used only to tailor
+     * post ideas so audience discovery and analysis remain unbiased.
+     */
+    contentDirection?: string;
     /** Re-cook the package stored on this response ID without collecting again. */
     reusePackageFrom?: string;
     /** Outputs to produce. Omit to use the backend's current default set. */
@@ -1148,6 +1158,8 @@ interface ContentIntelligenceResolvedParams {
     postsDateRange: PostsDateRange;
     postsEnableFiltering: boolean;
     exaResultsPerQuery?: number | null;
+    companyContext?: string | null;
+    contentDirection?: string | null;
     reusePackageFrom?: string | null;
     outputs: ContentIntelligenceOutputName[];
 }
@@ -1220,20 +1232,36 @@ interface PostIdea {
         url?: string | null;
         author?: string | null;
     }>;
+    /** Neutral draft, with no company mention. */
     draft: string;
+    /**
+     * The same post rewritten with an honest company tie-in. Null when no
+     * company context was supplied.
+     */
+    draftWithCompany?: string | null;
     probability: number;
     keysExist: number;
     keysCited: number;
     supported: boolean;
     groundingReason: string;
+    /** Independent grounding verdict for `draftWithCompany`. */
+    supportedWithCompany?: boolean;
+    /** Why `draftWithCompany` did or did not pass its two-source grounding check. */
+    groundingReasonWithCompany?: string;
 }
 interface PostIdeasOutput {
     artifact: 'post_ideas';
     n: number;
     ideas: PostIdea[];
     allSupported?: boolean;
+    /** Number of ideas that include a company-tailored draft. */
+    draftsWithCompany?: number;
+    /** Number of company-tailored drafts that passed grounding. */
+    companyDraftsSupported?: number;
     postsSeen?: number;
     chunks?: number;
+    /** Request fields that actually steered the generated post ideas. */
+    steeredBy?: Array<'company_context' | 'content_direction'>;
     note?: string;
 }
 interface ThemeStats {
@@ -2522,14 +2550,24 @@ interface SpecializedAgentParams {
      */
     competitors?: string[];
     /**
-     * Free-text summary of what the seed company does. Anchors competitor
-     * discovery so the ReAct doesn't misclassify ambiguous domains
-     * (e.g. "lumnis.ai" → academic AI vs sales automation).
-     * Used when `company` is provided (discovery mode).
+     * Free-text summary of what a company does.
+     *
+     * For competitor_post_engagement, this describes the seed company and
+     * anchors discovery when `company` is provided. For content_intelligence,
+     * this describes the company the post ideas are for and steers only those
+     * ideas; search, curation, and engagement analysis remain unsteered.
      *
      * @example 'AI-powered outbound automation for B2B sales — books meetings via LinkedIn + email on autopilot'
      */
     companyContext?: string;
+    /**
+     * Desired content type, angle, format, or exclusions for post ideas.
+     * Used only by content_intelligence post-idea generation; it does not steer
+     * search, curation, or engagement analysis.
+     *
+     * @example 'Practitioner how-tos, not hot takes; no hiring posts'
+     */
+    contentDirection?: string;
     /**
      * Optional list of known-good example competitors. The discovery ReAct
      * uses these as anchors and finds more in the same vertical.
@@ -4178,6 +4216,13 @@ interface EmailInboxItem {
     status: string;
     /** inboxkit | unipile | smtp */
     source: string;
+    /**
+     * Connection app code for BYO inboxes: GOOGLE | OUTLOOK | MAIL. Null for
+     * managed (InboxKit) mailboxes, which have no Unipile connection. Prefer this
+     * over guessing from the address domain — a Workspace/365 custom domain is
+     * indistinguishable from a generic IMAP host by domain alone.
+     */
+    provider?: string | null;
     dailySendCap: number;
     sendsToday: number;
     organizationId: string;
@@ -6700,6 +6745,8 @@ declare class ResponsesResource {
      * The backend searches for the audience, collects their reaction history,
      * saves the normalized package, and produces grounded views from it. Pass
      * `reusePackageFrom` to re-cook a saved package without collecting again.
+     * `companyContext` and `contentDirection` steer post ideas only; collection,
+     * curation, and engagement analysis remain an unbiased read of the audience.
      *
      * @param query - Natural-language description of the audience. A nonblank
      *   message is required even when reusing a package.

package/dist/index.d.mts

@@ -1138,6 +1138,16 @@ interface ContentIntelligenceOptions {
     postsEnableFiltering?: boolean;
     /** Results requested from each Exa people-search query. The search lane defaults to 100. */
     exaResultsPerQuery?: number;
+    /**
+     * Company the post ideas are for. Used only to tailor post ideas; it does not
+     * affect search, curation, engagement analysis, or grounding of neutral drafts.
+     */
+    companyContext?: string;
+    /**
+     * Requested content style, angle, format, or exclusions. Used only to tailor
+     * post ideas so audience discovery and analysis remain unbiased.
+     */
+    contentDirection?: string;
     /** Re-cook the package stored on this response ID without collecting again. */
     reusePackageFrom?: string;
     /** Outputs to produce. Omit to use the backend's current default set. */
@@ -1148,6 +1158,8 @@ interface ContentIntelligenceResolvedParams {
     postsDateRange: PostsDateRange;
     postsEnableFiltering: boolean;
     exaResultsPerQuery?: number | null;
+    companyContext?: string | null;
+    contentDirection?: string | null;
     reusePackageFrom?: string | null;
     outputs: ContentIntelligenceOutputName[];
 }
@@ -1220,20 +1232,36 @@ interface PostIdea {
         url?: string | null;
         author?: string | null;
     }>;
+    /** Neutral draft, with no company mention. */
     draft: string;
+    /**
+     * The same post rewritten with an honest company tie-in. Null when no
+     * company context was supplied.
+     */
+    draftWithCompany?: string | null;
     probability: number;
     keysExist: number;
     keysCited: number;
     supported: boolean;
     groundingReason: string;
+    /** Independent grounding verdict for `draftWithCompany`. */
+    supportedWithCompany?: boolean;
+    /** Why `draftWithCompany` did or did not pass its two-source grounding check. */
+    groundingReasonWithCompany?: string;
 }
 interface PostIdeasOutput {
     artifact: 'post_ideas';
     n: number;
     ideas: PostIdea[];
     allSupported?: boolean;
+    /** Number of ideas that include a company-tailored draft. */
+    draftsWithCompany?: number;
+    /** Number of company-tailored drafts that passed grounding. */
+    companyDraftsSupported?: number;
     postsSeen?: number;
     chunks?: number;
+    /** Request fields that actually steered the generated post ideas. */
+    steeredBy?: Array<'company_context' | 'content_direction'>;
     note?: string;
 }
 interface ThemeStats {
@@ -2522,14 +2550,24 @@ interface SpecializedAgentParams {
      */
     competitors?: string[];
     /**
-     * Free-text summary of what the seed company does. Anchors competitor
-     * discovery so the ReAct doesn't misclassify ambiguous domains
-     * (e.g. "lumnis.ai" → academic AI vs sales automation).
-     * Used when `company` is provided (discovery mode).
+     * Free-text summary of what a company does.
+     *
+     * For competitor_post_engagement, this describes the seed company and
+     * anchors discovery when `company` is provided. For content_intelligence,
+     * this describes the company the post ideas are for and steers only those
+     * ideas; search, curation, and engagement analysis remain unsteered.
      *
      * @example 'AI-powered outbound automation for B2B sales — books meetings via LinkedIn + email on autopilot'
      */
     companyContext?: string;
+    /**
+     * Desired content type, angle, format, or exclusions for post ideas.
+     * Used only by content_intelligence post-idea generation; it does not steer
+     * search, curation, or engagement analysis.
+     *
+     * @example 'Practitioner how-tos, not hot takes; no hiring posts'
+     */
+    contentDirection?: string;
     /**
      * Optional list of known-good example competitors. The discovery ReAct
      * uses these as anchors and finds more in the same vertical.
@@ -4178,6 +4216,13 @@ interface EmailInboxItem {
     status: string;
     /** inboxkit | unipile | smtp */
     source: string;
+    /**
+     * Connection app code for BYO inboxes: GOOGLE | OUTLOOK | MAIL. Null for
+     * managed (InboxKit) mailboxes, which have no Unipile connection. Prefer this
+     * over guessing from the address domain — a Workspace/365 custom domain is
+     * indistinguishable from a generic IMAP host by domain alone.
+     */
+    provider?: string | null;
     dailySendCap: number;
     sendsToday: number;
     organizationId: string;
@@ -6700,6 +6745,8 @@ declare class ResponsesResource {
      * The backend searches for the audience, collects their reaction history,
      * saves the normalized package, and produces grounded views from it. Pass
      * `reusePackageFrom` to re-cook a saved package without collecting again.
+     * `companyContext` and `contentDirection` steer post ideas only; collection,
+     * curation, and engagement analysis remain an unbiased read of the audience.
      *
      * @param query - Natural-language description of the audience. A nonblank
      *   message is required even when reusing a package.

package/dist/index.d.ts

@@ -1138,6 +1138,16 @@ interface ContentIntelligenceOptions {
     postsEnableFiltering?: boolean;
     /** Results requested from each Exa people-search query. The search lane defaults to 100. */
     exaResultsPerQuery?: number;
+    /**
+     * Company the post ideas are for. Used only to tailor post ideas; it does not
+     * affect search, curation, engagement analysis, or grounding of neutral drafts.
+     */
+    companyContext?: string;
+    /**
+     * Requested content style, angle, format, or exclusions. Used only to tailor
+     * post ideas so audience discovery and analysis remain unbiased.
+     */
+    contentDirection?: string;
     /** Re-cook the package stored on this response ID without collecting again. */
     reusePackageFrom?: string;
     /** Outputs to produce. Omit to use the backend's current default set. */
@@ -1148,6 +1158,8 @@ interface ContentIntelligenceResolvedParams {
     postsDateRange: PostsDateRange;
     postsEnableFiltering: boolean;
     exaResultsPerQuery?: number | null;
+    companyContext?: string | null;
+    contentDirection?: string | null;
     reusePackageFrom?: string | null;
     outputs: ContentIntelligenceOutputName[];
 }
@@ -1220,20 +1232,36 @@ interface PostIdea {
         url?: string | null;
         author?: string | null;
     }>;
+    /** Neutral draft, with no company mention. */
     draft: string;
+    /**
+     * The same post rewritten with an honest company tie-in. Null when no
+     * company context was supplied.
+     */
+    draftWithCompany?: string | null;
     probability: number;
     keysExist: number;
     keysCited: number;
     supported: boolean;
     groundingReason: string;
+    /** Independent grounding verdict for `draftWithCompany`. */
+    supportedWithCompany?: boolean;
+    /** Why `draftWithCompany` did or did not pass its two-source grounding check. */
+    groundingReasonWithCompany?: string;
 }
 interface PostIdeasOutput {
     artifact: 'post_ideas';
     n: number;
     ideas: PostIdea[];
     allSupported?: boolean;
+    /** Number of ideas that include a company-tailored draft. */
+    draftsWithCompany?: number;
+    /** Number of company-tailored drafts that passed grounding. */
+    companyDraftsSupported?: number;
     postsSeen?: number;
     chunks?: number;
+    /** Request fields that actually steered the generated post ideas. */
+    steeredBy?: Array<'company_context' | 'content_direction'>;
     note?: string;
 }
 interface ThemeStats {
@@ -2522,14 +2550,24 @@ interface SpecializedAgentParams {
      */
     competitors?: string[];
     /**
-     * Free-text summary of what the seed company does. Anchors competitor
-     * discovery so the ReAct doesn't misclassify ambiguous domains
-     * (e.g. "lumnis.ai" → academic AI vs sales automation).
-     * Used when `company` is provided (discovery mode).
+     * Free-text summary of what a company does.
+     *
+     * For competitor_post_engagement, this describes the seed company and
+     * anchors discovery when `company` is provided. For content_intelligence,
+     * this describes the company the post ideas are for and steers only those
+     * ideas; search, curation, and engagement analysis remain unsteered.
      *
      * @example 'AI-powered outbound automation for B2B sales — books meetings via LinkedIn + email on autopilot'
      */
     companyContext?: string;
+    /**
+     * Desired content type, angle, format, or exclusions for post ideas.
+     * Used only by content_intelligence post-idea generation; it does not steer
+     * search, curation, or engagement analysis.
+     *
+     * @example 'Practitioner how-tos, not hot takes; no hiring posts'
+     */
+    contentDirection?: string;
     /**
      * Optional list of known-good example competitors. The discovery ReAct
      * uses these as anchors and finds more in the same vertical.
@@ -4178,6 +4216,13 @@ interface EmailInboxItem {
     status: string;
     /** inboxkit | unipile | smtp */
     source: string;
+    /**
+     * Connection app code for BYO inboxes: GOOGLE | OUTLOOK | MAIL. Null for
+     * managed (InboxKit) mailboxes, which have no Unipile connection. Prefer this
+     * over guessing from the address domain — a Workspace/365 custom domain is
+     * indistinguishable from a generic IMAP host by domain alone.
+     */
+    provider?: string | null;
     dailySendCap: number;
     sendsToday: number;
     organizationId: string;
@@ -6700,6 +6745,8 @@ declare class ResponsesResource {
      * The backend searches for the audience, collects their reaction history,
      * saves the normalized package, and produces grounded views from it. Pass
      * `reusePackageFrom` to re-cook a saved package without collecting again.
+     * `companyContext` and `contentDirection` steer post ideas only; collection,
+     * curation, and engagement analysis remain an unbiased read of the audience.
      *
      * @param query - Natural-language description of the audience. A nonblank
      *   message is required even when reusing a package.

package/dist/index.mjs

@@ -3864,6 +3864,8 @@ class ResponsesResource {
    * The backend searches for the audience, collects their reaction history,
    * saves the normalized package, and produces grounded views from it. Pass
    * `reusePackageFrom` to re-cook a saved package without collecting again.
+   * `companyContext` and `contentDirection` steer post ideas only; collection,
+   * curation, and engagement analysis remain an unbiased read of the audience.
    *
    * @param query - Natural-language description of the audience. A nonblank
    *   message is required even when reusing a package.
@@ -3882,6 +3884,10 @@ class ResponsesResource {
       params.postsEnableFiltering = options.postsEnableFiltering;
     if (options.exaResultsPerQuery !== void 0)
       params.exaResultsPerQuery = options.exaResultsPerQuery;
+    if (options.companyContext !== void 0)
+      params.companyContext = options.companyContext;
+    if (options.contentDirection !== void 0)
+      params.contentDirection = options.contentDirection;
     if (options.reusePackageFrom !== void 0)
       params.reusePackageFrom = options.reusePackageFrom;
     if (options.outputs !== void 0)

package/package.json

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