@lpextend/node-sdk 1.1.2 → 1.1.3

package/dist/index.d.ts

@@ -765,6 +765,656 @@ interface LPPromptsQueryParams {
     status?: LPPromptStatus;
 }
 
+/**
+ * Conversation Builder Types
+ *
+ * Types for LivePerson Conversation Builder (CB) and Knowledge AI (KAI) APIs.
+ * Used for managing bots, dialogs, interactions, knowledge bases, and NLU domains.
+ */
+/**
+ * Standard CB API response wrapper
+ */
+interface CBApiResponse<T> {
+    success: boolean;
+    error?: string;
+    errorCode?: string;
+    message?: string;
+    successResult?: T;
+}
+/**
+ * Page context for paginated responses
+ */
+interface CBPageContext {
+    page: number;
+    size: number;
+    totalSize: number;
+}
+/**
+ * Paginated result wrapper
+ */
+interface CBPaginatedResult<T> {
+    pageContext: CBPageContext;
+    data: T[];
+}
+/**
+ * Bot group - logical grouping of bots
+ */
+interface CBBotGroup {
+    botGroupId: string;
+    botGroupName: string;
+    transferMessage: string;
+    channel: 'MESSAGING' | 'CHAT';
+    organizationId: string;
+    collaborationEnabled: boolean;
+    numberOfBots: number;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string | null;
+    createdByName: string | null;
+    updatedBy: string | null;
+    updatedByName: string | null;
+}
+/**
+ * Bot summary from bot-groups API
+ */
+interface CBBot {
+    botId: string;
+    botName: string;
+    botDescription: string | null;
+    botType: 'CUSTOMER_FACING_BOT' | 'POST_SURVEY_BOT' | 'AGENT_FACING_BOT';
+    channel: 'MESSAGING' | 'CHAT';
+    botLanguage: string;
+    agentAnnotationsEnabled: boolean;
+    debuggingEnabled: boolean;
+    botVersion: string;
+    entityDataSourceId: string | null;
+    skills: string[] | null;
+    publicBot: boolean;
+    organizationId: string;
+    botGroupId: string | null;
+    chatBotPlatformUserId: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string | null;
+    createdByName: string | null;
+    updatedBy: string | null;
+    updatedByName: string | null;
+    numberOfDialogs: number;
+    numberOfInteractions: number;
+    numberOfIntegrations: number;
+    numberOfActiveAgents: number;
+    numberOfInactiveAgents: number;
+    numberOfDomains: number;
+    numberOfIntents: number;
+    hasDisambiguation: boolean;
+    hasAutoescalation: boolean;
+    smallTalkEnabled: boolean;
+}
+/**
+ * Bot platform configuration
+ */
+interface CBBotPlatform {
+    id: string;
+    platform: string;
+    botId: string;
+    status: string;
+    integrationType: string;
+}
+/**
+ * Full chatbot details from chatbots API
+ */
+interface CBChatBot {
+    id: string;
+    name: string;
+    description: string | null;
+    personality: string | null;
+    status: string;
+    chatBotPlatformUserId: string;
+    platforms: CBBotPlatform[];
+    getStartedButtonPayload: string;
+    imageURL: string | null;
+    createdBy: string | null;
+    modifiedBy: string | null;
+    creationTime: number;
+    modificationTime: number;
+    entityDataSourceId: string | null;
+    demo: boolean;
+    language: string;
+    enterpriseIntegrations: unknown | null;
+    organizationId: string;
+    autoEscalation: unknown | null;
+    skipNLP: boolean;
+    environmentId: string | null;
+    sessionLength: number;
+    passThroughMode: boolean;
+    transcriptDisabled: boolean;
+    botTemplateId: string | null;
+    version: string;
+    defaultErrorMessage: string | null;
+    sessionExpiredMessage: string | null;
+    thankyouMessage: string | null;
+    shortenUrl: string | null;
+    chatBotType: string;
+    channel: string;
+    startDialog: string | null;
+    publicBot: boolean;
+    skillIds: string[] | null;
+    transferGroupId: string | null;
+    readOnlyBot: boolean;
+    enableDebug: boolean;
+    enableAgentAnnotations: boolean;
+    botAttributes: unknown | null;
+    voiceAttributes: unknown | null;
+    emailTranscriptId: string | null;
+    emailTranscriptSenderEmail: string | null;
+    emailTranscriptSenderName: string | null;
+    emailTranscriptEnabled: boolean | null;
+    thankYouMessageEnabled: boolean | null;
+    externalId: string | null;
+    surveyTargetingParameters: unknown | null;
+    fallbackLimit: number;
+    fallbackLimitMessage: string | null;
+    voiceType: string | null;
+    voiceGender: string | null;
+    voiceToneSetting: string | null;
+    voiceAudioCueSetting: string | null;
+    smallTalkEnabled: boolean;
+    chatBotTypeName: string;
+    voiceSupported: boolean;
+    messagingSupported: boolean;
+}
+/**
+ * Bot metrics
+ */
+interface CBChatBotMetrics {
+    chatBotId: string;
+    totalSubscribers: number;
+    totalMessages: number;
+}
+/**
+ * Bot summary with metrics
+ */
+interface CBChatBotSummary {
+    chatBot: CBChatBot;
+    chatBotMetrics: CBChatBotMetrics;
+}
+/**
+ * List of bot summaries
+ */
+interface CBChatBotSummaryList {
+    chatBotSummaryList: CBChatBotSummary[];
+}
+/**
+ * Dialog definition
+ */
+interface CBDialog {
+    chatBotId: string;
+    id: string;
+    name: string;
+    creationTime: string;
+    modificationTime: string;
+    description: string;
+    dialogType: 'DIALOG' | 'FALLBACK_DIALOG' | 'SURVEY_DIALOG';
+    status: 'ENABLED' | 'DISABLED';
+    disambiguteOnlySelectedDomains: boolean;
+}
+/**
+ * Dialog group container
+ */
+interface CBDialogGroup {
+    Group: CBDialog[];
+}
+/**
+ * Response match condition
+ */
+interface CBResponseMatch {
+    name?: string;
+    conditions: unknown[];
+    contextConditions: unknown[];
+    contextMatchConditionType?: string;
+    action: {
+        name: string;
+        value: string;
+    };
+    contextDataVariables: unknown[];
+}
+/**
+ * Tile data for interaction content
+ */
+interface CBTileData {
+    text?: string;
+    buttons: unknown[];
+    quickReplyList: unknown[];
+    sampleUserInput?: string;
+    escalation?: {
+        tangoContextEnabled: boolean;
+    };
+}
+/**
+ * Interaction content definition
+ */
+interface CBInteractionContent {
+    contentType: 'STATIC' | 'DYNAMIC';
+    results?: {
+        type: string;
+        tile: {
+            tileData: CBTileData[];
+        };
+    };
+    responderName?: string;
+    responderId?: string;
+}
+/**
+ * Interaction definition
+ */
+interface CBInteraction {
+    id: string;
+    chatBotId: string;
+    userInputRequired: boolean;
+    name: string;
+    pattern?: string[];
+    type: string;
+    content: CBInteractionContent;
+    preProcessMessage?: string;
+    postProcessMessage?: string;
+    group: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    required?: boolean;
+    nextMessageId?: string;
+    prevMessageId?: string;
+    responseMatches: CBResponseMatch[];
+    interactionType: string;
+    changeResponse?: {
+        enabled: boolean;
+    };
+    cancelResponse?: {
+        enabled: boolean;
+    };
+    comment?: {
+        content: string;
+        lastCommenterName: string;
+        lastCommenterId: string;
+        lastModifiedDate: number;
+    };
+}
+/**
+ * List of interactions
+ */
+interface CBInteractionList {
+    message: CBInteraction[];
+    pcsSynchronizationWithAcChecked?: boolean;
+}
+/**
+ * Duplicate phrase info
+ */
+interface CBDuplicatePhrase {
+    normalizedPhrase: string;
+    duplicatePhrases: {
+        intentId: string;
+        intentName: string;
+        phrase: string;
+    }[];
+}
+/**
+ * Duplicate phrases container
+ */
+interface CBDuplicatePhrases {
+    duplicates: CBDuplicatePhrase[];
+    domainId: string;
+}
+/**
+ * NLU Domain definition
+ */
+interface CBNLUDomain {
+    id: string;
+    name: string;
+    chatBotPlatformUserId: string;
+    organizationId: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    creationTime: string;
+    modificationTime: string;
+    modifiedBy: string;
+    enableKeyPhraseMatch: boolean;
+    keyPhraseMatchThreshold: number;
+    type: string;
+    intentUploadFileName?: string;
+    entityUploadFileName?: string;
+    duplicatePhrases?: CBDuplicatePhrases;
+    nluShareDataAgree: boolean;
+    migrationNluShareDataAgreeTs: number;
+    acceptMaskedMessages: boolean;
+    language?: string;
+    domainOrigin: 'USER' | 'GLOBAL';
+    verticalType?: string;
+    verticalName?: string;
+    primary: boolean;
+    intentAnalyzerEnabled: boolean;
+    hasLiveIntents: boolean;
+}
+/**
+ * NLU Domain list container
+ */
+interface CBDomainList {
+    DomainList: CBNLUDomain[];
+}
+/**
+ * Intent definition
+ */
+interface CBIntent {
+    id: string;
+    name: string;
+    domainId: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    trainingPhrases?: string[];
+    creationTime?: string;
+    modificationTime?: string;
+}
+/**
+ * Knowledge base landing page metrics
+ */
+interface CBKBLandingPageMetrics {
+    kbId: string;
+    organizationId: string;
+    numOfTotalArticles: number;
+    numOfActiveArticles: number;
+    numOfRedundantArticles?: number;
+    numOfConflictingArticles?: number;
+    numOfArticlesHaveIntents: number;
+    lastContentUpdatedTime: number;
+    connectedBots?: string[];
+    connectedConvAssistSkills?: string[];
+    modifiedTime: number;
+    createdTime: number;
+}
+/**
+ * Sync status details for knowledge base
+ */
+interface CBSyncStatusDetails {
+    syncStatus: 'COMPLETED' | 'IN_PROGRESS' | 'FAILED';
+    syncStatusMessage: string | null;
+    syncTime: number;
+}
+/**
+ * Knowledge base definition
+ */
+interface CBKnowledgeBase {
+    createdByName: string;
+    modifiedByName: string;
+    id: string;
+    name: string;
+    type: 'KnowledgeBase';
+    googleSheetUrl?: string;
+    chatBotPlatformUserId: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    modificationTime?: string;
+    syncStatusDetails?: CBSyncStatusDetails;
+    dataSourceConfiguration: {
+        properties: Record<string, unknown>;
+    };
+    organizationId: string;
+    privateAccess: boolean;
+    language: string;
+    langCode: string;
+    entitiesAvailable: boolean;
+    intentAssociationType?: string;
+    entitiesDataSourceId?: string;
+    publicKB: boolean;
+    createdAt: number;
+    modifiedAt: number;
+    createdBy: string;
+    modifiedBy: string;
+    kbConfigProperties: {
+        enableAssessments?: string;
+        llmEnrichment: string;
+        kms_secret?: string;
+        type?: string;
+    };
+    domainType?: string;
+    kBLandingPageMetrics?: CBKBLandingPageMetrics;
+}
+/**
+ * Knowledge base list container
+ */
+interface CBKnowledgeBaseList {
+    KnowledgeDataSource: CBKnowledgeBase[];
+}
+/**
+ * Knowledge base detail container
+ */
+interface CBKnowledgeBaseDetail {
+    KnowledgeDataSource: CBKnowledgeBase;
+}
+/**
+ * Knowledge base article
+ */
+interface CBKBArticle {
+    id: string;
+    kbId: string;
+    title: string;
+    summary?: string;
+    content?: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    tags?: string[];
+    intents?: string[];
+    createdAt: number;
+    modifiedAt: number;
+    createdBy: string;
+    modifiedBy: string;
+}
+/**
+ * KAI search request
+ */
+interface CBKAISearchRequest {
+    llmConfig?: {
+        promptId?: string;
+        promptName?: string;
+        llmEnrichment?: boolean;
+        promptTemplate?: string;
+    };
+    numberOfAnswers?: number;
+    mode?: string;
+    confidenceLevel?: string;
+    status?: string;
+    consumerQuery: string;
+    isPreview?: boolean;
+    kaiClient?: string;
+}
+/**
+ * KAI search result item
+ */
+interface CBKAISearchResultItem {
+    articleId: string;
+    title: string;
+    content: string;
+    score: number;
+    summary?: string;
+}
+/**
+ * KAI search response
+ */
+interface CBKAISearchResponse {
+    results: CBKAISearchResultItem[];
+    generatedAnswer?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * KAI On-Demand configuration
+ */
+interface CBKAIOnDemandConfig {
+    id: string;
+    name: string;
+    kbId: string;
+    enabled: boolean;
+    settings: Record<string, unknown>;
+}
+/**
+ * Bot user (agent connector)
+ */
+interface CBBotUser {
+    lpUserId: string;
+    lpAccountId: string;
+    lpAccountUser: string;
+    botId: string;
+    chatBotId: string;
+    deploymentEnvironment: 'PRODUCTION' | 'STAGING';
+    type: 'messaging' | 'chat';
+    configurations: {
+        lpUserRole: string;
+        enableAccessibility: boolean;
+        tileDisplay: string;
+    };
+}
+/**
+ * Bot instance status
+ */
+interface CBBotInstanceStatus {
+    botId: string;
+    status: 'RUNNING' | 'STOPPED' | 'ERROR';
+    lpAccountId: string;
+    lpAccountUser: string;
+}
+/**
+ * Add bot agent request
+ */
+interface CBAddBotAgentRequest {
+    lpAccountId: string;
+    lpAccountUser: string;
+    lpUserId: string;
+    botId: string;
+    deploymentEnvironment: 'PRODUCTION' | 'STAGING';
+    type: 'messaging' | 'chat';
+    configurations: {
+        lpUserRole: string;
+        enableAccessibility: boolean;
+        tileDisplay: string;
+    };
+}
+/**
+ * Responder (API integration)
+ */
+interface CBResponder {
+    id: string;
+    chatBotId: string;
+    name: string;
+    type: string;
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    responseMapping?: Record<string, string>;
+}
+/**
+ * Global functions code
+ */
+interface CBGlobalFunctions {
+    chatBotId: string;
+    code: string;
+    lastModified: number;
+    lastModifiedBy: string;
+}
+/**
+ * Bot environment configuration
+ */
+interface CBBotEnvironment {
+    id: string;
+    name: string;
+    description: string;
+    variables: Record<string, string>;
+}
+/**
+ * LivePerson app credentials for bot
+ */
+interface CBLPAppCredentials {
+    chatBotId: string;
+    appKey: string;
+    appSecret: string;
+    accessToken: string;
+    accessTokenSecret: string;
+}
+/**
+ * LP Skill from CB external integrations API
+ */
+interface CBLPSkill {
+    id: number;
+    name: string;
+    description: string;
+    maxWaitTime: number;
+    defaultTimeToHold: number;
+}
+/**
+ * Knowledge base content source
+ */
+interface CBKBContentSource {
+    id: string;
+    kbId: string;
+    name: string;
+    type: string;
+    status: 'ACTIVE' | 'INACTIVE';
+    url?: string;
+    lastSyncTime?: number;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Dialog template summary
+ */
+interface CBDialogTemplateSummary {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    preview?: string;
+}
+/**
+ * CB credential entry
+ */
+interface CBCredential {
+    id: string;
+    name: string;
+    type: string;
+    organizationId: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Bot groups query parameters
+ */
+interface CBBotGroupsQueryParams {
+    page?: number;
+    size?: number;
+    expandAll?: boolean;
+}
+/**
+ * Bots by group query parameters
+ */
+interface CBBotsByGroupQueryParams {
+    botGroupId?: string;
+    sortBy?: string;
+    page?: number;
+    size?: number;
+}
+/**
+ * KB articles query parameters
+ */
+interface CBKBArticlesQueryParams {
+    page?: number;
+    size?: number;
+    sortAscByLastModificationTime?: boolean;
+    articleIds?: string[];
+    includeConflictingDetails?: boolean;
+}
+/**
+ * All bot agents status query parameters
+ */
+interface CBAllBotAgentsStatusQueryParams {
+    environment?: 'PRODUCTION' | 'STAGING';
+}
+/**
+ * PCS bots status query parameters
+ */
+interface CBPCSBotsStatusQueryParams {
+    showBotsData?: boolean;
+}
+
 /**
  * AI Studio Types
  *
@@ -1436,11 +2086,20 @@ interface LPExtendSDKConfig {
      * LP Access token (obtained from shell auth)
      * This is the user's LP bearer token passed to the child app.
      *
-     * Either provide this directly OR provide extendToken OR provide shellToken.
+     * Either provide this directly OR provide extendToken OR provide shellToken OR provide apiKey.
      */
     accessToken?: string;
     /**
-     * ExtendJWT token (NEW - preferred method)
+     * LP Extend API Key (RECOMMENDED for backend apps)
+     * Your app's API key from LP Extend shell registration.
+     * SDK will authenticate with shell and get LP access token.
+     *
+     * Set via environment variable: LPEXTEND_API_KEY
+     * @example 'lpx_my-app_abc123...'
+     */
+    apiKey?: string;
+    /**
+     * ExtendJWT token (for iframe apps receiving token from shell)
      * Encrypted JWT from shell containing all auth data.
      * SDK will verify with shell and get LP access token.
      *
@@ -1453,13 +2112,13 @@ interface LPExtendSDKConfig {
      * fetch the LP access token from the shell during initialization.
      *
      * @example Received via URL params: ?shellToken=xxx
-     * @deprecated Use extendToken instead
+     * @deprecated Use apiKey for backend apps or extendToken for iframe apps
      */
     shellToken?: string;
     /**
      * Shell backend base URL
-     * Required when using extendToken or shellToken for automatic token retrieval.
-     * @default Derived from window.location.origin or parent frame
+     * Required when using apiKey, extendToken, or shellToken for automatic token retrieval.
+     * @default Derived from window.location.origin, parent frame, or LPEXTEND_SHELL_URL env var
      * @example 'https://lp-extend.example.com'
      */
     shellBaseUrl?: string;
@@ -1626,6 +2285,32 @@ interface ShellTokenResponse {
      */
     cbOrg?: string;
 }
+/**
+ * Response from API key authentication
+ * Child apps call shell's /api/v1/apps/auth endpoint with API key
+ */
+interface ApiKeyAuthResponse {
+    /** Authentication success */
+    authenticated: boolean;
+    /** LP Bearer access token for API calls */
+    lpAccessToken: string;
+    /** LP User ID */
+    lpUserId: string;
+    /** LP Account ID */
+    lpAccountId: string;
+    /** Is LPA user */
+    isLPA: boolean;
+    /** APIs this app has access to */
+    allowedApis: string[];
+    /** App name from registration */
+    appName: string;
+    /** Conversation Builder token */
+    cbToken?: string;
+    /** Conversation Builder org */
+    cbOrg?: string;
+    /** Token expiration timestamp (Unix ms) */
+    expiresAt: number;
+}
 
 /**
  * HTTP Client
@@ -2618,6 +3303,279 @@ declare class LPPromptsAPI {
     getLLMProviders(): Promise<APIResponse<LPLLMProviderSubscription[]>>;
 }
 
+/**
+ * Conversation Builder API Module
+ *
+ * Provides access to LivePerson's Conversation Builder (CB) and Knowledge AI (KAI) APIs.
+ * Manages bots, dialogs, interactions, knowledge bases, and NLU domains.
+ *
+ * CB APIs use a separate authentication mechanism (cbToken + organizationId) obtained
+ * via sentinel.authenticateCB() or from ExtendJWT verification.
+ */
+
+/**
+ * CB Authentication credentials
+ */
+interface CBAuthCredentials {
+    /** CB API access token */
+    cbToken: string;
+    /** CB organization ID */
+    organizationId: string;
+}
+/**
+ * Conversation Builder API
+ *
+ * Provides methods for interacting with CB/KAI APIs.
+ * Requires CB authentication credentials (cbToken + organizationId).
+ *
+ * @example
+ * ```typescript
+ * // Get CB credentials from sentinel or ExtendJWT verification
+ * const cbAuth = await sdk.sentinel.authenticateCB();
+ * const cbCreds = {
+ *   cbToken: cbAuth.successResult.apiAccessToken,
+ *   organizationId: cbAuth.successResult.sessionOrganizationId,
+ * };
+ *
+ * // Initialize CB API with credentials
+ * sdk.conversationBuilder.setCredentials(cbCreds);
+ *
+ * // Now use CB APIs
+ * const bots = await sdk.conversationBuilder.getBots();
+ * const kbs = await sdk.conversationBuilder.knowledgeBases.getAll();
+ * ```
+ */
+declare class ConversationBuilderAPI {
+    private readonly accountId;
+    private domainResolver;
+    private credentials;
+    private debug;
+    private timeout;
+    /** Bot Groups API */
+    readonly botGroups: BotGroupsAPI;
+    /** Bots API */
+    readonly bots: BotsAPI;
+    /** Dialogs API */
+    readonly dialogs: DialogsAPI;
+    /** Interactions API */
+    readonly interactions: InteractionsAPI;
+    /** NLU Domains API */
+    readonly nluDomains: NLUDomainsAPI;
+    /** Knowledge Bases API (KAI) */
+    readonly knowledgeBases: KnowledgeBasesAPI;
+    /** Bot Agents API */
+    readonly botAgents: BotAgentsAPI;
+    /** Integrations/Responders API */
+    readonly integrations: IntegrationsAPI;
+    constructor(accountId: string, debug?: boolean, timeout?: number);
+    /**
+     * Set CB authentication credentials
+     * Must be called before making any CB API calls
+     */
+    setCredentials(credentials: CBAuthCredentials): void;
+    /**
+     * Check if credentials are set
+     */
+    hasCredentials(): boolean;
+    /**
+     * Get the current credentials
+     * @throws If credentials not set
+     */
+    getCredentials(): CBAuthCredentials;
+    /**
+     * Get the account ID
+     */
+    getAccountId(): string;
+    /**
+     * Get domain for a CB service
+     */
+    getDomain(service: string): Promise<string>;
+    /**
+     * Make authenticated request to CB API
+     */
+    request<T>(service: string, path: string, options?: {
+        method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+        body?: unknown;
+        params?: Record<string, string | number | boolean | undefined>;
+    }): Promise<T>;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+/**
+ * Bot Groups API
+ */
+declare class BotGroupsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all bot groups
+     */
+    getAll(params?: CBBotGroupsQueryParams): Promise<CBPaginatedResult<CBBotGroup> | CBBotGroup[]>;
+    /**
+     * Get bots by group
+     */
+    getBots(params?: CBBotsByGroupQueryParams): Promise<CBPaginatedResult<CBBot>>;
+}
+/**
+ * Bots API
+ */
+declare class BotsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all bots (legacy chatbots endpoint)
+     */
+    getAll(): Promise<CBChatBotSummaryList>;
+    /**
+     * Get chatbot by ID
+     */
+    getById(chatBotId: string): Promise<CBChatBot>;
+    /**
+     * Get global functions for a bot
+     */
+    getGlobalFunctions(botId: string): Promise<CBGlobalFunctions>;
+    /**
+     * Get LP app credentials for a bot
+     */
+    getLPAppCredentials(chatBotId: string): Promise<CBLPAppCredentials>;
+    /**
+     * Get bot environment variables
+     */
+    getEnvironment(): Promise<CBApiResponse<CBBotEnvironment[]>>;
+}
+/**
+ * Dialogs API
+ */
+declare class DialogsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all dialogs for a bot
+     */
+    getByBotId(botId: string): Promise<CBDialogGroup>;
+    /**
+     * Get dialog template summaries
+     */
+    getTemplateSummary(): Promise<CBDialogTemplateSummary[]>;
+}
+/**
+ * Interactions API
+ */
+declare class InteractionsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all interactions for a bot
+     */
+    getByBotId(botId: string): Promise<CBInteractionList>;
+}
+/**
+ * NLU Domains API
+ */
+declare class NLUDomainsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all NLU domains for the organization
+     */
+    getAll(): Promise<CBDomainList>;
+    /**
+     * Get intents for a domain
+     */
+    getIntents(domainId: string): Promise<CBApiResponse<CBIntent[]>>;
+}
+/**
+ * Knowledge Bases API (KAI)
+ */
+declare class KnowledgeBasesAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get all knowledge bases
+     */
+    getAll(includeMetrics?: boolean): Promise<CBKnowledgeBaseList>;
+    /**
+     * Get knowledge base by ID
+     */
+    getById(kbId: string, includeMetrics?: boolean): Promise<CBKnowledgeBaseDetail>;
+    /**
+     * Get content sources for a knowledge base
+     */
+    getContentSources(kbId: string, includeKmsRecipeDetails?: boolean): Promise<CBKBContentSource[]>;
+    /**
+     * Get articles for a knowledge base
+     */
+    getArticles(kbId: string, params?: CBKBArticlesQueryParams): Promise<CBPaginatedResult<CBKBArticle>>;
+    /**
+     * Search knowledge base using KAI
+     */
+    search(kbId: string, searchRequest: CBKAISearchRequest): Promise<CBKAISearchResponse>;
+    /**
+     * Get KAI On-Demand configurations
+     */
+    getOnDemandConfigs(): Promise<CBKAIOnDemandConfig[]>;
+    /**
+     * Get default prompt for KAI
+     */
+    getDefaultPrompt(): Promise<unknown>;
+}
+/**
+ * Bot Agents API
+ */
+declare class BotAgentsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get bot instance status
+     */
+    getInstanceStatus(botId: string): Promise<CBBotInstanceStatus>;
+    /**
+     * Start a bot agent
+     */
+    start(botId: string, lpAccountId: string, lpAccountUser: string): Promise<unknown>;
+    /**
+     * Stop a bot agent
+     */
+    stop(botId: string, lpAccountId: string, lpAccountUser: string): Promise<unknown>;
+    /**
+     * Get all bot agents status
+     */
+    getAllStatus(params?: CBAllBotAgentsStatusQueryParams): Promise<unknown>;
+    /**
+     * Get PCS bots status
+     */
+    getPCSStatus(params?: CBPCSBotsStatusQueryParams): Promise<unknown>;
+    /**
+     * Get bot users
+     */
+    getBotUsers(): Promise<CBBotUser[]>;
+    /**
+     * Add a bot agent
+     */
+    addAgent(lpUserId: string, chatBotId: string, request: CBAddBotAgentRequest): Promise<CBBotUser>;
+}
+/**
+ * Integrations/Responders API
+ */
+declare class IntegrationsAPI {
+    private readonly cb;
+    constructor(cb: ConversationBuilderAPI);
+    /**
+     * Get responders for a chatbot
+     */
+    getResponders(chatBotId: string): Promise<CBResponder[]>;
+    /**
+     * Get LP skills
+     */
+    getLPSkills(): Promise<CBLPSkill[]>;
+    /**
+     * Get credentials
+     */
+    getCredentials(): Promise<CBCredential[]>;
+}
+
 /**
  * LP Extend Client SDK
  *
@@ -2717,6 +3675,22 @@ declare class LPExtendSDK {
     readonly sentinel: SentinelAPI;
     /** LP Prompts API - Manage prompts from LivePerson Prompt Library */
     readonly prompts: LPPromptsAPI;
