@trii/types 2.10.726 → 2.10.728

package/dist/src/Forms/API.d.ts

@@ -0,0 +1,53 @@
+import { FormItemType } from "../Common/Channels/Form";
+import { FormAnswerV2, FormTag } from "./SubmittedForm";
+export interface RequestInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    skip: number | null;
+    limit: number | null;
+}
+export interface SummaryInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    completedForms: number;
+    records: QuestionSummary[];
+}
+export interface QuestionSummary {
+    questionId: string;
+    question: string;
+    type: FormItemType;
+    fieldType: string;
+    count: number;
+    responses: ResponseSummary[];
+}
+export interface ResponseSummary {
+    count: number;
+    responseTitle: string;
+}
+export interface SubmittedFormsInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    completedForms: number;
+    records: SubmittedFormRecord[];
+}
+export interface SubmittedFormRecord {
+    id: string;
+    tags: FormTag[];
+    responses: SubmittedFormResponse[];
+    expireAt: Date | null;
+    createdAt: Date;
+    completedAt: Date | null;
+    contractVersion: number;
+    formRevision: number;
+}
+export interface SubmittedFormResponse {
+    type: FormItemType;
+    fieldType: string;
+    questionId: string;
+    question: string;
+    response: unknown | null;
+    answer?: FormAnswerV2 | null;
+}

package/dist/src/Forms/API.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/Forms/SubmittedForm.d.ts

@@ -0,0 +1,56 @@
+import { FormItemType } from "../Common/Channels/Form";
+export interface SubmittedForm {
+    id: string;
+    shardKey: string;
+    spaceId: string;
+    formId: string;
+    contractVersion: number;
+    formRevision: number;
+    schemaHash: string | null;
+    tags: FormTag[];
+    /** Compatibilidad con formularios V1. */
+    responses?: FormResponse[] | null;
+    answers: FormAnswerV2[];
+    createdAt: Date;
+    expireAt: Date | null;
+    completedAt: Date | null;
+}
+export interface FormTag {
+    name: string;
+    value: string;
+}
+export declare enum FormStatus {
+    pending = 0,
+    completed = 1,
+    expired = 2
+}
+export interface FormResponse {
+    questionId: string;
+    type: FormItemType;
+    response: unknown;
+}
+export interface FormAnswerV2 {
+    fieldId: string;
+    fieldType: string;
+    /** Snapshot útil para exportaciones históricas. */
+    fieldLabel: string | null;
+    textValue: string | null;
+    numericValue: number | null;
+    /** Formatos canónicos: yyyy-MM-dd y HH:mm:ss. */
+    dateValue: string | null;
+    timeValue: string | null;
+    selectedOptions: FormSelectedOption[] | null;
+    files: FormSubmittedFile[] | null;
+}
+export interface FormSelectedOption {
+    id: string;
+    /** Snapshot histórico de la etiqueta. */
+    label: string | null;
+}
+export interface FormSubmittedFile {
+    storageId: string;
+    fileName: string;
+    contentType: string | null;
+    sizeBytes: number;
+    url: string | null;
+}

package/dist/src/Forms/SubmittedForm.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormStatus = void 0;
+var FormStatus;
+(function (FormStatus) {
+    FormStatus[FormStatus["pending"] = 0] = "pending";
+    FormStatus[FormStatus["completed"] = 1] = "completed";
+    FormStatus[FormStatus["expired"] = 2] = "expired";
+})(FormStatus || (exports.FormStatus = FormStatus = {}));

package/dist/src/Forms/index.d.ts

@@ -0,0 +1,2 @@
+export * from './API';
+export * from './SubmittedForm';

package/dist/src/Forms/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./API"), exports);
+__exportStar(require("./SubmittedForm"), exports);

package/dist/src/Presence/AgentPause.d.ts

