@wokuapp/sdk 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -60,6 +60,8 @@ type FetchLike = (input: string, init: {
         get(name: string): string | null;
     };
     text(): Promise<string>;
+    /** Needed only by binary downloads such as the folder PDF. */
+    arrayBuffer?(): Promise<ArrayBuffer>;
 }>;
 interface WokuClientOptions {
     /** Company secret key. Defaults to `process.env.WOKU_API_KEY`. */
@@ -89,6 +91,11 @@ interface RequestArgs extends RequestOptions {
      * (send/approve/test) so they are never silently replayed.
      */
     idempotent?: boolean;
+    /**
+     * Return a successful response as raw bytes (`Uint8Array`) instead of parsed
+     * JSON. Error responses are still parsed and mapped to API errors.
+     */
+    binary?: boolean;
 }
 /**
  * Transport core: turns a resource call into an authenticated HTTP request
@@ -158,6 +165,99 @@ interface components {
             clientEmail?: string;
             clientPhone?: string;
         };
+        FollowUpOriginDto: {
+            /** @enum {string} */
+            tool: "woku" | "nps" | "csat" | "ces";
+            refId: string;
+            instrumentId?: string;
+        };
+        FollowUpAttachmentDto: {
+            /** @description Stable number of the file in the conversation (survey prelude included). */
+            index: number;
+            /** @description Display label in the conversation language, e.g. "Archivo 2" or "File 2". Summaries cite files by this label. */
+            label: string;
+            /** @enum {string} */
+            kind: "image" | "audio" | "document" | "unsupported";
+            /** @description Private original file (evidence). Absent while pending or when nothing was stored (location, contacts, over the limits). */
+            fileId?: string;
+            /** @description Converted copy the model read, when there was a conversion. */
+            readableFileId?: string;
+            filename: string;
+            mimeType: string;
+            /** @enum {string} */
+            status: "pending" | "ready" | "failed" | "unsupported";
+            /** @description Transcript (audio) or description (image, document) generated from the file. Untrusted customer content. */
+            text?: string;
+            /** @description Stable reason code when failed or unsupported (e.g. video, location, message_limit, conversation_limit, read_failed). */
+            failureReason?: string;
+            /** @description Admin page that opens this file after login and a company check (signed, short-lived download). Never a storage URL. */
+            adminUrl?: string;
+        };
+        FollowUpMessageDto: {
+            /** @enum {string} */
+            role: "agent" | "client";
+            /** @description Message text. May be empty when the message only has files. */
+            content: string;
+            /** Format: date-time */
+            timestamp: string;
+            /**
+             * @description survey: the prelude, what the customer said in the survey before the follow-up. On the survey_thread line it is the WhatsApp survey exchange; on every other line (follow_up_number, email) it is the original comment as a client message. follow_up: the follow-up itself. Every line may start with the prelude, so messages[0] can be a client message; filter phase === 'follow_up' to read only the follow-up.
+             * @enum {string}
+             */
+            phase: "survey" | "follow_up";
+            responseType?: string;
+            selectedOption?: string;
+            /** @description Files the customer sent with this message. */
+            attachments?: components["schemas"]["FollowUpAttachmentDto"][];
+        };
+        FollowUpCitationDto: {
+            index: number;
+            /** @description Label of the cited file, e.g. "Archivo 2". */
+            label: string;
+            fileId?: string;
+            /** @description What the file supports in the summary. */
+            supports: string;
+            /** @description Admin page that opens this file after login and a company check (signed, short-lived download). Never a storage URL. */
+            adminUrl?: string;
+        };
+        FollowUpConversationDto: {
+            _id: string;
+            companyId: string;
+            origin: components["schemas"]["FollowUpOriginDto"];
+            wokuId?: string;
+            reviewId?: string;
+            /** @enum {string} */
+            reviewType: "textnote" | "voicemail";
+            originalReview: string;
+            originalQualification?: number;
+            /** @enum {string} */
+            state: "pending" | "initial_sent" | "awaiting_detail" | "closing" | "completed" | "timed_out" | "cancelled";
+            /** @enum {string} */
+            channel: "email" | "whatsapp";
+            /**
+             * @description WhatsApp line. survey_thread: the agent continues the survey conversation on the survey number. follow_up_number: the agent writes from the dedicated follow-up number. Absent for email.
+             * @enum {string}
+             */
+            line?: "survey_thread" | "follow_up_number";
+            /** @description Stable reason code for exclusion, failure or uncertain delivery. Provider error details are never exposed. */
+            reason?: string;
+            /** @description Messages in order: the survey prelude (phase survey) first, then the follow-up (phase follow_up). Filter phase === 'follow_up' for the follow-up messages only. */
+            messages: components["schemas"]["FollowUpMessageDto"][];
+            executiveSummary?: string;
+            actionItems?: string[];
+            sentiment?: string;
+            topics?: string[];
+            /** @description Files the summary cites; the summary text mentions them as "(Archivo N)". */
+            summaryCitations?: components["schemas"]["FollowUpCitationDto"][];
+            summaryVersion: number;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        FollowUpEnvelopeDto: {
+            data: components["schemas"]["FollowUpConversationDto"];
+        };
         CreateExternalTrackerDefinitionDTO: {
             /**
              * @description Tracker name. Identifies the tracker within the company catalog. Unique per company.
@@ -229,6 +329,33 @@ interface components {
              */
             value: string;
         };
+        CustomTicketDestinationUpdateDto: {
+            /**
+             * @description upsert explicitly reuses the creation URL/method with a stable externalId. remote-id updates the previously created remote resource.
+             * @enum {string}
+             */
+            mode: "upsert" | "remote-id";
+            /** @description remote-id only: same-origin URL containing {{remoteId}}; credentials and fragments are forbidden. */
+            url?: string;
+            /**
+             * @description remote-id only.
+             * @default PATCH
+             * @enum {string}
+             */
+            method: "PUT" | "PATCH";
+            /** @description Dot-separated path to the ID in the creation response, required for remote-id. Prototype keys are forbidden. */
+            responseIdPath?: string;
+        };
+        CustomTicketDestinationConfigDto: {
+            /** Format: uri */
+            url: string;
+            /** @enum {string} */
+            method?: "POST" | "PUT";
+            headers?: {
+                [key: string]: string;
+            };
+            update?: components["schemas"]["CustomTicketDestinationUpdateDto"];
+        };
         TicketRoutingConditionDto: {
             /** @enum {string} */
             relationToPrevious?: "AND" | "OR";
@@ -251,10 +378,12 @@ interface components {
         V1CreateTicketDestinationDto: {
             /** @example Zendesk Soporte Chile */
             name: string;
-            /** @description Non-secret provider config (validated per kind). */
+            /** @description Kind-specific destination configuration. Custom update is optional and explicit; omission never causes a second create. */
             config: {
                 [key: string]: unknown;
-            };
+            } & (components["schemas"]["CustomTicketDestinationConfigDto"] | {
+                [key: string]: unknown;
+            });
             /** @description Provider credentials (write-only, encrypted). */
             credentials: {
                 [key: string]: string;
@@ -268,9 +397,12 @@ interface components {
         };
         V1UpdateTicketDestinationDto: {
             name?: string;
+            /** @description Kind-specific configuration including explicit custom update capability. */
             config?: {
                 [key: string]: unknown;
-            };
+            } & (components["schemas"]["CustomTicketDestinationConfigDto"] | {
+                [key: string]: unknown;
+            });
             /** @description Present = credential rotation. */
             credentials?: {
                 [key: string]: string;
@@ -407,6 +539,16 @@ interface components {
             folderId: string | null;
         };
         V1CreateTextnoteBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /** @description Opaque invitation or prepared journey-entry response token. Consumed after saving feedback; never stored on the review. */
             dispatchToken?: string;
             /**
@@ -429,6 +571,16 @@ interface components {
             responseChannel?: string;
         };
         V1CreateVoicemailBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /** @description Opaque invitation or prepared journey-entry response token. Consumed after saving feedback; never stored on the review. */
             dispatchToken?: string;
             /**
@@ -488,6 +640,16 @@ interface components {
             revoked: boolean;
         };
         V1CreateNpsBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /**
              * @description NPS score 0-10 (0-6 detractor, 7-8 passive, 9-10 promoter)
              * @example 9
@@ -526,6 +688,16 @@ interface components {
             description: string;
         };
         V1CreateCsatBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /**
              * @description CSAT satisfaction score 1-5
              * @example 4
@@ -559,6 +731,16 @@ interface components {
             description: string;
         };
         V1CreateCesBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /**
              * @description CES effort score 1-5
              * @example 4
@@ -608,6 +790,16 @@ interface components {
             externalId?: string;
         };
         V1CaptureBodyDto: {
+            /**
+             * @description Collection provenance. Omitted historical inputs remain unknown and cannot start follow-up.
+             * @enum {string}
+             */
+            collectionKind?: "standalone" | "flow";
+            /**
+             * Format: ObjectId
+             * @description Required for flow captures; validated against the company and instrument.
+             */
+            flowId?: string;
             /** @description Opaque invitation or prepared journey-entry response token. Consumed after saving feedback; never stored on the review. */
             dispatchToken?: string;
             /** @description Client-generated idempotency id */
@@ -802,6 +994,29 @@ interface components {
              */
             dispatchToken?: string;
         };
+        FlowStepBodyDTO: {
+            /**
+             * @description Kind of tool the respondent answers in this step.
+             * @enum {string}
+             */
+            type: "woku" | "nps" | "csat" | "ces";
+            /**
+             * Format: ObjectId
+             * @description Tool id (woku, NPS tool, CSAT tool or CES tool). For an nps step, your company id means the company-level NPS.
+             */
+            toolId: string;
+        };
+        CreateFlowBodyDTO: {
+            /** @example Post-purchase journey */
+            name: string;
+            /** @description Ordered steps. A tool can appear once. Flows live outside folders. */
+            steps: components["schemas"]["FlowStepBodyDTO"][];
+        };
+        UpdateFlowBodyDTO: {
+            name?: string;
+            /** @description The new full ordered list of steps. */
+            steps?: components["schemas"]["FlowStepBodyDTO"][];
+        };
         NpsToolLocalizedContentBodyDTO: {
             /**
              * @example en
@@ -820,6 +1035,11 @@ interface components {
             audienceType?: string;
         };
         CreateNpsToolBodyDTO: {
+            /**
+             * Format: ObjectId
+             * @description Folder to create the tool in. Must belong to your company. Omit for the root.
+             */
+            folderId?: string;
             /**
              * @description Tool name for identification.
              * @example Post-Purchase Survey
@@ -874,6 +1094,13 @@ interface components {
             defaultLocale?: "es" | "en";
             localizedContent?: components["schemas"]["NpsToolLocalizedContentBodyDTO"][];
         };
+        MoveToolBodyDTO: {
+            /**
+             * Format: ObjectId
+             * @description Target folder id, or null to move the tool to the root.
+             */
+            folderId: string | null;
+        };
         CsatToolLocalizedContentBodyDTO: {
             /**
              * @example en
@@ -892,6 +1119,11 @@ interface components {
             subject?: string;
         };
         CreateCsatToolBodyDTO: {
+            /**
+             * Format: ObjectId
+             * @description Folder to create the tool in. Must belong to your company. Omit for the root.
+             */
+            folderId?: string;
             /**
              * @description Tool name for identification.
              * @example Post-Purchase CSAT
@@ -956,6 +1188,11 @@ interface components {
             action?: string;
         };
         CreateCesToolBodyDTO: {
+            /**
+             * Format: ObjectId
+             * @description Folder to create the tool in. Must belong to your company. Omit for the root.
+             */
+            folderId?: string;
             /**
              * @description Tool name for identification.
              * @example Post-Purchase Effort
@@ -1002,6 +1239,96 @@ interface components {
             defaultLocale?: "es" | "en";
             localizedContent?: components["schemas"]["CesToolLocalizedContentBodyDTO"][];
         };
+        PublicTicketOriginDto: {
+            /** @enum {string} */
+            tool: "woku" | "nps" | "form" | "csat" | "ces";
+            refId: string;
+            instrumentId?: string;
+            instrumentName?: string;
+            trackers?: {
+                trackerId?: string;
+                name?: string;
+                value?: string;
+            }[];
+        };
+        TicketFollowUpDto: {
+            conversationId?: string;
+            /** @enum {string} */
+            state: "not_applicable" | "pending" | "initial_sent" | "awaiting_detail" | "closing" | "completed" | "timed_out" | "cancelled";
+            reason?: string;
+            availableSummaryVersion?: number;
+            /**
+             * @description Current result of applying follow-up evidence to the ticket.
+             * @enum {string}
+             */
+            enrichmentState?: "processing" | "applied" | "failed" | "skipped";
+            /** @description Machine-readable reason for the enrichment result, without provider details or credentials. */
+            enrichmentReason?: string;
+            /** @description Last summary version successfully applied to this ticket. Conversation completion alone does not imply enrichment. */
+            appliedSummaryVersion?: number;
+            /** Format: date-time */
+            enrichedAt?: string;
+        };
+        PublicTicketDto: {
+            _id: string;
+            code?: string;
+            title: string;
+            /** @enum {string} */
+            severity: "high" | "medium" | "low";
+            destinationId?: string;
+            origin: components["schemas"]["PublicTicketOriginDto"];
+            /**
+             * @description Monotonic version of generated ticket content.
+             * @default 1
+             */
+            contentVersion: number;
+            followUp?: components["schemas"]["TicketFollowUpDto"];
+            score?: {
+                value?: number;
+                max?: number;
+                kind?: string;
+                display?: string;
+            };
+            aiSummary?: string;
+            aiCategory?: string;
+            caseDescription?: string;
+            historyHighlights?: string[];
+            whatCustomerWants?: string;
+            suggestedResolution?: string;
+            language?: string;
+            churnRisk?: string;
+            criteria?: string[];
+            historySnapshot?: {
+                [key: string]: unknown;
+            };
+            sentiment?: string;
+            generatedByAI?: boolean;
+            customerComment?: {
+                text?: string;
+                isAudio?: boolean;
+                audioUrl?: string;
+                transcription?: string;
+            };
+            client?: {
+                clientId?: string;
+                name?: string;
+                email?: string;
+                phone?: string;
+            };
+            timeline?: {
+                [key: string]: unknown;
+            }[];
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        PublicTicketsPageDto: {
+            data: components["schemas"]["PublicTicketDto"][];
+            total: number;
+            page: number;
+            limit: number;
+        };
         UpdateTicketBodyDTO: {
             title?: string;
             /** @enum {string} */
@@ -1482,6 +1809,59 @@ interface components {
         V1JourneyEventResponseDto: {
             journeys: number;
         };
+        CreateFolderBodyDTO: {
+            /** @example Post-sale */
+            name: string;
+            /**
+             * Format: ObjectId
+             * @description Parent folder. Omit to create the folder at the root.
+             */
+            parentFolderId?: string;
+            /** @example #3498db */
+            color?: string;
+        };
+        WhatsappAlertRecipientDTO: {
+            /**
+             * @description E.164 phone number without the leading +.
+             * @example 56912345678
+             */
+            whatsappId: string;
+            /** @example Ana (support) */
+            name: string;
+            /** @description Kinds of comment that alert this number. Defaults to all four. */
+            sources?: ("woku" | "nps" | "csat" | "ces")[];
+        };
+        UpdateFolderBodyDTO: {
+            name?: string;
+            /**
+             * @description Hex color, or null to clear it.
+             * @example #3498db
+             */
+            color?: string | null;
+            /** @description Replaces the WhatsApp numbers alerted when a comment of any tool in this folder is an improvement (wokus, NPS, CSAT, CES). Send [] to clear. */
+            whatsappAlertRecipients?: components["schemas"]["WhatsappAlertRecipientDTO"][];
+        };
+        MoveFolderBodyDTO: {
+            /**
+             * Format: ObjectId
+             * @description New parent folder, or null to move the folder to the root. A folder cannot move into itself or one of its subfolders.
+             */
+            parentFolderId: string | null;
+        };
+        MoveItemDTO: {
+            /** @enum {string} */
+            type: "woku" | "nps" | "csat" | "ces" | "folder";
+            /** Format: ObjectId */
+            id: string;
+        };
+        MoveToolItemsBodyDTO: {
+            items: components["schemas"]["MoveItemDTO"][];
+            /**
+             * Format: ObjectId
+             * @description Destination folder. `null` moves the items to the root.
+             */
+            folderId: string | null;
+        };
         JourneyEntryInfoDto: {
             name?: string;
             momentName?: string;
@@ -1519,6 +1899,34 @@ interface components {
     pathItems: never;
 }
 interface operations {
+    V1FollowUpsController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FollowUpEnvelopeDto"];
+                };
+            };
+            /** @description Follow-up not found in this company */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     V1Controller_health: {
         parameters: {
             query?: never;
@@ -4337,6 +4745,40 @@ interface operations {
             };
         };
     };
+    V1FlowsController_createFlow: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Client-generated key to make the create safe to retry. A retry with the same key returns the original result instead of creating again. */
+                "X-Woku-Idempotency-Key"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateFlowBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Flow created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation error or a step is not a tool of your company */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
+                };
+            };
+        };
+    };
     V1FlowsController_getFlow: {
         parameters: {
             query?: never;
@@ -4372,60 +4814,118 @@ interface operations {
             };
         };
     };
-    V1NpsDataController_listNpsTools: {
+    V1FlowsController_deleteFlow: {
         parameters: {
-            query?: {
-                page?: number;
-                limit?: number;
-            };
+            query?: never;
             header?: never;
-            path?: never;
+            path: {
+                id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Paginated NPS tools */
+            /** @description Flow deleted */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Flow not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
-    V1NpsToolsController_createNpsTool: {
+    V1FlowsController_updateFlow: {
         parameters: {
             query?: never;
-            header?: {
-                /** @description Client-generated key to make the create safe to retry. A retry with the same key returns the original result instead of creating again. */
-                "X-Woku-Idempotency-Key"?: string;
+            header?: never;
+            path: {
+                id: string;
             };
-            path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateNpsToolBodyDTO"];
+                "application/json": components["schemas"]["UpdateFlowBodyDTO"];
             };
         };
         responses: {
-            /** @description NPS tool created */
-            201: {
+            /** @description Flow updated */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Validation error */
-            400: {
+            /** @description Flow not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
-                };
+                content?: never;
             };
-            /** @description Invalid or missing API key */
+        };
+    };
+    V1NpsDataController_listNpsTools: {
+        parameters: {
+            query?: {
+                page?: number;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated NPS tools */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1NpsToolsController_createNpsTool: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Client-generated key to make the create safe to retry. A retry with the same key returns the original result instead of creating again. */
+                "X-Woku-Idempotency-Key"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateNpsToolBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description NPS tool created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
+                };
+            };
+            /** @description Invalid or missing API key */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4713,6 +5213,37 @@ interface operations {
             };
         };
     };
+    V1NpsToolsController_moveNpsTool: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveToolBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description NPS tool moved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tool or folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     V1CsatToolsController_deleteCsatTool: {
         parameters: {
             query?: never;
@@ -4780,6 +5311,37 @@ interface operations {
             };
         };
     };
+    V1CsatToolsController_moveCsatTool: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveToolBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Csat tool moved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tool or folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     V1CesToolsController_deleteCesTool: {
         parameters: {
             query?: never;
@@ -4847,6 +5409,37 @@ interface operations {
             };
         };
     };
+    V1CesToolsController_moveCesTool: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveToolBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Ces tool moved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tool or folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     V1TicketsController_listTickets: {
         parameters: {
             query?: {
@@ -4875,7 +5468,9 @@ interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PublicTicketsPageDto"];
+                };
             };
             /** @description Validation error */
             400: {
@@ -4929,7 +5524,9 @@ interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PublicTicketDto"];
+                };
             };
             /** @description Ticket not found */
             404: {
@@ -4960,7 +5557,9 @@ interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PublicTicketDto"];
+                };
             };
             /** @description Validation error */
             400: {
@@ -5823,33 +6422,62 @@ interface operations {
             };
         };
     };
-    CustomJourneyEntryController_info: {
+    V1FoldersController_listFolders: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                journeyId: string;
+            query?: {
+                /** @description List only the direct subfolders of this folder. Omit to list every folder of the company. */
+                parentFolderId?: string;
+                /** @description Case and accent insensitive match on the folder name. */
+                q?: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
+            /** @description Folders */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["JourneyEntryInfoDto"];
+                content?: never;
+            };
+        };
+    };
+    V1FoldersController_createFolder: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Client-generated key to make the create safe to retry. A retry with the same key returns the original result instead of creating again. */
+                "X-Woku-Idempotency-Key"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateFolderBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Folder created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
-            /** @description Invalid contact, case reference or request ID */
+            /** @description Validation error */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
+                };
             };
-            /** @description This evaluation is not available */
+            /** @description Parent folder not found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -5858,52 +6486,84 @@ interface operations {
             };
         };
     };
-    CustomJourneyEntryController_prepare: {
+    V1FoldersController_getFolder: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                journeyId: string;
+                id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PrepareJourneyEntryDto"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            201: {
+            /** @description Folder */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["PreparedJourneyEntryDto"];
+                content?: never;
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
-            /** @description Invalid contact, case reference or request ID */
-            400: {
+        };
+    };
+    V1FoldersController_deleteFolder: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Folder deleted */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description This evaluation is not available */
+            /** @description Folder not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Customer or case already has an active evaluation */
-            409: {
+        };
+    };
+    V1FoldersController_updateFolder: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateFolderBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Folder updated */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Preparation is still in progress; retry with the same requestId */
-            503: {
+            /** @description Folder not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -5911,21 +6571,424 @@ interface operations {
             };
         };
     };
-}
-
-/** The full generated schema map (advanced use / escape hatch). */
-type Schemas = components['schemas'];
-type CreateTrackerParams = Schemas['CreateExternalTrackerDefinitionDTO'];
-type UpdateTrackerParams = Schemas['UpdateExternalTrackerDefinitionDTO'];
-type SearchEntitiesByTrackersParams = Schemas['SearchEntitiesByTrackersDTO'];
-type AssignTrackerByNameParams = Schemas['AssignExternalTrackerByNameDTO'];
-type CreateNpsToolParams = Schemas['CreateNpsToolBodyDTO'];
-type UpdateNpsToolParams = Schemas['UpdateNpsToolBodyDTO'];
-type CreateCsatToolParams = Schemas['CreateCsatToolBodyDTO'];
-type UpdateCsatToolParams = Schemas['UpdateCsatToolBodyDTO'];
-type CreateCesToolParams = Schemas['CreateCesToolBodyDTO'];
-type UpdateCesToolParams = Schemas['UpdateCesToolBodyDTO'];
-type SendInvitationsParams = Schemas['V1CreateInvitationsBodyDto'];
+    V1FoldersController_getFolderReport: {
+        parameters: {
+            query?: {
+                /** @description Regenerate the report even if the number of reviews did not change. */
+                regenerate?: boolean;
+                /** @description Language of the report narrative. */
+                lang?: "es" | "en";
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Folder report */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1FoldersController_getFolderPdf: {
+        parameters: {
+            query?: {
+                /** @description Language of the PDF. Defaults to the report language. */
+                lang?: "es" | "en";
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description PDF file */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/pdf": string;
+                };
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1FoldersController_getFolderMetrics: {
+        parameters: {
+            query?: {
+                /** @description Period in days: 7, 30 or 90, or 0 for the whole history. Defaults to 30. */
+                days?: 0 | 7 | 30 | 90;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Folder tool metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1FoldersController_getFolderCsv: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description CSV file */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/csv": string;
+                };
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1FoldersController_moveFolder: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveFolderBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Folder moved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description A folder cannot move into itself or one of its subfolders */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
+                };
+            };
+            /** @description Folder not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1ToolsController_listTools: {
+        parameters: {
+            query?: {
+                /** @description `level` (default) lists one folder level; `company` is a flat list of every tool of the company. */
+                scope?: "level" | "company";
+                /** @description Comma separated tool types: woku, nps, csat, ces. */
+                types?: string[];
+                /** @description Case and accent insensitive search over names and questions. A search is company-wide and also matches folder names. */
+                q?: string;
+                sort?: "name" | "-name" | "created" | "-created";
+                /** @description Opaque `nextCursor` of the previous page. */
+                cursor?: string;
+                limit?: number;
+                /** @description Folders per page ("see more"). Omitted returns every folder of the level. */
+                foldersLimit?: number;
+                /** @description Opaque `foldersNextCursor` of a previous page. Returns only that page of folders, without tools. */
+                foldersCursor?: string;
+                /** @description Only tools created on or after this date (ISO 8601). */
+                createdFrom?: string;
+                /** @description Only tools created on or before this date (ISO 8601). */
+                createdTo?: string;
+                /** @description Tracker chips as `name:value`, repeatable (`?trackers=TRR:00482&trackers=OC:2024`, up to 10). A tool matches when it has every one: the tracker name is matched exactly, the value partially and ignoring case (`482` also matches `00482`). Like a search, it is company-wide and lists no folders. A chip without name or value is a 400. */
+                trackers?: string[];
+                /** @description Folder whose direct content is listed. Omit for the root. Ignored when `scope=company` or when searching. */
+                folderId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Folders, tools and facets */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1ToolsController_getToolsStats: {
+        parameters: {
+            query?: {
+                /** @description Scope the figures to this folder and its subfolders. Omit for the whole company. */
+                folderId?: string;
+                /** @description Only responses on or after this date (ISO 8601). */
+                from?: string;
+                /** @description Only responses on or before this date (ISO 8601). */
+                to?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Figures per type */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1ToolsController_moveTools: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveToolItemsBodyDTO"];
+            };
+        };
+        responses: {
+            /** @description Items moved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid move (for example a folder into its own subtree) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseDto"];
+                };
+            };
+            /** @description Folder or item not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1JourneyFoldersController_getJourneyFolders: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    V1JourneyFoldersController_organizeJourneyFolders: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Organization started */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Already organizing */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    CustomJourneyEntryController_info: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                journeyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyEntryInfoDto"];
+                };
+            };
+            /** @description Invalid contact, case reference or request ID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description This evaluation is not available */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    CustomJourneyEntryController_prepare: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                journeyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PrepareJourneyEntryDto"];
+            };
+        };
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreparedJourneyEntryDto"];
+                };
+            };
+            /** @description Invalid contact, case reference or request ID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description This evaluation is not available */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Customer or case already has an active evaluation */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Preparation is still in progress; retry with the same requestId */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+}
+
+/** The full generated schema map (advanced use / escape hatch). */
+type Schemas = components['schemas'];
+type CreateTrackerParams = Schemas['CreateExternalTrackerDefinitionDTO'];
+type UpdateTrackerParams = Schemas['UpdateExternalTrackerDefinitionDTO'];
+type SearchEntitiesByTrackersParams = Schemas['SearchEntitiesByTrackersDTO'];
+type AssignTrackerByNameParams = Schemas['AssignExternalTrackerByNameDTO'];
+type CreateFlowParams = Schemas['CreateFlowBodyDTO'];
+type UpdateFlowParams = Schemas['UpdateFlowBodyDTO'];
+type CreateFolderParams = Schemas['CreateFolderBodyDTO'];
+type UpdateFolderParams = Schemas['UpdateFolderBodyDTO'];
+type MoveToolItemsParams = Schemas['MoveToolItemsBodyDTO'];
+type CreateNpsToolParams = Schemas['CreateNpsToolBodyDTO'];
+type UpdateNpsToolParams = Schemas['UpdateNpsToolBodyDTO'];
+type CreateCsatToolParams = Schemas['CreateCsatToolBodyDTO'];
+type UpdateCsatToolParams = Schemas['UpdateCsatToolBodyDTO'];
+type CreateCesToolParams = Schemas['CreateCesToolBodyDTO'];
+type UpdateCesToolParams = Schemas['UpdateCesToolBodyDTO'];
+type SendInvitationsParams = Schemas['V1CreateInvitationsBodyDto'];
 type SendNpsInvitationsParams = Schemas['V1CreateNpsInvitationsBodyDto'];
 type SendCsatInvitationsParams = Schemas['V1CreateCsatInvitationsBodyDto'];
 type SendCesInvitationsParams = Schemas['V1CreateCesInvitationsBodyDto'];
@@ -5937,6 +7000,22 @@ type ShareWokuParams = Schemas['V1ShareWokuBodyDto'];
 type UpdateTicketParams = Schemas['UpdateTicketBodyDTO'];
 type CreateTicketDestinationParams = Schemas['V1CreateTicketDestinationDto'];
 type UpdateTicketDestinationParams = Schemas['V1UpdateTicketDestinationDto'];
+/** Explicit receiver contract for updating the original custom support case. */
+type CustomTicketUpdateConfig = {
+    mode: 'upsert';
+    responseIdPath?: string;
+} | {
+    mode: 'remote-id';
+    url: string;
+    method?: 'PUT' | 'PATCH';
+    responseIdPath: string;
+};
+type CustomTicketDestinationConfig = {
+    url: string;
+    method?: 'POST' | 'PUT';
+    headers?: Record<string, string>;
+    update?: CustomTicketUpdateConfig;
+};
 type CreateActionPlanGroupParams = Schemas['CreateActionPlanGroupDto'];
 type UpdateActionPlanGroupParams = Schemas['UpdateActionPlanGroupDto'];
 type CreateActionPlanTaskParams = Schemas['CreateActionPlanTaskDto'];
@@ -5992,6 +7071,8 @@ interface ToolLocalizedContent {
 /** NPS tool definition (curated, no internal fields). */
 interface NpsTool {
     _id: string;
+    /** Folder the tool lives in, `null` at the root. */
+    folderId?: string | null;
     name: string;
     npsMessage: string;
     audienceType?: string;
@@ -6003,6 +7084,8 @@ interface NpsTool {
 /** CSAT tool definition (curated). */
 interface CsatTool {
     _id: string;
+    /** Folder the tool lives in, `null` at the root. */
+    folderId?: string | null;
     name: string;
     question: string;
     subject?: string;
@@ -6014,6 +7097,8 @@ interface CsatTool {
 /** CES tool definition (curated). */
 interface CesTool {
     _id: string;
+    /** Folder the tool lives in, `null` at the root. */
+    folderId?: string | null;
     name: string;
     question: string;
     action?: string;
@@ -6037,6 +7122,114 @@ interface InvitationsResult {
     }>;
     [key: string]: unknown;
 }
+type FollowUpState = 'pending' | 'initial_sent' | 'awaiting_detail' | 'closing' | 'completed' | 'timed_out' | 'cancelled';
+interface FollowUpOrigin {
+    tool: 'woku' | 'nps' | 'csat' | 'ces';
+    refId: string;
+    instrumentId?: string;
+}
+/** Lightweight evidence state. Completion alone does not mean evidence was applied. */
+interface FollowUp {
+    conversationId?: string;
+    state: FollowUpState | 'not_applicable';
+    reason?: string;
+    availableSummaryVersion?: number;
+    appliedSummaryVersion?: number;
+    enrichedAt?: string;
+    /** Ticket processing status; conversation completion does not imply application. */
+    enrichmentState?: 'processing' | 'applied' | 'failed' | 'skipped';
+    enrichmentReason?: string;
+}
+/**
+ * WhatsApp line of a follow-up. `survey_thread`: the agent continued the
+ * survey conversation on the survey number. `follow_up_number`: it wrote from
+ * the dedicated follow-up number. Absent for email.
+ */
+type FollowUpLine = 'survey_thread' | 'follow_up_number';
+/**
+ * `survey`: the survey exchange that preceded the follow-up (prelude).
+ * `follow_up`: the follow-up itself.
+ */
+type FollowUpMessagePhase = 'survey' | 'follow_up';
+/**
+ * A file the customer sent. `adminUrl` opens it in the woku admin after login
+ * and a company check; the file itself and storage URLs are never returned.
+ */
+interface FollowUpAttachment {
+    /** Stable number of the file in the conversation (prelude included). */
+    index: number;
+    /** Label in the conversation language, e.g. "Archivo 2" or "File 2". */
+    label: string;
+    kind: 'image' | 'audio' | 'document' | 'unsupported';
+    /** Private original file. Absent while pending or when nothing was stored. */
+    fileId?: string;
+    /** Converted copy the model read, when there was a conversion. */
+    readableFileId?: string;
+    filename: string;
+    mimeType: string;
+    status: 'pending' | 'ready' | 'failed' | 'unsupported';
+    /** Transcript (audio) or description (image, document). Untrusted customer content. */
+    text?: string;
+    /** Stable reason code when failed or unsupported (e.g. `video`, `read_failed`). */
+    failureReason?: string;
+    adminUrl?: string;
+}
+/** A file the executive summary cites as "(Archivo N)". */
+interface FollowUpCitation {
+    index: number;
+    label: string;
+    fileId?: string;
+    /** What the file supports in the summary. */
+    supports: string;
+    adminUrl?: string;
+}
+interface FollowUpMessage {
+    role: 'agent' | 'client';
+    /** May be empty when the message only has files. */
+    content: string;
+    timestamp: string;
+    phase: FollowUpMessagePhase;
+    responseType?: string;
+    selectedOption?: string;
+    attachments?: FollowUpAttachment[];
+}
+/** Authorized conversation detail, without response tokens or transport credentials. */
+interface FollowUpConversation {
+    _id: string;
+    companyId: string;
+    origin: FollowUpOrigin;
+    wokuId?: string;
+    reviewId?: string;
+    reviewType: 'textnote' | 'voicemail';
+    originalReview: string;
+    originalQualification?: number;
+    state: FollowUpState;
+    channel: Channel;
+    line?: FollowUpLine;
+    reason?: string;
+    messages: FollowUpMessage[];
+    executiveSummary?: string;
+    actionItems?: string[];
+    sentiment?: string;
+    topics?: string[];
+    summaryCitations?: FollowUpCitation[];
+    summaryVersion?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface TicketOriginTracker {
+    trackerId?: string;
+    name?: string;
+    value: string;
+}
+interface TicketOrigin {
+    tool: FollowUpOrigin['tool'] | 'form';
+    refId: string;
+    instrumentId?: string;
+    instrumentName?: string;
+    trackers?: TicketOriginTracker[];
+    [key: string]: unknown;
+}
 /** Support ticket (curated allow-list). */
 interface Ticket {
     _id: string;
@@ -6044,7 +7237,9 @@ interface Ticket {
     title: string;
     severity: Severity;
     destinationId?: string;
-    origin?: WokuRecord;
+    origin?: TicketOrigin;
+    followUp?: FollowUp;
+    contentVersion?: number;
     score?: WokuRecord;
     aiSummary?: string;
     aiCategory?: string;
@@ -6130,6 +7325,183 @@ interface ApiKeyResult {
     secretKey: string;
     [key: string]: unknown;
 }
+/** Kinds of item the Tools view mixes. */
+type ToolType = 'woku' | 'nps' | 'csat' | 'ces';
+/** Headline figure of a tool, always in its native scale (scales are never mixed). */
+interface ToolHeadline {
+    kind: 'stars' | 'nps' | 'csat' | 'ces';
+    /** Stars 1-5, NPS -100..100, CSAT satisfied %, CES mean 1-5. `null` without responses. */
+    value: number | null;
+    scale: string;
+}
+/** A woku, NPS, CSAT or CES tool as listed by `tools.list`. */
+interface ToolItem {
+    type: ToolType;
+    id: string;
+    name: string;
+    folderId: string | null;
+    createdAt: string | null;
+    reviewCount: number;
+    lastResponseAt: string | null;
+    headline: ToolHeadline;
+}
+/** Subtree figures of a folder. */
+interface FolderStats {
+    toolCounts: Record<ToolType, number>;
+    subfolderCount: number;
+    reviewCount: number;
+}
+/**
+ * Kind of a system folder created by woku: the `Viajes` root, one journey, one
+ * journey moment or an integration (Shopify, Pancake). `null` for your own folders.
+ */
+type FolderOrigin = 'journeys-root' | 'journey' | 'journey-moment' | 'integration';
+/** A WhatsApp number that receives improvement alerts of a folder. */
+interface WhatsappAlertRecipient {
+    /** E.164 phone number without the leading +. */
+    whatsappId: string;
+    name: string;
+    /** Kinds of comment that alert this number (numbers created before this feature only get `woku`). */
+    sources: ToolType[];
+}
+/** A folder with its breadcrumb path and subtree stats. */
+interface Folder {
+    id: string;
+    name: string;
+    color: string | null;
+    parentFolderId: string | null;
+    /** Breadcrumb from the root, for example `Journeys > Post-sale`. */
+    path: string;
+    /** System folder kind, `null` for a folder you created. */
+    origin: FolderOrigin | null;
+    /** Provider of an integration folder (`shopify`, `pancake`), otherwise `null`. */
+    integrationProvider?: string | null;
+    /** WhatsApp numbers alerted when a comment of any tool in the folder is an improvement. */
+    whatsappAlertRecipients: WhatsappAlertRecipient[];
+    createdAt: string | null;
+    stats: FolderStats;
+}
+/** One page of `tools.list`: folders, tools, facet counts and the cursor. */
+interface ToolItemsPageResponse {
+    folders: Folder[];
+    /** Cursor of the next page of folders; null when they were all returned. */
+    foldersNextCursor: string | null;
+    tools: ToolItem[];
+    nextCursor: string | null;
+    facets: {
+        types: Record<ToolType, number>;
+    };
+}
+/** Headline figures of one tool type for the company or a folder. */
+interface ToolTypeStats {
+    toolCount: number;
+    reviewCount: number;
+    headline: ToolHeadline;
+    lastResponseAt: string | null;
+    /** NPS only. */
+    distribution?: {
+        promoters: number;
+        passives: number;
+        detractors: number;
+    };
+}
+/** A type that failed to compute reports `{ error: true }`; the others stay valid. */
+type ToolsStats = Record<ToolType, ToolTypeStats | {
+    error: true;
+}>;
+/** One window (the period, or the one before it) of one tool. */
+interface ToolWindow {
+    count: number;
+    headline: ToolHeadline;
+    /** Share (0-100) of positive responses: 4-5, or NPS promoters; `null` with no responses. */
+    positive: number | null;
+    /** Share (0-100) of negative responses: 1-2, or NPS detractors; `null` with no responses. */
+    negative: number | null;
+    /** The raw counts and score sum behind the shares, to combine tools without rounding drift. */
+    positiveCount: number;
+    negativeCount: number;
+    scoreSum: number;
+}
+/** Per-tool figures of `folders.metrics`: the period against the one before it. */
+interface ToolMetrics {
+    type: ToolType;
+    id: string;
+    name: string;
+    /** Responses ever received. */
+    totalResponses: number;
+    lastResponseAt: string | null;
+    current: ToolWindow;
+    previous: ToolWindow;
+}
+/** Sums of one day (UTC) and tool type, enough to rebuild any score on any bucket. */
+interface DailyPoint {
+    date: string;
+    type: ToolType;
+    count: number;
+    scoreSum: number;
+    positive: number;
+    negative: number;
+}
+/** Result of `folders.metrics`. */
+interface FolderToolMetrics {
+    /** Period in days; `0` is the whole history (then every `previous` window is empty). */
+    days: number;
+    tools: ToolMetrics[];
+    /** Daily sums of both windows (2 x `days`). */
+    daily: DailyPoint[];
+    /** Responses per score in the period: 0-10 for NPS, 1-5 for the rest. */
+    distribution: Record<ToolType, number[]>;
+}
+/** Result of `tools.move` and `folders.move` batches. */
+interface MoveResult {
+    moved: number;
+    folderId: string | null;
+    items: {
+        type: ToolType | 'folder';
+        id: string;
+    }[];
+}
+/** The CSV of a folder: the raw text, one row per response. */
+type FolderCsv = string;
+/** Whether the company keeps its journeys in folders (`Viajes > journey > moment`). */
+interface JourneyFoldersStatus {
+    enabled: boolean;
+    enabledAt: string | null;
+    organizedAt: string | null;
+    /** True while the one-off organization is running in the background. */
+    organizing: boolean;
+    /** Journeys and tools still without a folder. */
+    pending: {
+        journeys: number;
+        tools: number;
+    };
+}
+/** One step of a flow: the tool the respondent answers at that point. */
+interface FlowStep {
+    type: ToolType;
+    /** Tool id. For an `nps` step, your company id means the company-level NPS. */
+    toolId: string;
+}
+/** A survey flow: an ordered sequence of woku, NPS, CSAT and CES steps. */
+interface Flow {
+    _id: string;
+    name: string;
+    /** Ordered steps. Flows live outside folders. */
+    steps: FlowStep[];
+    /** Woku ids of the `woku` steps, in order (kept for compatibility). */
+    wokusIds?: string[];
+    npsToolId?: string | null;
+    companyIdNps?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
+
+/** Read authorized follow-up conversations with a company management secret. */
+declare class FollowUps {
+    private readonly client;
+    constructor(client: WokuClient);
+    get(id: string, opts?: RequestOptions): Promise<FollowUpConversation>;
+}
 
 /** A VoC entity type that can carry tracker values. */
 type TrackerEntityType = 'nps' | 'csat' | 'ces' | 'form' | 'flow';
@@ -6190,6 +7562,10 @@ declare class NpsTools {
     create(body: CreateNpsToolParams, opts?: RequestOptions): Promise<NpsTool>;
     get(id: string, opts?: RequestOptions): Promise<NpsTool>;
     update(id: string, body: UpdateNpsToolParams, opts?: RequestOptions): Promise<NpsTool>;
+    /** Move the tool into a folder, or to the root with `folderId: null`. */
+    move(id: string, body: {
+        folderId: string | null;
+    }, opts?: RequestOptions): Promise<NpsTool>;
     delete(id: string, opts?: RequestOptions): Promise<DeletedResult>;
 }
 /** Manage CSAT tool definitions (`/v1/csat-tools`). */
@@ -6203,6 +7579,10 @@ declare class CsatTools {
     create(body: CreateCsatToolParams, opts?: RequestOptions): Promise<CsatTool>;
     get(id: string, opts?: RequestOptions): Promise<CsatTool>;
     update(id: string, body: UpdateCsatToolParams, opts?: RequestOptions): Promise<CsatTool>;
+    /** Move the tool into a folder, or to the root with `folderId: null`. */
+    move(id: string, body: {
+        folderId: string | null;
+    }, opts?: RequestOptions): Promise<CsatTool>;
     delete(id: string, opts?: RequestOptions): Promise<DeletedResult>;
 }
 /** Manage CES tool definitions (`/v1/ces-tools`). */
@@ -6216,6 +7596,10 @@ declare class CesTools {
     create(body: CreateCesToolParams, opts?: RequestOptions): Promise<CesTool>;
     get(id: string, opts?: RequestOptions): Promise<CesTool>;
     update(id: string, body: UpdateCesToolParams, opts?: RequestOptions): Promise<CesTool>;
+    /** Move the tool into a folder, or to the root with `folderId: null`. */
+    move(id: string, body: {
+        folderId: string | null;
+    }, opts?: RequestOptions): Promise<CesTool>;
     delete(id: string, opts?: RequestOptions): Promise<DeletedResult>;
 }
 
@@ -6298,15 +7682,29 @@ declare class Forms {
     sendInvitations(id: string, body: SendInvitationsParams, opts?: RequestOptions): Promise<InvitationsResult>;
 }
 
-/** Read data flows (`/v1/flows`). */
+/**
+ * Survey flows (`/v1/flows`): an ordered sequence of steps, each a woku or an
+ * NPS, CSAT or CES tool, that a respondent answers one after the other.
+ */
 declare class Flows {
     private readonly client;
     constructor(client: WokuClient);
+    /** List the flows of the company, with their ordered `steps`. */
     list(params?: {
         page?: number;
         limit?: number;
-    }, opts?: RequestOptions): Promise<Page<WokuRecord>>;
+    }, opts?: RequestOptions): Promise<Page<Flow>>;
+    /** The data of a flow: ordered steps with their tools, wokus and branding. */
     get(id: string, opts?: RequestOptions): Promise<WokuRecord>;
+    /**
+     * Create a flow from 1 to 20 ordered steps (each tool once, all of your
+     * company). Flows live outside folders.
+     */
+    create(body: CreateFlowParams, opts?: RequestOptions): Promise<Flow>;
+    /** Rename a flow or replace its full ordered list of steps. */
+    update(id: string, body: UpdateFlowParams, opts?: RequestOptions): Promise<Flow>;
+    /** Delete a flow. Its tools and their responses stay. */
+    delete(id: string, opts?: RequestOptions): Promise<DeletedResult>;
 }
 
 interface ListActionPlansParams {
@@ -6461,7 +7859,16 @@ type JourneyMomentPreview = Schemas['V1JourneyPreviewResponseDto'];
 type JourneyMomentTrigger = Schemas['V1JourneyTriggerDto'];
 type JourneyMoment = Schemas['V1JourneyMomentDto'];
 type JourneyInput = Schemas['V1UpdateJourneyBodyDto'];
-type Journey = Schemas['V1JourneyResponseDto'];
+/**
+ * A journey as returned by `/v1/journeys`. `folderId` and `momentFolders`
+ * (moment key to folder id) point at the folders that hold the journey's tools
+ * once the company organized its journeys in folders; they are `null` and `{}`
+ * before that. Reads only: they are not part of the journey definition.
+ */
+type Journey = Schemas['V1JourneyResponseDto'] & {
+    folderId?: string | null;
+    momentFolders?: Record<string, string>;
+};
 type CreatedJourney = Schemas['V1CreatedJourneyResponseDto'];
 type JourneyEnrollment = Schemas['V1JourneyParticipationDto'];
 type JourneyEnrollmentPage = Schemas['V1JourneyParticipationPageDto'];
@@ -6553,6 +7960,165 @@ declare class Quarantines {
     }, opts?: RequestOptions): Promise<WokuRecord>;
 }
 
+/**
+ * Folders that organize wokus and NPS, CSAT and CES tools (`/v1/folders`).
+ * To list what a folder contains use `woku.tools.list({ folderId })`.
+ */
+declare class Folders {
+    private readonly client;
+    constructor(client: WokuClient);
+    /** Every folder of the company, or the direct subfolders of `parentFolderId`. */
+    list(params?: {
+        parentFolderId?: string;
+        q?: string;
+    }, opts?: RequestOptions): Promise<Folder[]>;
+    get(id: string, opts?: RequestOptions): Promise<Folder>;
+    create(body: CreateFolderParams, opts?: RequestOptions): Promise<Folder>;
+    /**
+     * Rename or recolor a folder (`color: null` clears the color) and/or replace
+     * its WhatsApp alert recipients (`whatsappAlertRecipients`, `[]` clears them).
+     */
+    update(id: string, body: UpdateFolderParams, opts?: RequestOptions): Promise<Folder>;
+    /**
+     * Move a folder under another folder, or to the root with
+     * `parentFolderId: null`. A folder cannot move into its own subtree.
+     */
+    move(id: string, body: {
+        parentFolderId: string | null;
+    }, opts?: RequestOptions): Promise<Folder>;
+    /**
+     * Delete a folder. Nothing inside is deleted: subfolders, wokus and tools
+     * move up to the parent folder (or the root).
+     */
+    delete(id: string, opts?: RequestOptions): Promise<DeletedResult>;
+    /**
+     * AI report over every woku, NPS, CSAT and CES tool of the folder and its
+     * subfolders. Scales differ per type, so there is no rating distribution.
+     */
+    report(id: string, params?: {
+        regenerate?: boolean;
+        lang?: 'es' | 'en';
+    }, opts?: RequestOptions): Promise<WokuRecord>;
+    /**
+     * Per-tool figures of the woku, NPS, CSAT and CES tools of the folder and its
+     * subfolders for a period against the one before it, with the daily sums and
+     * the histogram of scores. `days` is 7, 30 (default) or 90, or 0 for the whole
+     * history (every `previous` window is then empty). The period is the last
+     * `days` calendar days in UTC, today included. Scales are never mixed across
+     * types.
+     */
+    metrics(id: string, params?: {
+        days?: 0 | 7 | 30 | 90;
+    }, opts?: RequestOptions): Promise<FolderToolMetrics>;
+    /** CSV text with one row per response of every tool of the folder subtree. */
+    csv(id: string, opts?: RequestOptions): Promise<FolderCsv>;
+    /**
+     * PDF of the folder report (every woku, NPS, CSAT and CES tool of the folder
+     * and its subfolders) with a breakdown per type on each native scale.
+     * Returns the file bytes: write them to disk or send them as is.
+     */
+    pdf(id: string, params?: {
+        lang?: 'es' | 'en';
+    }, opts?: RequestOptions): Promise<Uint8Array>;
+}
+
+/** Filters of `tools.list`. */
+interface ListToolsParams {
+    /** Folder whose direct content is listed. Omit for the root. */
+    folderId?: string;
+    /** `level` (default) lists one folder level; `company` lists every tool flat. */
+    scope?: 'level' | 'company';
+    /** Only these tool types. */
+    types?: ToolType[];
+    /** Case and accent insensitive search (company-wide, also matches folders). */
+    q?: string;
+    sort?: 'name' | '-name' | 'created' | '-created';
+    /** Page size, 1-100 (default 50). */
+    limit?: number;
+    /** Folders per page, 1-100 (omit to receive every folder of the level). */
+    foldersLimit?: number;
+    createdFrom?: string;
+    createdTo?: string;
+    /**
+     * Tracker chips as `name:value` (for example `TRR:00482`, up to 10); a tool
+     * matches when it has every one: the tracker name is matched exactly, the value
+     * partially and ignoring case (`482` also matches `00482`). Like a search it is
+     * company-wide and lists no folders. A chip without name or value is a 400.
+     */
+    trackers?: string[];
+}
+/**
+ * One page of `tools.list`. Iterate every tool across all pages with
+ * `for await (const tool of page)`, or page by page with `page.iterPages()`.
+ */
+declare class ToolsPage implements AsyncIterable<ToolItem> {
+    private readonly fetchNext;
+    private readonly fetchMoreFolders;
+    readonly folders: Folder[];
+    readonly tools: ToolItem[];
+    readonly nextCursor: string | null;
+    /** Cursor of the next page of folders (only set when `foldersLimit` was used). */
+    readonly foldersNextCursor: string | null;
+    readonly facets: ToolItemsPageResponse['facets'];
+    constructor(response: ToolItemsPageResponse, fetchNext: (cursor: string) => Promise<ToolsPage>, fetchMoreFolders?: (cursor: string) => Promise<ToolsPage>);
+    hasMoreFolders(): boolean;
+    /** The next page of folders ("see more"): a page with those folders and no tools. */
+    getMoreFolders(): Promise<ToolsPage>;
+    hasNextPage(): boolean;
+    getNextPage(): Promise<ToolsPage>;
+    iterPages(): AsyncGenerator<ToolsPage>;
+    [Symbol.asyncIterator](): AsyncIterator<ToolItem>;
+}
+/**
+ * The unified view over wokus and NPS, CSAT and CES tools (`/v1/tools`):
+ * search and filters, headline figures per type and batch moves.
+ */
+declare class Tools {
+    private readonly client;
+    constructor(client: WokuClient);
+    /**
+     * List one folder level (or search the company). Folders and tools of every
+     * type come together; the first page also carries the folders and facets.
+     */
+    list(params?: ListToolsParams, opts?: RequestOptions): Promise<ToolsPage>;
+    /**
+     * Headline figures per type (woku stars, NPS score, CSAT satisfied %, CES
+     * mean) for the company or one folder and its subfolders, in a period.
+     * A type that fails reports `{ error: true }`; the others stay valid.
+     */
+    stats(params?: {
+        folderId?: string;
+        from?: string;
+        to?: string;
+    }, opts?: RequestOptions): Promise<ToolsStats>;
+    /**
+     * Move up to 200 items of mixed types (`woku`, `nps`, `csat`, `ces`,
+     * `folder`) into a folder, or to the root with `folderId: null`. Idempotent;
+     * nothing moves if one item or the destination is not found.
+     */
+    move(body: MoveToolItemsParams, opts?: RequestOptions): Promise<MoveResult>;
+}
+
+/**
+ * Keep customer journeys in folders (`/v1/journey-folders`): `Viajes > journey >
+ * moment`. Each journey and moment exposes its folder in `journeys.get`
+ * (`folderId`, `momentFolders`).
+ */
+declare class JourneyFolders {
+    private readonly client;
+    constructor(client: WokuClient);
+    /** Whether the organization is on, running, and how much is still without a folder. */
+    status(opts?: RequestOptions): Promise<JourneyFoldersStatus>;
+    /**
+     * Switch the organization on and run the one-off pass in the background: tools
+     * of existing journeys without a folder move into their moment folder, and
+     * tools journeys create from now on are placed there. Tools that already have
+     * a folder are never touched. Rejects with a conflict (409) while a pass is
+     * already running; poll {@link status} for progress.
+     */
+    organize(opts?: RequestOptions): Promise<JourneyFoldersStatus>;
+}
+
 /**
  * Entry point to the Woku management API.
  *
@@ -6581,6 +8147,7 @@ declare class Woku {
     readonly actionPlans: ActionPlans;
     readonly actionPlanGroups: ActionPlanGroups;
     readonly tickets: Tickets;
+    readonly followUps: FollowUps;
     readonly ticketDestinations: TicketDestinations;
     readonly dispatches: Dispatches;
     readonly reports: Reports;
@@ -6588,6 +8155,12 @@ declare class Woku {
     /** Customer journeys: moments, their tools and how each one starts. */
     readonly journeys: Journeys;
     readonly quarantines: Quarantines;
+    /** Folders that organize wokus and NPS, CSAT and CES tools. */
+    readonly folders: Folders;
+    /** Unified search, headline figures and batch moves across every tool type. */
+    readonly tools: Tools;
+    /** Keep journeys and their moments in folders (`Viajes > journey > moment`). */
+    readonly journeyFolders: JourneyFolders;
     constructor(options?: WokuClientOptions | string);
 }
 
@@ -6687,4 +8260,4 @@ declare class InternalServerError extends WokuAPIError {
     constructor(...args: ConstructorParameters<typeof WokuAPIError>);
 }
 
-export { type ApiKeyResult, type AssignTrackerByNameParams, AuthenticationError, BadRequestError, type CesTool, type Channel, ConflictError, type CreateActionPlanGroupParams, type CreateActionPlanTaskParams, type CreateCesToolParams, type CreateCsatToolParams, type CreateNpsToolParams, type CreateTicketDestinationParams, type CreateTrackerParams, type CreateWokuParams, type CreatedJourney, type CsatTool, type DeletedResult, type Dispatch, type DispatchStats, type EnrollInput, type EntitiesByTrackers, type FeedbackType, type FetchLike, InternalServerError, type InvitationsResult, type Journey, type JourneyConnection, type JourneyEnrollment, type JourneyEnrollmentPage, type JourneyEntryInfo, type JourneyEventInput, type JourneyInput, type JourneyMoment, type JourneyMomentPreview, type JourneyMomentTrigger, type JourneyRecipients, type JourneySendWindow, type JourneyStartMode, type JourneyWebhook, Journeys, type ListJourneyEnrollmentsParams, type Locale, Media, type MediaUploadParams, type MediaUploadResult, type MoveWokuParams, NotFoundError, type NpsTool, Page, type PageResponse, PayloadTooLargeError, PermissionDeniedError, type PostPlanReplyParams, type PrepareJourneyEntryInput, type PreparedJourneyEntry, RateLimitError, type ReorderActionPlanTasksParams, type RequestOptions, type Schemas, type SearchEntitiesByTrackersParams, type SendCesInvitationsParams, type SendCsatInvitationsParams, type SendInvitationsParams, type SendNpsInvitationsParams, type Severity, type ShareWokuParams, type TestConnectionResult, type Ticket, type TicketStats, type Tracker, UnprocessableEntityError, type UpdateActionPlanGroupParams, type UpdateActionPlanTaskParams, type UpdateCesToolParams, type UpdateCsatToolParams, type UpdateNpsToolParams, type UpdateTicketDestinationParams, type UpdateTicketParams, type UpdateTrackerParams, type UpdateWokuParams, type UpdateWokuSettingsParams, Woku, WokuAPIError, WokuClient, type WokuClientOptions, WokuConnectionError, WokuError, type WokuErrorBody, type WokuRecord, type WokuResource, WokuTimeoutError };
+export { type ApiKeyResult, type AssignTrackerByNameParams, AuthenticationError, BadRequestError, type CesTool, type Channel, ConflictError, type CreateActionPlanGroupParams, type CreateActionPlanTaskParams, type CreateCesToolParams, type CreateCsatToolParams, type CreateFlowParams, type CreateFolderParams, type CreateNpsToolParams, type CreateTicketDestinationParams, type CreateTrackerParams, type CreateWokuParams, type CreatedJourney, type CsatTool, type CustomTicketDestinationConfig, type CustomTicketUpdateConfig, type DailyPoint, type DeletedResult, type Dispatch, type DispatchStats, type EnrollInput, type EntitiesByTrackers, type FeedbackType, type FetchLike, type Flow, type FlowStep, type Folder, type FolderCsv, type FolderOrigin, type FolderStats, type FolderToolMetrics, Folders, type FollowUp, type FollowUpAttachment, type FollowUpCitation, type FollowUpConversation, type FollowUpLine, type FollowUpMessage, type FollowUpMessagePhase, type FollowUpOrigin, type FollowUpState, FollowUps, InternalServerError, type InvitationsResult, type Journey, type JourneyConnection, type JourneyEnrollment, type JourneyEnrollmentPage, type JourneyEntryInfo, type JourneyEventInput, JourneyFolders, type JourneyFoldersStatus, type JourneyInput, type JourneyMoment, type JourneyMomentPreview, type JourneyMomentTrigger, type JourneyRecipients, type JourneySendWindow, type JourneyStartMode, type JourneyWebhook, Journeys, type ListJourneyEnrollmentsParams, type ListToolsParams, type Locale, Media, type MediaUploadParams, type MediaUploadResult, type MoveResult, type MoveToolItemsParams, type MoveWokuParams, NotFoundError, type NpsTool, Page, type PageResponse, PayloadTooLargeError, PermissionDeniedError, type PostPlanReplyParams, type PrepareJourneyEntryInput, type PreparedJourneyEntry, RateLimitError, type ReorderActionPlanTasksParams, type RequestOptions, type Schemas, type SearchEntitiesByTrackersParams, type SendCesInvitationsParams, type SendCsatInvitationsParams, type SendInvitationsParams, type SendNpsInvitationsParams, type Severity, type ShareWokuParams, type TestConnectionResult, type Ticket, type TicketOrigin, type TicketOriginTracker, type TicketStats, type ToolHeadline, type ToolItem, type ToolItemsPageResponse, type ToolMetrics, type ToolType, type ToolTypeStats, type ToolWindow, Tools, ToolsPage, type ToolsStats, type Tracker, UnprocessableEntityError, type UpdateActionPlanGroupParams, type UpdateActionPlanTaskParams, type UpdateCesToolParams, type UpdateCsatToolParams, type UpdateFlowParams, type UpdateFolderParams, type UpdateNpsToolParams, type UpdateTicketDestinationParams, type UpdateTicketParams, type UpdateTrackerParams, type UpdateWokuParams, type UpdateWokuSettingsParams, type WhatsappAlertRecipient, Woku, WokuAPIError, WokuClient, type WokuClientOptions, WokuConnectionError, WokuError, type WokuErrorBody, type WokuRecord, type WokuResource, WokuTimeoutError };