portal-aiatende-api 0.1.9 → 0.2.0

package/README.md

@@ -20,9 +20,9 @@ const portal = new PortalClient({
 const client = await portal.clients.getByKommoSubdomain('meusubdominio');
 const client2 = await portal.clients.getByWazzupChannelId('channel-id');
 
-const context = await portal.knowledge.getInternalContext({
-  clientId: client!.id,
-  userQuery: embeddingVector, // number[]
+const chunks = await portal.knowledge.getInternalContext({
+  aiConfigId: client!.aiConfig.id,
+  question: 'Qual o horário de funcionamento?',
 });
 ```
 

package/dist/index.d.mts

@@ -96,6 +96,8 @@ interface AiConfig {
     handoffAiState?: 'inactive' | 'untag';
     /** Ativa a Reflection Agent (segunda passada de revisão/auditoria da resposta) pra este cliente. Ausente/undefined = usa o fallback global (env USE_REFLECTION_AGENT) no atende360-assistant — ver Orchestrator.ts. */
     reflectionAgentEnabled?: boolean;
+    /** Limiar mínimo de similaridade (cosine, 0-1) pra um trecho da base de conhecimento entrar no contexto do RAG. `undefined`/`null` = o Portal usa o fallback global 0.5 até o admin calibrar via RAG eval. Aplicado internamente pelo Portal em `POST /api/knowledge/internal/context` — não precisa ser enviado pelo assistant-api. */
+    ragThreshold?: number | null;
     [key: string]: any;
 }
 interface AiExperimentCriteria {
@@ -166,6 +168,12 @@ interface LossReasonMapping {
      * de 1 item automaticamente — sem migração necessária.
      */
     ai_move_conditions?: string[];
+    /**
+     * Nota livre do admin explicando o que este motivo de perda realmente representa, quando o
+     * nome sozinho não deixa claro. Usada só como grounding pra geração de condições por IA no
+     * portal — não é lida pelo assistant-api (não afeta a decisão de movimentação em si).
+     */
+    ai_context_note?: string;
 }
 interface StageMapping {
     stage_id: number;
@@ -191,6 +199,14 @@ interface StageMapping {
      * "só anda pra frente".
      */
     ai_allow_regression?: boolean;
+    /**
+     * Nota livre do admin explicando o que esta etapa realmente representa, pra quando o nome
+     * de exibição no Kommo é só visual/interno pro cliente e não descreve a função real da
+     * etapa (ex.: nome genérico "Fase 2" que na prática significa "lead já pagou o sinal mas
+     * ainda não agendou a instalação"). Usada só como grounding pra geração de condições por
+     * IA no portal — não é lida pelo assistant-api (não afeta a decisão de movimentação em si).
+     */
+    ai_context_note?: string;
     loss_reasons?: LossReasonMapping[];
 }
 interface PipelineMapping {
@@ -273,17 +289,24 @@ declare class ClientsResource extends BaseResource {
 }
 
 interface GetInternalContextParams {
-    clientId: number | string;
-    /** Embedding da mensagem do usuário (vetor numérico). */
-    userQuery: number[];
+    /** Id do AiConfig do cliente — o Portal usa a `apiKey` configurada nele pra gerar o embedding da pergunta. */
+    aiConfigId: string;
+    /** Pergunta em texto puro do usuário. O embedding é gerado internamente pelo Portal (RagService.getEmbedding), não pelo chamador. */
+    question: string;
+    conversationHistory?: unknown;
 }
-interface InternalContextResult {
-    found: boolean;
-    contextData?: string;
+interface InternalContextChunk {
+    chunkId?: string;
+    content: string;
+    /** Similaridade de cosseno (0-1) entre a pergunta e o trecho. */
+    similarity: number;
+    metadata?: Record<string, unknown>;
 }
+/** Lista de trechos relevantes, já filtrados pelo `ragThreshold` do AiConfig — vazia quando nada supera o limiar. */
+type InternalContextResult = InternalContextChunk[];
 
 declare class KnowledgeResource extends BaseResource {
-    /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+    /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */
     getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
 }
 
@@ -301,4 +324,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };
+export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };

package/dist/index.d.ts

@@ -96,6 +96,8 @@ interface AiConfig {
     handoffAiState?: 'inactive' | 'untag';
     /** Ativa a Reflection Agent (segunda passada de revisão/auditoria da resposta) pra este cliente. Ausente/undefined = usa o fallback global (env USE_REFLECTION_AGENT) no atende360-assistant — ver Orchestrator.ts. */
     reflectionAgentEnabled?: boolean;
+    /** Limiar mínimo de similaridade (cosine, 0-1) pra um trecho da base de conhecimento entrar no contexto do RAG. `undefined`/`null` = o Portal usa o fallback global 0.5 até o admin calibrar via RAG eval. Aplicado internamente pelo Portal em `POST /api/knowledge/internal/context` — não precisa ser enviado pelo assistant-api. */
+    ragThreshold?: number | null;
     [key: string]: any;
 }
 interface AiExperimentCriteria {
@@ -166,6 +168,12 @@ interface LossReasonMapping {
      * de 1 item automaticamente — sem migração necessária.
      */
     ai_move_conditions?: string[];
+    /**
+     * Nota livre do admin explicando o que este motivo de perda realmente representa, quando o
+     * nome sozinho não deixa claro. Usada só como grounding pra geração de condições por IA no
+     * portal — não é lida pelo assistant-api (não afeta a decisão de movimentação em si).
+     */
+    ai_context_note?: string;
 }
 interface StageMapping {
     stage_id: number;
@@ -191,6 +199,14 @@ interface StageMapping {
      * "só anda pra frente".
      */
     ai_allow_regression?: boolean;
+    /**
+     * Nota livre do admin explicando o que esta etapa realmente representa, pra quando o nome
+     * de exibição no Kommo é só visual/interno pro cliente e não descreve a função real da
+     * etapa (ex.: nome genérico "Fase 2" que na prática significa "lead já pagou o sinal mas
+     * ainda não agendou a instalação"). Usada só como grounding pra geração de condições por
+     * IA no portal — não é lida pelo assistant-api (não afeta a decisão de movimentação em si).
+     */
+    ai_context_note?: string;
     loss_reasons?: LossReasonMapping[];
 }
 interface PipelineMapping {
@@ -273,17 +289,24 @@ declare class ClientsResource extends BaseResource {
 }
 
 interface GetInternalContextParams {
-    clientId: number | string;
-    /** Embedding da mensagem do usuário (vetor numérico). */
-    userQuery: number[];
+    /** Id do AiConfig do cliente — o Portal usa a `apiKey` configurada nele pra gerar o embedding da pergunta. */
+    aiConfigId: string;
+    /** Pergunta em texto puro do usuário. O embedding é gerado internamente pelo Portal (RagService.getEmbedding), não pelo chamador. */
+    question: string;
+    conversationHistory?: unknown;
 }
-interface InternalContextResult {
-    found: boolean;
-    contextData?: string;
+interface InternalContextChunk {
+    chunkId?: string;
+    content: string;
+    /** Similaridade de cosseno (0-1) entre a pergunta e o trecho. */
+    similarity: number;
+    metadata?: Record<string, unknown>;
 }
+/** Lista de trechos relevantes, já filtrados pelo `ragThreshold` do AiConfig — vazia quando nada supera o limiar. */
+type InternalContextResult = InternalContextChunk[];
 
 declare class KnowledgeResource extends BaseResource {
-    /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+    /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */
     getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
 }
 
@@ -301,4 +324,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };
+export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };

package/dist/index.js

@@ -68,11 +68,12 @@ var ClientsResource = class extends BaseResource {
 
 // src/resources/knowledge/index.ts
 var KnowledgeResource = class extends BaseResource {
-  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */
   async getInternalContext(params) {
     const response = await this.client.post("/api/knowledge/internal/context", {
-      clientId: params.clientId,
-      userQuery: params.userQuery
+      aiConfigId: params.aiConfigId,
+      question: params.question,
+      conversationHistory: params.conversationHistory
     });
     return response.data;
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["export * from './client';\nexport * from './types';\nexport * from './errors';\nexport * from './resources/clients';\nexport * from './resources/clients/types';\nexport * from './resources/knowledge';\nexport * from './resources/knowledge/types';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      clientId: params.clientId,\n      userQuery: params.userQuery\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAqC;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IACpB,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACZO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,aAAAA,QAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":["axios"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["export * from './client';\nexport * from './types';\nexport * from './errors';\nexport * from './resources/clients';\nexport * from './resources/clients/types';\nexport * from './resources/knowledge';\nexport * from './resources/knowledge/types';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAqC;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,YAAY,OAAO;AAAA,MACnB,UAAU,OAAO;AAAA,MACjB,qBAAqB,OAAO;AAAA,IAC9B,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACbO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,aAAAA,QAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":["axios"]}

package/dist/index.mjs

@@ -29,11 +29,12 @@ var ClientsResource = class extends BaseResource {
 
 // src/resources/knowledge/index.ts
 var KnowledgeResource = class extends BaseResource {
-  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */
   async getInternalContext(params) {
     const response = await this.client.post("/api/knowledge/internal/context", {
-      clientId: params.clientId,
-      userQuery: params.userQuery
+      aiConfigId: params.aiConfigId,
+      question: params.question,
+      conversationHistory: params.conversationHistory
     });
     return response.data;
   }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      clientId: params.clientId,\n      userQuery: params.userQuery\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";AAAA,OAAO,WAA8B;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IACpB,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACZO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,MAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";AAAA,OAAO,WAA8B;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,YAAY,OAAO;AAAA,MACnB,UAAU,OAAO;AAAA,MACjB,qBAAqB,OAAO;AAAA,IAC9B,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACbO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,MAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-aiatende-api",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",