@@ -0,0 +1,24 @@
+export interface AgentPause {
+    id: string;
+    spaceId: string;
+    userId: string;
+    reason: PauseReason;
+    startedAt: Date;
+    startedByUserId?: string;
+    startedBy: PauseActorType;
+    endedAt?: Date;
+}
+export declare enum PauseReason {
+    LUNCH = 0,
+    RESTROOM = 1,
+    BREAK = 2,
+    MEETING = 3,
+    TRAINING = 4,
+    ADMINISTRATIVE_WORK = 5,
+    OTHER = 6
+}
+export declare enum PauseActorType {
+    AGENT = 0,
+    SUPERVISOR = 1,
+    SYSTEM = 2
+}

package/dist/src/Presence/AgentPause.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PauseActorType = exports.PauseReason = void 0;
+var PauseReason;
+(function (PauseReason) {
+    PauseReason[PauseReason["LUNCH"] = 0] = "LUNCH";
+    PauseReason[PauseReason["RESTROOM"] = 1] = "RESTROOM";
+    PauseReason[PauseReason["BREAK"] = 2] = "BREAK";
+    PauseReason[PauseReason["MEETING"] = 3] = "MEETING";
+    PauseReason[PauseReason["TRAINING"] = 4] = "TRAINING";
+    PauseReason[PauseReason["ADMINISTRATIVE_WORK"] = 5] = "ADMINISTRATIVE_WORK";
+    PauseReason[PauseReason["OTHER"] = 6] = "OTHER";
+})(PauseReason || (exports.PauseReason = PauseReason = {}));
+var PauseActorType;
+(function (PauseActorType) {
+    PauseActorType[PauseActorType["AGENT"] = 0] = "AGENT";
+    PauseActorType[PauseActorType["SUPERVISOR"] = 1] = "SUPERVISOR";
+    PauseActorType[PauseActorType["SYSTEM"] = 2] = "SYSTEM";
+})(PauseActorType || (exports.PauseActorType = PauseActorType = {}));

package/dist/src/Presence/QueueParticipation.d.ts

@@ -0,0 +1,17 @@
+import { ConversationQueueInfo } from "../Conversations/Queue";
+export interface QueueParticipation {
+    spaceId: string;
+    userId: string;
+    queueId: string;
+    authorized: boolean;
+    active: boolean;
+    updatedAt: Date;
+    updatedByUserId?: string;
+}
+export interface QueueParticipationDto {
+    queueId: string;
+    authorized: boolean;
+    active: boolean;
+    updatedAt: Date;
+    queue?: ConversationQueueInfo | null;
+}

package/dist/src/Presence/QueueParticipation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/Presence/QueueRoutingState.d.ts

@@ -0,0 +1,27 @@
+import { ConversationQueueInfo } from "../Conversations/Queue";
+export interface QueueRoutingState {
+    spaceId: string;
+    userId: string;
+    queueId: string;
+    isEligible: boolean;
+    presenceStatus: RoutingPresenceStatus;
+    activeJobCount: number;
+    maxCapacity?: number;
+    notRespondingDetectedAt?: Date;
+    updatedAt: Date;
+}
+export declare enum RoutingPresenceStatus {
+    IDLE = 0,
+    INTERACTING = 1,
+    BUSY = 2
+}
+export interface RoutingStateDto {
+    queueId: string;
+    queue?: ConversationQueueInfo | null;
+    isEligible: boolean;
+    presenceStatus?: RoutingPresenceStatus;
+    activeJobCount: number;
+    maxCapacity?: number | null;
+    notRespondingDetectedAt?: Date;
+    updatedAt?: Date;
+}

package/dist/src/Presence/QueueRoutingState.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoutingPresenceStatus = void 0;
+var RoutingPresenceStatus;
+(function (RoutingPresenceStatus) {
+    RoutingPresenceStatus[RoutingPresenceStatus["IDLE"] = 0] = "IDLE";
+    RoutingPresenceStatus[RoutingPresenceStatus["INTERACTING"] = 1] = "INTERACTING";
+    RoutingPresenceStatus[RoutingPresenceStatus["BUSY"] = 2] = "BUSY";
+})(RoutingPresenceStatus || (exports.RoutingPresenceStatus = RoutingPresenceStatus = {}));

package/dist/src/Presence/index.d.ts

@@ -0,0 +1,3 @@
+export * from './AgentPause';
+export * from './QueueParticipation';
+export * from './QueueRoutingState';

