@trii/types 2.10.751 → 2.10.753

package/dist/src/Conversations/Flows/Workflows/Workflow.d.ts

@@ -36,139 +36,296 @@ export interface IWorkflow {
     finalizedAt?: Date | null;
     finalizedBy?: string | null;
 }
-export declare enum NodeStatus {
-    QUEUED = 0,
-    ERROR = 1,
-    RUNNING = 10,
-    WAITING = 15,
-    SKIPPED = 16,
-    COMPLETED = 20
-}
-export declare enum DisplayPanel {
-    Right = 0,
-    Center = 1,
-    Left = 2
+export declare enum ExecutionOperationType {
+    Node = "Node",
+    Agent = "Agent",
+    Worker = "Worker",
+    LlmCall = "LlmCall",
+    ToolCall = "ToolCall",
+    Handoff = "Handoff",
+    MessageReceived = "MessageReceived",
+    MessageSent = "MessageSent"
 }
-export declare enum FlowTrigger {
-    Message = 0,
-    ConversationOpened = 10,
-    ConversationClosed = 11,
-    ContactTagUpdated = 20,
-    ContactFieldUpdated = 21,
-    ContactFieldDates = 22,
-    ContactEventDate = 23,
-    Manual = 90,
-    Retry = 91,
-    Api = 92
-}
-export interface IFlowExecution {
+export declare enum ExecutionStatus {
+    Queued = "Queued",
+    Running = "Running",
+    Waiting = "Waiting",
+    Completed = "Completed",
+    Incomplete = "Incomplete",
+    Failed = "Failed",
+    Cancelled = "Cancelled",
+    TimedOut = "TimedOut",
+    Skipped = "Skipped"
+}
+export interface ExecutionNodeReference {
+    id: string;
+    name: string;
+    /** Valor real de NodeType. */
+    type: string;
+}
+export interface ExecutionPayload {
+    /** MIME type, por ejemplo text/plain o application/json. */
+    contentType: string;
+    value: string | null;
+    /** Indica que value no contiene el contenido completo. */
+    truncated: boolean;
+    /** Referencia estable cuando el contenido se guarda externamente. */
+    referenceId: string | null;
+}
+export interface ExecutionError {
+    code: string;
+    message: string;
+    category: string | null;
+    providerCode: string | null;
+    retryable: boolean;
+    /** Información técnica sanitizada. */
+    details: string | null;
+    occurredAt: Date;
+}
+export interface LlmExecutionData {
+    provider: string;
+    model: string;
+    /** Iteración dentro del agente o worker. Comienza en 1. */
+    iteration: number;
+    clientRequestId: string | null;
+    providerRequestId: string | null;
+    transportStatusCode: number | null;
+    /** Estado original informado por el proveedor. */
+    providerStatus: string | null;
+    finishReason: string | null;
+    incompleteReason: string | null;
+    usage: LlmTokenUsage;
+    outputItems: LlmOutputItem[];
+}
+export interface LlmTokenUsage {
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+    cachedInputTokens: number | null;
+    reasoningTokens: number | null;
+}
+export declare enum LlmOutputType {
+    Text = "Text",
+    ToolCall = "ToolCall",
+    Refusal = "Refusal",
+    Image = "Image",
+    Audio = "Audio",
+    File = "File",
+    Unknown = "Unknown"
+}
+export interface LlmOutputItem {
     id: string;
+    type: LlmOutputType;
+    text: string | null;
+    toolCallId: string | null;
+    toolName: string | null;
+    toolArguments: string | null;
+    providerStatus: string | null;
+    refusalReason: string | null;
+}
+export interface ToolExecutionData {
+    toolCallId: string;
+    toolName: string;
+    replayed: boolean;
+    idempotencyProtected: boolean;
+    operationKeyHash: string | null;
+    argumentsHash: string | null;
+}
+export interface HandoffExecutionData {
+    sourceAgentId: string;
+    targetAgentId: string;
+    reason: string;
+    context: ExecutionPayload | null;
+    result: ExecutionPayload | null;
+}
+export declare enum ExecutionMessageDirection {
+    Unknown = "Unknown",
+    Incoming = "Incoming",
+    Outgoing = "Outgoing"
+}
+export declare enum ExecutionMessageDeliveryStatus {
+    Unknown = "Unknown",
+    Received = "Received",
+    Queued = "Queued",
+    Sent = "Sent",
+    Delivered = "Delivered",
+    Read = "Read",
+    Failed = "Failed"
+}
+export interface ExecutionMessageReference {
+    messageId: string;
+    shardKey: string;
+    spaceId: string;
+    conversationId: string;
+    contactId: string | null;
+}
+export interface MessageExecutionData {
+    source: ExecutionMessageReference;
+    direction: ExecutionMessageDirection;
+    channel: string | null;
+    remoteAddress: string | null;
+    deliveryStatus: ExecutionMessageDeliveryStatus;
+    receivedAt: Date | null;
+    sentAt: Date | null;
+    deliveredAt: Date | null;
+    readAt: Date | null;
+    replyTo: ExecutionMessageReference | null;
+    content: ExecutionMessageContent[];
+}
+export declare enum ExecutionMessageContentType {
+    Text = "Text",
+    Image = "Image",
+    Audio = "Audio",
+    Video = "Video",
+    Document = "Document",
+    Location = "Location",
+    Contact = "Contact",
+    Template = "Template",
+    Interactive = "Interactive"
+}
+export interface ExecutionMessageContent {
+    id: string;
+    type: ExecutionMessageContentType;
+    text: string | null;
+    /** JSON para ubicación, contacto, template o contenido interactivo. */
+    data: string | null;
+    media: MediaReference | null;
+    transcription: AudioTranscription | null;
+}
+export interface MediaReference {
+    mediaId: string | null;
+    fileName: string | null;
+    mimeType: string | null;
+    sizeBytes: number | null;
+    storageProvider: string | null;
+    storagePath: string | null;
+    /** Puede ser una URL temporal. No es la identidad del archivo. */
+    url: string | null;
+    checksum: string | null;
+    width: number | null;
+    height: number | null;
+    durationSeconds: number | null;
+}
+export declare enum AudioTranscriptionStatus {
+    Pending = "Pending",
+    Processing = "Processing",
+    Completed = "Completed",
+    Failed = "Failed"
+}
+export declare enum TranscriptionPersistenceStatus {
+    Pending = "Pending",
+    Persisted = "Persisted",
+    Failed = "Failed"
+}
+export interface AudioTranscription {
+    status: AudioTranscriptionStatus;
+    text: string | null;
+    provider: string | null;
+    model: string | null;
+    language: string | null;
+    confidence: number | null;
+    /** Operación STT que produjo la transcripción. */
+    sourceOperationId: string | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    /** Resultado de actualizar Message.audio.transcript. */
+    persistenceStatus: TranscriptionPersistenceStatus;
+    persistenceError: ExecutionError | null;
+}
+export interface FlowOperationExecution {
+    id: string;
+    schemaVersion: number;
     spaceId: string;
     workflowId: string;
-    success: boolean;
-    errorMessage?: string;
-    triggeredBy: FlowTrigger;
-    nodeCount: number;
-    nodesCompleted: number;
-    nodesError: number;
-    nodesSkipped: number;
-    executionStartAt: Date;
-    executionEndAt: Date;
-    executionDuration: number;
-    tokensConsumedTokens: ITokenUsage[];
-    tokensTotalCount: number;
-    tokensTotalCost: number;
-}
-export interface ITokenUsage {
-    llmProvider: string;
-    llmModel: string;
-    nodeType: string;
-    nodeName: string;
-    inputTokens: number;
-    outputTokens: number;
-    inputPrice: number;
-    outputPrice: number;
-    totalTokens: number;
-    totalCost: number;
+    flowExecutionId: string;
+    operationType: ExecutionOperationType;
+    operationName: string;
+    /** Nodo visual asociado. Puede ser null para eventos externos. */
+    node: ExecutionNodeReference | null;
+    parentOperationId: string | null;
+    rootOperationId: string;
+    depth: number;
+    sequence: number;
+    status: ExecutionStatus;
+    createdAt: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    durationMs: number | null;
+    attempt: number;
+    maxAttempts: number;
+    input: ExecutionPayload | null;
+    output: ExecutionPayload | null;
+    llm: LlmExecutionData | null;
+    tool: ToolExecutionData | null;
+    handoff: HandoffExecutionData | null;
+    message: MessageExecutionData | null;
+    error: ExecutionError | null;
+}
+export declare enum FlowTrigger {
+    Message = "Message",
+    ConversationOpened = "ConversationOpened",
+    ConversationClosed = "ConversationClosed",
+    ContactTagUpdated = "ContactTagUpdated",
+    ContactFieldUpdated = "ContactFieldUpdated",
+    ContactFieldDates = "ContactFieldDates",
+    ContactEventDate = "ContactEventDate",
+    Manual = "Manual",
+    Retry = "Retry",
+    Api = "Api"
 }
-export interface INodeLog {
-    title: string;
-    level: 'info' | 'warning' | 'error';
-    data?: string;
+export interface FlowExecutionTrigger {
+    type: FlowTrigger;
+    /** Id del evento externo cuando el trigger no es un mensaje. */
+    referenceId: string | null;
+    /** Referencia completa cuando la ejecución fue iniciada por un mensaje. */
+    message: ExecutionMessageReference | null;
 }
-export interface INodeExecution {
+export interface FlowExecution {
     id: string;
+    schemaVersion: number;
     spaceId: string;
     workflowId: string;
-    flowId: string;
-    nodeId: string;
-    nodeName: string | '';
-    nodeType: string;
-    parentNodeId: string | '';
-    nextAgentId?: string | null;
-    executionId?: string | null;
-    executionOrder: number;
-    /**
-     * Execution time in milliseconds
-     */
-    executionTimeMs: number | 0;
+    trigger: FlowExecutionTrigger;
+    status: ExecutionStatus;
     createdAt: Date;
-    completedAt?: Date | null;
-    tokens: number | 0;
-    tokensInput: number | 0;
-    tokensOutput: number | 0;
-    status: NodeStatus;
-    retryAttempt: number | 0;
-    retryMaxAttempts: number | 0;
-    error?: INodeError;
-    displayPanel: DisplayPanel;
-    content?: IMessageLLM[];
-    outputData?: string | null;
-    inputData?: string | null;
-    logs?: INodeLog[];
-    parentNodeExecutionId?: string | null;
-    parentToolCallId?: string | null;
-    depth: number | 0;
-}
-export interface INodeError {
-    code: string;
-    message: string;
-    stackTrace?: string;
-    isRetryable: boolean | false;
-}
-export declare enum MessageType {
-    Text = 0,
-    Image = 1,
-    File = 2,
-    Audio = 3,
-    Tool = 4,
-    Handoff = 5
-}
-export interface IMessageLLM {
-    role: 'tool' | 'user' | 'assistant';
-    type: MessageType;
-    text?: string;
-    /**For audio transcription or OCR processing */
-    mimeType?: string;
-    url?: string;
-    transcription?: string;
-    isReference: boolean | false;
-    handoffTargetAgentId?: string;
-    handoffReason?: string;
-    handoffContext?: string;
-    handoffResult?: string;
-    isMessageSended?: boolean | false;
-    /**Tool call related information */
-    toolNodeId?: string | null;
-    toolCallId?: string;
-    toolName?: string;
-    toolArguments?: string;
-    toolOutput?: string;
-    toolStatus?: NodeStatus;
-    /**related to messages module */
-    messageId?: string;
-    messageShardKey?: string;
-    messageTimeStamp?: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    durationMs: number | null;
+    counters: FlowExecutionCounters;
+    usage: FlowExecutionUsage;
+    error: ExecutionError | null;
+}
+export interface FlowExecutionCounters {
+    operationsTotal: number;
+    operationsCompleted: number;
+    operationsIncomplete: number;
+    operationsFailed: number;
+    operationsCancelled: number;
+    operationsTimedOut: number;
+    operationsSkipped: number;
+    nodes: number;
+    agents: number;
+    workers: number;
+    llmCalls: number;
+    toolCalls: number;
+    messagesReceived: number;
+    messagesSent: number;
+}
+export interface FlowExecutionUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
+    providers: LlmProviderUsage[];
+}
+export interface LlmProviderUsage {
+    provider: string;
+    model: string;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
 }
 export declare enum WorkflowStatus {
     NONE = 0,

package/dist/src/Conversations/Flows/Workflows/Workflow.js

@@ -1,43 +1,93 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowStatus = exports.MessageType = exports.FlowTrigger = exports.DisplayPanel = exports.NodeStatus = void 0;
-var NodeStatus;
-(function (NodeStatus) {
-    NodeStatus[NodeStatus["QUEUED"] = 0] = "QUEUED";
-    NodeStatus[NodeStatus["ERROR"] = 1] = "ERROR";
-    NodeStatus[NodeStatus["RUNNING"] = 10] = "RUNNING";
-    NodeStatus[NodeStatus["WAITING"] = 15] = "WAITING";
-    NodeStatus[NodeStatus["SKIPPED"] = 16] = "SKIPPED";
-    NodeStatus[NodeStatus["COMPLETED"] = 20] = "COMPLETED";
-})(NodeStatus || (exports.NodeStatus = NodeStatus = {}));
-var DisplayPanel;
-(function (DisplayPanel) {
-    DisplayPanel[DisplayPanel["Right"] = 0] = "Right";
-    DisplayPanel[DisplayPanel["Center"] = 1] = "Center";
-    DisplayPanel[DisplayPanel["Left"] = 2] = "Left";
-})(DisplayPanel || (exports.DisplayPanel = DisplayPanel = {}));
+exports.WorkflowStatus = exports.FlowTrigger = exports.TranscriptionPersistenceStatus = exports.AudioTranscriptionStatus = exports.ExecutionMessageContentType = exports.ExecutionMessageDeliveryStatus = exports.ExecutionMessageDirection = exports.LlmOutputType = exports.ExecutionStatus = exports.ExecutionOperationType = void 0;
+var ExecutionOperationType;
+(function (ExecutionOperationType) {
+    ExecutionOperationType["Node"] = "Node";
+    ExecutionOperationType["Agent"] = "Agent";
+    ExecutionOperationType["Worker"] = "Worker";
+    ExecutionOperationType["LlmCall"] = "LlmCall";
+    ExecutionOperationType["ToolCall"] = "ToolCall";
+    ExecutionOperationType["Handoff"] = "Handoff";
+    ExecutionOperationType["MessageReceived"] = "MessageReceived";
+    ExecutionOperationType["MessageSent"] = "MessageSent";
+})(ExecutionOperationType || (exports.ExecutionOperationType = ExecutionOperationType = {}));
+var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["Queued"] = "Queued";
+    ExecutionStatus["Running"] = "Running";
+    ExecutionStatus["Waiting"] = "Waiting";
+    ExecutionStatus["Completed"] = "Completed";
+    ExecutionStatus["Incomplete"] = "Incomplete";
+    ExecutionStatus["Failed"] = "Failed";
+    ExecutionStatus["Cancelled"] = "Cancelled";
+    ExecutionStatus["TimedOut"] = "TimedOut";
+    ExecutionStatus["Skipped"] = "Skipped";
+})(ExecutionStatus || (exports.ExecutionStatus = ExecutionStatus = {}));
+var LlmOutputType;
+(function (LlmOutputType) {
+    LlmOutputType["Text"] = "Text";
+    LlmOutputType["ToolCall"] = "ToolCall";
+    LlmOutputType["Refusal"] = "Refusal";
+    LlmOutputType["Image"] = "Image";
+    LlmOutputType["Audio"] = "Audio";
+    LlmOutputType["File"] = "File";
+    LlmOutputType["Unknown"] = "Unknown";
+})(LlmOutputType || (exports.LlmOutputType = LlmOutputType = {}));
+var ExecutionMessageDirection;
+(function (ExecutionMessageDirection) {
+    ExecutionMessageDirection["Unknown"] = "Unknown";
+    ExecutionMessageDirection["Incoming"] = "Incoming";
+    ExecutionMessageDirection["Outgoing"] = "Outgoing";
+})(ExecutionMessageDirection || (exports.ExecutionMessageDirection = ExecutionMessageDirection = {}));
+var ExecutionMessageDeliveryStatus;
+(function (ExecutionMessageDeliveryStatus) {
+    ExecutionMessageDeliveryStatus["Unknown"] = "Unknown";
+    ExecutionMessageDeliveryStatus["Received"] = "Received";
+    ExecutionMessageDeliveryStatus["Queued"] = "Queued";
+    ExecutionMessageDeliveryStatus["Sent"] = "Sent";
+    ExecutionMessageDeliveryStatus["Delivered"] = "Delivered";
+    ExecutionMessageDeliveryStatus["Read"] = "Read";
+    ExecutionMessageDeliveryStatus["Failed"] = "Failed";
+})(ExecutionMessageDeliveryStatus || (exports.ExecutionMessageDeliveryStatus = ExecutionMessageDeliveryStatus = {}));
+var ExecutionMessageContentType;
+(function (ExecutionMessageContentType) {
+    ExecutionMessageContentType["Text"] = "Text";
+    ExecutionMessageContentType["Image"] = "Image";
+    ExecutionMessageContentType["Audio"] = "Audio";
+    ExecutionMessageContentType["Video"] = "Video";
+    ExecutionMessageContentType["Document"] = "Document";
+    ExecutionMessageContentType["Location"] = "Location";
+    ExecutionMessageContentType["Contact"] = "Contact";
+    ExecutionMessageContentType["Template"] = "Template";
+    ExecutionMessageContentType["Interactive"] = "Interactive";
+})(ExecutionMessageContentType || (exports.ExecutionMessageContentType = ExecutionMessageContentType = {}));
+var AudioTranscriptionStatus;
+(function (AudioTranscriptionStatus) {
+    AudioTranscriptionStatus["Pending"] = "Pending";
+    AudioTranscriptionStatus["Processing"] = "Processing";
+    AudioTranscriptionStatus["Completed"] = "Completed";
+    AudioTranscriptionStatus["Failed"] = "Failed";
+})(AudioTranscriptionStatus || (exports.AudioTranscriptionStatus = AudioTranscriptionStatus = {}));
+var TranscriptionPersistenceStatus;
+(function (TranscriptionPersistenceStatus) {
+    TranscriptionPersistenceStatus["Pending"] = "Pending";
+    TranscriptionPersistenceStatus["Persisted"] = "Persisted";
+    TranscriptionPersistenceStatus["Failed"] = "Failed";
+})(TranscriptionPersistenceStatus || (exports.TranscriptionPersistenceStatus = TranscriptionPersistenceStatus = {}));
 var FlowTrigger;
 (function (FlowTrigger) {
-    FlowTrigger[FlowTrigger["Message"] = 0] = "Message";
-    FlowTrigger[FlowTrigger["ConversationOpened"] = 10] = "ConversationOpened";
-    FlowTrigger[FlowTrigger["ConversationClosed"] = 11] = "ConversationClosed";
-    FlowTrigger[FlowTrigger["ContactTagUpdated"] = 20] = "ContactTagUpdated";
-    FlowTrigger[FlowTrigger["ContactFieldUpdated"] = 21] = "ContactFieldUpdated";
-    FlowTrigger[FlowTrigger["ContactFieldDates"] = 22] = "ContactFieldDates";
-    FlowTrigger[FlowTrigger["ContactEventDate"] = 23] = "ContactEventDate";
-    FlowTrigger[FlowTrigger["Manual"] = 90] = "Manual";
-    FlowTrigger[FlowTrigger["Retry"] = 91] = "Retry";
-    FlowTrigger[FlowTrigger["Api"] = 92] = "Api";
+    FlowTrigger["Message"] = "Message";
+    FlowTrigger["ConversationOpened"] = "ConversationOpened";
+    FlowTrigger["ConversationClosed"] = "ConversationClosed";
+    FlowTrigger["ContactTagUpdated"] = "ContactTagUpdated";
+    FlowTrigger["ContactFieldUpdated"] = "ContactFieldUpdated";
+    FlowTrigger["ContactFieldDates"] = "ContactFieldDates";
+    FlowTrigger["ContactEventDate"] = "ContactEventDate";
+    FlowTrigger["Manual"] = "Manual";
+    FlowTrigger["Retry"] = "Retry";
+    FlowTrigger["Api"] = "Api";
 })(FlowTrigger || (exports.FlowTrigger = FlowTrigger = {}));
-var MessageType;
-(function (MessageType) {
-    MessageType[MessageType["Text"] = 0] = "Text";
-    MessageType[MessageType["Image"] = 1] = "Image";
-    MessageType[MessageType["File"] = 2] = "File";
-    MessageType[MessageType["Audio"] = 3] = "Audio";
-    MessageType[MessageType["Tool"] = 4] = "Tool";
-    MessageType[MessageType["Handoff"] = 5] = "Handoff";
-})(MessageType || (exports.MessageType = MessageType = {}));
 var WorkflowStatus;
 (function (WorkflowStatus) {
     WorkflowStatus[WorkflowStatus["NONE"] = 0] = "NONE";

package/dist/src/Conversations/Groups/Group.d.ts

@@ -1,23 +1,17 @@
 import { UserInfo } from "../../Users/UserTrii";
-interface IGroup {
+export interface IGroup {
     id?: string | null;
     spaceId?: string | null;
     name?: string | null;
     color?: string | null;
     description?: string | null;
     users: UserInfo[];
-    distributionMethod: Group_DistributionMethod;
     createdAt?: string | null;
     updatedAt?: string | null;
     deletedAt?: string | null;
 }
-interface GroupInfo {
+export interface GroupInfo {
     id?: string | null;
     name?: string | null;
     color?: string | null;
 }
-declare enum Group_DistributionMethod {
-    All = 0,
-    FIFO = 1
-}
-export { IGroup, GroupInfo, Group_DistributionMethod };

package/dist/src/Conversations/Groups/Group.js

@@ -1,8 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Group_DistributionMethod = void 0;
-var Group_DistributionMethod;
-(function (Group_DistributionMethod) {
-    Group_DistributionMethod[Group_DistributionMethod["All"] = 0] = "All";
-    Group_DistributionMethod[Group_DistributionMethod["FIFO"] = 1] = "FIFO";
-})(Group_DistributionMethod || (exports.Group_DistributionMethod = Group_DistributionMethod = {}));