+    /**
+     * Conversation Builder API - Manage bots, dialogs, knowledge bases, NLU
+     *
+     * NOTE: CB APIs require separate authentication. After SDK init, call:
+     * ```typescript
+     * const cbAuth = await sdk.sentinel.authenticateCB();
+     * sdk.conversationBuilder.setCredentials({
+     *   cbToken: cbAuth.successResult.apiAccessToken,
+     *   organizationId: cbAuth.successResult.sessionOrganizationId,
+     * });
+     * ```
+     *
+     * Or if using ExtendJWT (v2 auth), credentials may be set automatically
+     * from the verification response.
+     */
+    readonly conversationBuilder: ConversationBuilderAPI;
     /** Scopes granted by app registration */
     readonly grantedScopes: string[];
     /** App name from registration */
@@ -2758,10 +3732,11 @@ declare class LPExtendSDK {
  * This calls the shell backend to verify app registration and get granted scopes,
  * then creates an SDK that calls LP APIs directly.
  *
- * Supports three authentication modes (in order of preference):
- * 1. ExtendJWT token (NEW): Provide `extendToken` - SDK verifies with shell and gets LP token
- * 2. Direct access token: Provide `accessToken` directly
- * 3. Shell token (LEGACY): Provide `shellToken` to fetch the LP token from the shell
+ * Supports four authentication modes (in order of preference):
+ * 1. API Key (RECOMMENDED for backend apps): Provide `apiKey` - SDK authenticates with shell
+ * 2. ExtendJWT token (for iframe apps): Provide `extendToken` - SDK verifies with shell and gets LP token
+ * 3. Direct access token: Provide `accessToken` directly
+ * 4. Shell token (LEGACY): Provide `shellToken` to fetch the LP token from the shell
  */
 declare function createSDK(config: LPExtendSDKConfig): Promise<LPExtendSDK>;
 
@@ -2892,6 +3867,44 @@ declare function createSDK(config: LPExtendSDKConfig): Promise<LPExtendSDK>;
  * ```
  */
 declare function initializeSDK(config: LPExtendSDKConfig): Promise<LPExtendSDK>;
+/**
+ * Initialize the SDK using environment variables + ExtendJWT
+ *
+ * Reads configuration from environment variables:
+ * - LPEXTEND_API_KEY: Your app's API key (required)
+ * - APP_ID: Your registered app ID (required)
+ * - LP_ACCOUNT_ID: LivePerson account ID (required)
+ * - LPEXTEND_SHELL_URL: Shell base URL (required)
+ * - LPEXTEND_DEBUG: Enable debug logging (optional, default: false)
+ *
+ * The ExtendJWT is passed as a parameter since it comes from the shell at runtime.
+ *
+ * @param extendToken - The ExtendJWT received from the shell
+ * @returns Promise resolving to initialized SDK instance
+ * @throws LPExtendSDKError if required env vars are missing
+ *
+ * @example
+ * ```typescript
+ * // In your .env file:
+ * // LPEXTEND_API_KEY=lpx_my-app_abc123...
+ * // APP_ID=my-app
+ * // LP_ACCOUNT_ID=12345678
+ * // LPEXTEND_SHELL_URL=https://lp-extend.example.com
+ *
+ * import { createSDKFromEnv } from '@lpextend/node-sdk';
+ *
+ * // In your API route handler:
+ * app.get('/api/skills', async (req, res) => {
+ *   // Get ExtendJWT from request (sent by frontend)
+ *   const extendToken = req.headers['x-extend-token'] as string;
+ *
+ *   const sdk = await createSDKFromEnv(extendToken);
+ *   const { data: skills } = await sdk.skills.getAll();
+ *   res.json(skills);
+ * });
+ * ```
+ */
+declare function createSDKFromEnv(extendToken: string): Promise<LPExtendSDK>;
 /**
  * SDK Version
  */
@@ -2986,4 +3999,4 @@ type Scope = (typeof Scopes)[keyof typeof Scopes];
  */
 declare function getShellToken(config: ShellTokenConfig): Promise<ShellTokenResponse>;
 
-export { type CreateConversationRequest$1 as AICreateConversationRequest, AIStudioAPI, type AIStudioCategory, type AIStudioConversation, type AIStudioFlow, type AIStudioMessage, type AIStudioSimulation, type AIStudioSummary, type AIStudioUser, AIStudioUsersAPI, type UpdateConversationRequest as AIUpdateConversationRequest, type APIResponse, type ActivityRecord, type AgentActivity, AgentActivityAPI, type AgentActivityQuery, AgentGroupsAPI, type AgentMetrics, AgentMetricsAPI, type AgentMetricsQuery, type AgentParticipant, type AgentStatus, AutomaticMessagesAPI, type BatchSummaryRequest, type CBAuthInfo, type CBChatBotPlatformUser, type CBSuccessResult, CampaignsAPI, CategoriesAPI, type CloseConversationRequest, type CoBrowseSession, ConnectToMessagingAPI, type ConsumerParticipant, type ConsumerProfile, type ContentToRetrieve, type ConversationContext, type ConversationInteraction, type ConversationParticipant, type ConversationQueryParams, type ConversationSummary, type ConversationTransfer, ConversationsAPI, type CreateAIStudioUserRequest, type CreateAgentGroupRequest, type CreateAutomaticMessageRequest, type CreateCampaignRequest, type CreateCategoryRequest, type CreateConversationResponse, type CreateEngagementRequest, type CreateLOBRequest, type CreateLPPromptRequest, type CreatePredefinedContentRequest, type CreateProfileRequest, type CreatePromptRequest, type CreateSimulationRequest, type CreateSkillRequest, type CreateSpecialOccasionRequest, type CreateTranscriptAnalysisRequest, type CreateUserRequest, type CreateWorkingHoursRequest, EngagementsAPI, type ErrorCode, ErrorCodes, EvaluatorsAPI, type FileMessage, FlowsAPI, type GeneratedQuestion, type GeneratedRoute, GeneratorsAPI, type GuidedRoute, type GuidedRoutingEvaluationRequest, type GuidedRoutingEvaluationResponse, type InvokeFlowRequest, type InvokeFlowResponse, type KAIRouteGenerationStatus, type KAIRouteGeneratorRequest, type KAIRouteGeneratorResponse, type Knowledgebase, type KnowledgebaseHealth, type KnowledgebaseItem, type KnowledgebaseSearchRequest, type KnowledgebaseSearchResult, type KnowledgebaseTextItem, KnowledgebasesAPI, type LLMModel, type LLMProvider, LOBsAPI, type LPAgentGroup, type LPAutomaticMessage, type LPAutomaticMessageData, type LPCampaign, type LPEngagement, LPExtendSDK, type LPExtendSDKConfig, LPExtendSDKError, type LPLLMProviderModels, type LPLLMProviderSubscription, type LPLLMType, type LPLOB, type LPPermission, type LPPredefinedContent, type LPPredefinedContentData, type LPProfile, type LPPrompt, type LPPromptClientConfig, type LPPromptClientType, type LPPromptConfiguration, type LPPromptGenericConfig, type LPPromptStatus, type LPPromptVariable, type LPPromptVariableSourceType, type LPPromptVersionDetail, LPPromptsAPI, type LPPromptsQueryParams, type LPShift, type LPSkill, type LPSkillRoutingConfig, type LPSpecialOccasion, type LPSpecialOccasionEvent, type LPUser, type LPWorkingDay, type LPWorkingHours, type MemberOf, type MessageData, type MessageRecord, MessagingAPI, type MessagingConversation, type CreateConversationRequest as MessagingCreateConversationRequest, MessagingHistoryAPI, type MessagingHistoryQuery, type MessagingHistoryResponse, type MessagingInteraction, MessagingOperationsAPI, type OutboundCampaignReport, type OutboundReportQuery, OutboundReportingAPI, type PaginatedResponse, PredefinedContentAPI, ProfilesAPI, type Prompt, PromptLibraryAPI, type PromptVariable, QueryAPI, type QueryGenerateRequest, type QueryGenerateResponse, type QuestionGeneratorRequest, type QuestionGeneratorResponse, type ResolutionEvaluationRequest, type ResolutionEvaluationResponse, type RichContentMessage, type SDEEvent, type SDERecord, type SDKInitResult, type Scope, Scopes, type SendMessageRequest, SentinelAPI, type SentinelAppSetting, type SentinelAppSettings, type SentinelAppUser, type SentinelAuthRequest, type SentinelCCUser, type SentinelDomainsResponse, type SentinelLoginUrlResponse, type SentinelLpToken, type SentinelLpUser, type SentinelManagerOf, type SentinelMemberOf, type SentinelProfile, type SentinelToken, type SentinelTokenExchange, type SentinelUserData, type SentinelUserSkill, type ShellTokenConfig, type ShellTokenResponse, type ShellTokenUser, type SimilarityEvaluationRequest, type SimilarityEvaluationResponse, type SimulationConfig, type SimulationJobResult, type SimulationQueryParams, type SimulationResults, type SimulationTestCase, SimulationsAPI, SkillsAPI, SpecialOccasionsAPI, SummaryAPI, type SummaryRequest, type SurveyRecord, type TextMessage, type TranscriptAnalysis, TranscriptAnalysisAPI, type TranscriptConversation, type TranscriptQuestion, type TransferConversationRequest, type UpdateAIStudioUserModelsRequest, type UpdateAIStudioUserRequest, type UpdateAgentGroupRequest, type UpdateAutomaticMessageRequest, type UpdateCampaignRequest, type UpdateCategoryRequest, type UpdateConversationAttributesRequest, type UpdateEngagementRequest, type UpdateLOBRequest, type UpdateLPPromptRequest, type UpdatePredefinedContentRequest, type UpdateProfileRequest, type UpdatePromptRequest, type UpdateSimulationRequest, type UpdateSkillRequest, type UpdateSpecialOccasionRequest, type UpdateTranscriptAnalysisRequest, type UpdateUserRequest, type UpdateWorkingHoursRequest, UsersAPI, VERSION, WorkingHoursAPI, createSDK, getShellToken, initializeSDK };
+export { type CreateConversationRequest$1 as AICreateConversationRequest, AIStudioAPI, type AIStudioCategory, type AIStudioConversation, type AIStudioFlow, type AIStudioMessage, type AIStudioSimulation, type AIStudioSummary, type AIStudioUser, AIStudioUsersAPI, type UpdateConversationRequest as AIUpdateConversationRequest, type APIResponse, type ActivityRecord, type AgentActivity, AgentActivityAPI, type AgentActivityQuery, AgentGroupsAPI, type AgentMetrics, AgentMetricsAPI, type AgentMetricsQuery, type AgentParticipant, type AgentStatus, type ApiKeyAuthResponse, AutomaticMessagesAPI, type BatchSummaryRequest, BotAgentsAPI, BotGroupsAPI, BotsAPI, type CBAddBotAgentRequest, type CBAllBotAgentsStatusQueryParams, type CBApiResponse, type CBAuthCredentials, type CBAuthInfo, type CBBot, type CBBotEnvironment, type CBBotGroup, type CBBotGroupsQueryParams, type CBBotInstanceStatus, type CBBotPlatform, type CBBotUser, type CBBotsByGroupQueryParams, type CBChatBot, type CBChatBotMetrics, type CBChatBotPlatformUser, type CBChatBotSummary, type CBChatBotSummaryList, type CBCredential, type CBDialog, type CBDialogGroup, type CBDialogTemplateSummary, type CBDomainList, type CBDuplicatePhrase, type CBDuplicatePhrases, type CBGlobalFunctions, type CBIntent, type CBInteraction, type CBInteractionContent, type CBInteractionList, type CBKAIOnDemandConfig, type CBKAISearchRequest, type CBKAISearchResponse, type CBKAISearchResultItem, type CBKBArticle, type CBKBArticlesQueryParams, type CBKBContentSource, type CBKBLandingPageMetrics, type CBKnowledgeBase, type CBKnowledgeBaseDetail, type CBKnowledgeBaseList, type CBLPAppCredentials, type CBLPSkill, type CBNLUDomain, type CBPCSBotsStatusQueryParams, type CBPageContext, type CBPaginatedResult, type CBResponder, type CBResponseMatch, type CBSuccessResult, type CBSyncStatusDetails, type CBTileData, CampaignsAPI, CategoriesAPI, type CloseConversationRequest, type CoBrowseSession, ConnectToMessagingAPI, type ConsumerParticipant, type ConsumerProfile, type ContentToRetrieve, ConversationBuilderAPI, type ConversationContext, type ConversationInteraction, type ConversationParticipant, type ConversationQueryParams, type ConversationSummary, type ConversationTransfer, ConversationsAPI, type CreateAIStudioUserRequest, type CreateAgentGroupRequest, type CreateAutomaticMessageRequest, type CreateCampaignRequest, type CreateCategoryRequest, type CreateConversationResponse, type CreateEngagementRequest, type CreateLOBRequest, type CreateLPPromptRequest, type CreatePredefinedContentRequest, type CreateProfileRequest, type CreatePromptRequest, type CreateSimulationRequest, type CreateSkillRequest, type CreateSpecialOccasionRequest, type CreateTranscriptAnalysisRequest, type CreateUserRequest, type CreateWorkingHoursRequest, DialogsAPI, EngagementsAPI, type ErrorCode, ErrorCodes, EvaluatorsAPI, type FileMessage, FlowsAPI, type GeneratedQuestion, type GeneratedRoute, GeneratorsAPI, type GuidedRoute, type GuidedRoutingEvaluationRequest, type GuidedRoutingEvaluationResponse, IntegrationsAPI, InteractionsAPI, type InvokeFlowRequest, type InvokeFlowResponse, type KAIRouteGenerationStatus, type KAIRouteGeneratorRequest, type KAIRouteGeneratorResponse, KnowledgeBasesAPI, type Knowledgebase, type KnowledgebaseHealth, type KnowledgebaseItem, type KnowledgebaseSearchRequest, type KnowledgebaseSearchResult, type KnowledgebaseTextItem, KnowledgebasesAPI, type LLMModel, type LLMProvider, LOBsAPI, type LPAgentGroup, type LPAutomaticMessage, type LPAutomaticMessageData, type LPCampaign, type LPEngagement, LPExtendSDK, type LPExtendSDKConfig, LPExtendSDKError, type LPLLMProviderModels, type LPLLMProviderSubscription, type LPLLMType, type LPLOB, type LPPermission, type LPPredefinedContent, type LPPredefinedContentData, type LPProfile, type LPPrompt, type LPPromptClientConfig, type LPPromptClientType, type LPPromptConfiguration, type LPPromptGenericConfig, type LPPromptStatus, type LPPromptVariable, type LPPromptVariableSourceType, type LPPromptVersionDetail, LPPromptsAPI, type LPPromptsQueryParams, type LPShift, type LPSkill, type LPSkillRoutingConfig, type LPSpecialOccasion, type LPSpecialOccasionEvent, type LPUser, type LPWorkingDay, type LPWorkingHours, type MemberOf, type MessageData, type MessageRecord, MessagingAPI, type MessagingConversation, type CreateConversationRequest as MessagingCreateConversationRequest, MessagingHistoryAPI, type MessagingHistoryQuery, type MessagingHistoryResponse, type MessagingInteraction, MessagingOperationsAPI, NLUDomainsAPI, type OutboundCampaignReport, type OutboundReportQuery, OutboundReportingAPI, type PaginatedResponse, PredefinedContentAPI, ProfilesAPI, type Prompt, PromptLibraryAPI, type PromptVariable, QueryAPI, type QueryGenerateRequest, type QueryGenerateResponse, type QuestionGeneratorRequest, type QuestionGeneratorResponse, type ResolutionEvaluationRequest, type ResolutionEvaluationResponse, type RichContentMessage, type SDEEvent, type SDERecord, type SDKInitResult, type Scope, Scopes, type SendMessageRequest, SentinelAPI, type SentinelAppSetting, type SentinelAppSettings, type SentinelAppUser, type SentinelAuthRequest, type SentinelCCUser, type SentinelDomainsResponse, type SentinelLoginUrlResponse, type SentinelLpToken, type SentinelLpUser, type SentinelManagerOf, type SentinelMemberOf, type SentinelProfile, type SentinelToken, type SentinelTokenExchange, type SentinelUserData, type SentinelUserSkill, type ShellTokenConfig, type ShellTokenResponse, type ShellTokenUser, type SimilarityEvaluationRequest, type SimilarityEvaluationResponse, type SimulationConfig, type SimulationJobResult, type SimulationQueryParams, type SimulationResults, type SimulationTestCase, SimulationsAPI, SkillsAPI, SpecialOccasionsAPI, SummaryAPI, type SummaryRequest, type SurveyRecord, type TextMessage, type TranscriptAnalysis, TranscriptAnalysisAPI, type TranscriptConversation, type TranscriptQuestion, type TransferConversationRequest, type UpdateAIStudioUserModelsRequest, type UpdateAIStudioUserRequest, type UpdateAgentGroupRequest, type UpdateAutomaticMessageRequest, type UpdateCampaignRequest, type UpdateCategoryRequest, type UpdateConversationAttributesRequest, type UpdateEngagementRequest, type UpdateLOBRequest, type UpdateLPPromptRequest, type UpdatePredefinedContentRequest, type UpdateProfileRequest, type UpdatePromptRequest, type UpdateSimulationRequest, type UpdateSkillRequest, type UpdateSpecialOccasionRequest, type UpdateTranscriptAnalysisRequest, type UpdateUserRequest, type UpdateWorkingHoursRequest, UsersAPI, VERSION, WorkingHoursAPI, createSDK, createSDKFromEnv, getShellToken, initializeSDK };