package/dist/src/Presence/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AgentPause"), exports);
+__exportStar(require("./QueueParticipation"), exports);
+__exportStar(require("./QueueRoutingState"), exports);

package/dist/src/PublicAPI/apiKey.d.ts

@@ -1,12 +1,101 @@
+export interface CreateApiKeyResponseDto {
+    apiKey: ApiKey;
+    /**
+     * Credential returned only once, immediately after creation.
+     * It cannot be retrieved again later.
+     */
+    credential: string;
+}
 export interface ApiKey {
     id: string;
     spaceId: string;
     name: string;
+    status: ApiKeyStatus;
     privileges: ApiPrivilege;
-    createdBy: Date;
+    security?: ApiKeySecurityPolicy;
+    /**
+     * Prefix used to identify the API key without exposing the secret.
+     */
+    keyPrefix: string;
+    createdBy: string;
     createdAt: Date;
+    updatedBy?: string;
+    updatedAt?: Date;
+    lastUsedAt?: Date;
+    lastUsedIp?: string;
 }
+export type ApiKeyStatus = "active" | "disabled" | "revoked";
 export interface ApiPrivilege {
-    Messages: boolean;
-    Contacts: boolean;
+    /** @deprecated Replaced by scopes. */
+    Messages?: boolean;
+    /** @deprecated Replaced by scopes. */
+    Contacts?: boolean;
+    /**
+     * Permissions granted to the API key.
+     *
+     * Examples:
+     * - contacts.read
+     * - contacts.write
+     * - messages.read
+     * - messages.send
+     */
+    scopes: ApiScope[];
+    /**
+     * Optional restrictions applied to this API key.
+     *
+     * Restrictions limit which resources can be accessed,
+     * independently of the granted scopes.
+     */
+    restrictions?: ApiResourceRestrictions;
+}
+export interface ApiKeySecurityPolicy {
+    /**
+   * Allowed IPv4/IPv6 addresses or CIDR ranges.
+   */
+    allowedIpAddresses?: string[];
+    /**
+    * Optional expiration date.
+    */
+    expiresAt?: Date;
+}
+export type ApiScope = (typeof API_SCOPES)[keyof typeof API_SCOPES];
+export declare const API_SCOPES: {
+    readonly CONTACTS_READ: "contacts.read";
+    readonly CONTACTS_WRITE: "contacts.write";
+    readonly COMPANIES_READ: "companies.read";
+    readonly COMPANIES_WRITE: "companies.write";
+    readonly CONVERSATIONS_READ: "conversations.read";
+    readonly CONVERSATIONS_WRITE: "conversations.write";
+    readonly MESSAGES_READ: "messages.read";
+    readonly MESSAGES_SEND: "messages.send";
+    readonly TICKETS_READ: "tickets.read";
+    readonly TICKETS_WRITE: "tickets.write";
+    readonly TASKS_READ: "tasks.read";
+    readonly TASKS_WRITE: "tasks.write";
+    readonly CALENDAR_READ: "calendar.read";
+    readonly CALENDAR_WRITE: "calendar.write";
+    readonly FILES_READ: "files.read";
+    readonly FILES_WRITE: "files.write";
+    readonly CALLS_READ: "calls.read";
+    readonly CALLS_MAKE: "calls.make";
+    readonly WEBHOOKS_READ: "webhooks.read";
+    readonly WEBHOOKS_WRITE: "webhooks.write";
+    readonly USERS_READ: "users.read";
+    readonly FLOWS_READ: "flows.read";
+    readonly FLOWS_EXECUTE: "flows.execute";
+    readonly REPORTS_READ: "reports.read";
+};
+export interface ApiResourceRestrictions {
+    /**
+     * Restrict access to specific communication channels.
+     */
+    channelIds?: string[];
+    /**
+     * Restrict access to specific teams/groups.
+     */
+    teamIds?: string[];
+    /**
+     * Restrict access to specific users/agents.
+     */
+    userIds?: string[];
 }

package/dist/src/PublicAPI/apiKey.js

@@ -1,2 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_SCOPES = void 0;
+exports.API_SCOPES = {
+    CONTACTS_READ: "contacts.read",
+    CONTACTS_WRITE: "contacts.write",
+    COMPANIES_READ: "companies.read",
+    COMPANIES_WRITE: "companies.write",
+    CONVERSATIONS_READ: "conversations.read",
+    CONVERSATIONS_WRITE: "conversations.write",
+    MESSAGES_READ: "messages.read",
+    MESSAGES_SEND: "messages.send",
+    TICKETS_READ: "tickets.read",
+    TICKETS_WRITE: "tickets.write",
+    TASKS_READ: "tasks.read",
+    TASKS_WRITE: "tasks.write",
+    CALENDAR_READ: "calendar.read",
+    CALENDAR_WRITE: "calendar.write",
+    FILES_READ: "files.read",
+    FILES_WRITE: "files.write",
+    CALLS_READ: "calls.read",
+    CALLS_MAKE: "calls.make",
+    WEBHOOKS_READ: "webhooks.read",
+    WEBHOOKS_WRITE: "webhooks.write",
+    USERS_READ: "users.read",
+    FLOWS_READ: "flows.read",
+    FLOWS_EXECUTE: "flows.execute",
+    REPORTS_READ: "reports.read",
+};

package/dist/src/Tickets/AI.d.ts

@@ -1,4 +1,4 @@
-import { ITicketProperty, TicketPropertyValue } from "./Common";
+import { ITicketAuditedEntity, ITicketProperty, TicketPropertyValue } from "./Common";
 import { TicketMetricCode } from "./Dashboard";
 import { TicketSecurityOperation } from "./Security";
 /** Identifies the native AI experiences that Tickets can request from the central AI module. */
@@ -105,6 +105,7 @@ export declare enum TicketAIContextScope {
 }
 /** Configuration exposed by Tickets so UI and Flow know which AI experiences are available and permitted. */
 export interface ITicketAICapabilityDefinition {
+    spaceId: string;
     code: TicketAICapability;
     name: string;
     description: string;
@@ -117,9 +118,24 @@ export interface ITicketAICapabilityDefinition {
     promptTemplateId?: string;
     minimumConfidence?: number;
     requireHumanApproval: boolean;
+    createdAt?: Date;
+    createdBy?: string;
+    updatedAt?: Date;
+    updatedBy?: string;
+}
+export interface IUpdateTicketAICapabilityDto {
+    enabled: boolean;
+    allowedRoleIds?: string[];
+    requiredOperations?: TicketSecurityOperation[];
+    contextScopes: TicketAIContextScope[];
+    providerId?: string;
+    modelId?: string;
+    promptTemplateId?: string;
+    minimumConfidence?: number;
+    requireHumanApproval: boolean;
 }
 /** Per-tenant policy enforced before any ticket context is sent to a model. */
-export interface ITicketAIPolicy {
+export interface ITicketAIPolicy extends ITicketAuditedEntity {
     id: string;
     spaceId: string;
     name: string;
@@ -141,6 +157,38 @@ export interface ITicketAIPolicy {
     updatedAt?: Date;
     updatedBy?: string;
 }
+export interface ICreateTicketAIPolicyDto {
+    name: string;
+    enabled?: boolean;
+    allowedCapabilities: TicketAICapability[];
+    allowedContextScopes: TicketAIContextScope[];
+    excludedFieldNameKeys?: string[];
+    allowPii: boolean;
+    allowSensitivePii: boolean;
+    redactBeforeInference: boolean;
+    retainInputs: boolean;
+    retainOutputs: boolean;
+    retentionDays?: number;
+    maximumTokensPerRequest?: number;
+    maximumCostPerRequest?: number;
+    requireSourceCitations?: boolean;
+}
+export interface IUpdateTicketAIPolicyDto {
+    name?: string;
+    enabled?: boolean;
+    allowedCapabilities?: TicketAICapability[];
+    allowedContextScopes?: TicketAIContextScope[];
+    excludedFieldNameKeys?: string[];
+    allowPii?: boolean;
+    allowSensitivePii?: boolean;
+    redactBeforeInference?: boolean;
+    retainInputs?: boolean;
+    retainOutputs?: boolean;
+    retentionDays?: number;
+    maximumTokensPerRequest?: number;
+    maximumCostPerRequest?: number;
+    requireSourceCitations?: boolean;
+}
 /** Request issued by an agent-facing UI for summaries, replies, rewrites or recommendations. */
 export interface ICreateTicketAIAssistanceDto {
     ticketId: string;

package/dist/src/Tickets/AdvancedApi.d.ts

@@ -1,5 +1,5 @@
 import { MessageVisibility } from "../Common/Messages/Message";
-import { ITicketAttachment, ITicketProperty, TicketPriority, TicketPropertyValue } from "./Common";
+import { ITicketAttachment, ITicketAuditedEntity, ITicketProperty, TicketPriority, TicketPropertyValue } from "./Common";
 import { ITicketFilter, ITicketCursorRequest, ITicketCursorResponse } from "./Api";
 import { ITicketTimelineEntry } from "./Conversation";
 import { ISlaMetricCycle } from "./Sla";
@@ -97,6 +97,72 @@ export interface IDeleteTicketAttachmentDto {
     reason?: string;
 }
 export type TicketAttachmentPage = ITicketCursorResponse<ITicketAttachment>;
+export declare enum TicketAttachmentTypeMode {
+    RECOMMENDED = "RECOMMENDED",
+    ALL = "ALL",
+    CUSTOM = "CUSTOM"
+}
+export declare enum TicketAttachmentDownloadMode {
+    AUTHENTICATED = "AUTHENTICATED",
+    TEMPORARY_LINK = "TEMPORARY_LINK"
+}
+export declare enum TicketSuspiciousFileAction {
+    BLOCK = "BLOCK",
+    QUARANTINE = "QUARANTINE"
+}
+/** An allowed file type: the declared extension paired with the MIME type it must carry. */
+export interface ITicketAttachmentFileType {
+    extension: string;
+    mimeType: string;
+}
+/** Editable half of the attachment policy: what the PUT replaces and the space persists. */
+export interface ITicketAttachmentPolicyValues {
+    agentUploadEnabled: boolean;
+    customerUploadEnabled: boolean;
+    typeMode: TicketAttachmentTypeMode;
+    /** Only read in CUSTOM mode; the other modes resolve their list elsewhere. */
+    allowedTypes: ITicketAttachmentFileType[];
+    maxFileSizeBytes: number;
+    maxFilesPerTicket: number;
+    /** null means no per-ticket total cap; nullable rather than optional because "no cap" is a choice. */
+    maxTotalSizeBytes: number | null;
+    downloadMode: TicketAttachmentDownloadMode;
+    /** Only applies to TEMPORARY_LINK downloads. */
+    temporaryLinkExpirationHours: number;
+}
+/** Ceilings a space cannot exceed; imposed by the upload path, not by storage. */
+export interface ITicketAttachmentPolicyLimits {
+    maxFileSizeBytes: number;
+    maxFilesPerTicket: number;
+    maxTotalSizeBytes: number;
+    temporaryLinkExpirationHours: number;
+}
+/** File security applied by the platform; reported by the read model, not configurable per space. */
+export interface ITicketAttachmentSecurityInfo {
+    checksumEnabled: boolean;
+    malwareScanEnabled: boolean;
+    suspiciousFileAction: TicketSuspiciousFileAction;
+}
+/** Space-level attachment policy; read model returns effective values plus what the platform imposes. */
+export interface ITicketAttachmentPolicy extends ITicketAttachmentPolicyValues {
+    spaceId: string;
+    /** Executables the system always rejects; shown to the administrator, never editable. */
+    blockedExtensions: string[];
+    limits: ITicketAttachmentPolicyLimits;
+    security: ITicketAttachmentSecurityInfo;
+    /** Factory values, and the list that resolves the RECOMMENDED mode. */
+    recommended: ITicketAttachmentPolicyValues;
+    /** 0 means the space never saved and runs on the recommended values. */
+    version: number;
+    createdAt?: Date;
+    createdBy?: string;
+    updatedAt?: Date;
+    updatedBy?: string;
+}
+/** Replaces the whole attachment policy; expectedVersion guards against concurrent edits. */
+export interface IUpdateTicketAttachmentPolicyDto extends ITicketAttachmentPolicyValues {
+    expectedVersion: number;
+}
 export declare enum TicketRelationType {
     PARENT = "PARENT",
     CHILD = "CHILD",
@@ -166,6 +232,66 @@ export interface ISplitTicketResult {
     createdTicketId: string;
     relationId: string;
 }
+export declare enum TicketPeriodPreset {
+    LAST_24_HOURS = "LAST_24_HOURS",
+    LAST_7_DAYS = "LAST_7_DAYS",
+    LAST_30_DAYS = "LAST_30_DAYS"
+}
+export declare enum TicketMergeConfirmationLevel {
+    CONFIRM = "CONFIRM",
+    SUPERVISOR = "SUPERVISOR"
+}
+/** Ticket fields compared by duplicate detection, expressed with the fieldNameKey convention. */
+export type TicketDuplicateMatchField = "title" | "description" | "contactId" | "categoryId";
+/** Space-level configuration for ticket relations and duplicate detection; read model returns effective values. */
+export interface ITicketRelationSettings {
+    spaceId: string;
+    relationsEnabled: boolean;
+    suggestDuplicates: boolean;
+    matchFields: string[];
+    searchPeriod: TicketPeriodPreset;
+    excludedStatusIds: string[];
+    minimumScore: number;
+    copyMessages: boolean;
+    copyAttachments: boolean;
+    closeSourceTickets: boolean;
+    mergeConfirmation: TicketMergeConfirmationLevel;
+    warningMessage?: string;
+    version: number;
+    createdAt?: Date;
+    createdBy?: string;
+    updatedAt?: Date;
+    updatedBy?: string;
+}
+/** Replaces the whole relation settings record; omitted optional values are cleared. */
+export interface IUpdateTicketRelationSettingsDto {
+    expectedVersion: number;
+    relationsEnabled: boolean;
+    suggestDuplicates: boolean;
+    matchFields: TicketDuplicateMatchField[];
+    searchPeriod: TicketPeriodPreset;
+    excludedStatusIds: string[];
+    minimumScore: number;
+    copyMessages: boolean;
+    copyAttachments: boolean;
+    closeSourceTickets: boolean;
+    mergeConfirmation: TicketMergeConfirmationLevel;
+    warningMessage?: string;
+}
+/** Updates only the provided relation settings; omitted fields keep their stored value. */
+export interface IPatchTicketRelationSettingsDto {
+    relationsEnabled?: boolean;
+    suggestDuplicates?: boolean;
+    matchFields?: TicketDuplicateMatchField[];
+    searchPeriod?: TicketPeriodPreset;
+    excludedStatusIds?: string[];
+    minimumScore?: number;
+    copyMessages?: boolean;
+    copyAttachments?: boolean;
+    closeSourceTickets?: boolean;
+    mergeConfirmation?: TicketMergeConfirmationLevel;
+    warningMessage?: string | null;
+}
 export declare enum TicketFollowerRole {
     FOLLOWER = "FOLLOWER",
     COLLABORATOR = "COLLABORATOR",
@@ -247,7 +373,7 @@ export type ITicketMacroAction = {
     type: TicketMacroActionType.ENQUEUE;
     queueId: string;
 };
-export interface ITicketMacro {
+export interface ITicketMacro extends ITicketAuditedEntity {
     id: string;
     spaceId: string;
     name: string;
@@ -269,6 +395,20 @@ export interface IApplyTicketMacroDto {
     };
     idempotencyKey: string;
 }
+export interface ICreateTicketMacroDto {
+    name: string;
+    description?: string;
+    actions: ITicketMacroAction[];
+    allowedRoleIds?: string[];
+    enabled?: boolean;
+}
+export interface IUpdateTicketMacroDto {
+    name?: string;
+    description?: string;
+    actions?: ITicketMacroAction[];
+    allowedRoleIds?: string[];
+    enabled?: boolean;
+}
 export declare enum TicketBulkOperationType {
     UPDATE = "UPDATE",
     ASSIGN = "ASSIGN",