evo360-types 1.3.321 → 1.3.326

package/dist/apps/evo-task/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zTaskLogSchema = exports.zTaskExecutionSchema = exports.zTaskExecutionProviderSchema = exports.zTaskExecutionErrorSchema = exports.zTaskCommentSchema = exports.zTaskCommentAuthorSchema = exports.zTaskSchema = exports.zTaskCreatorSchema = exports.zTaskOnFailureSchema = exports.zTaskAutoSpecSchema = exports.zTaskDedupSchema = exports.zTaskRetryPolicySchema = exports.zTaskLockSchema = exports.zTaskUserAssigneeSchema = exports.zTaskScheduleSchema = exports.zTaskExternalLinkSchema = exports.zExternalLinkSchema = exports.zTaskExecutionStatusSchema = exports.zTaskExternalObjectTypeSchema = exports.zExternalObjectTypeSchema = exports.zTaskDedupWindowSchema = exports.zTaskDedupScopeSchema = exports.zTaskRetryStrategySchema = exports.zTaskAutoHandlerSchema = exports.zTaskModeSchema = exports.zTaskSourceSchema = exports.zTaskPrioritySchema = exports.zTaskStatusSchema = exports.zTaskActionSchema = void 0;
+exports.zTaskLogSchema = exports.zTaskExecutionSchema = exports.zTaskExecutionProviderSchema = exports.zTaskExecutionErrorSchema = exports.zTaskCommentSchema = exports.zTaskCommentAuthorSchema = exports.zTaskSchema = exports.zTaskCreatorSchema = exports.zTaskOnFailureSchema = exports.zTaskAutoSpecSchema = exports.zTaskDedupSchema = exports.zTaskRetryPolicySchema = exports.zTaskRunnerStateSchema = exports.zTaskLockSchema = exports.zTaskUserAssigneeSchema = exports.zTaskScheduleSchema = exports.zTaskExternalLinkSchema = exports.zExternalLinkSchema = exports.zTaskExecutionStatusSchema = exports.zTaskExternalObjectTypeSchema = exports.zExternalObjectTypeSchema = exports.zTaskDedupWindowSchema = exports.zTaskDedupScopeSchema = exports.zTaskRetryStrategySchema = exports.zTaskAutoHandlerSchema = exports.zTaskModeSchema = exports.zTaskSourceSchema = exports.zTaskPrioritySchema = exports.zTaskStatusSchema = exports.zTaskActionSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 exports.zTaskActionSchema = zod_1.z.enum([
@@ -16,6 +16,7 @@ exports.zTaskStatusSchema = zod_1.z.enum([
     "cancelled",
     "on_hold",
     "suppressed",
+    "dead_letter",
 ]);
 exports.zTaskPrioritySchema = zod_1.z.enum(["low", "medium", "high"]);
 exports.zTaskSourceSchema = zod_1.z.enum(["user", "automation_hub", "system"]);
@@ -83,6 +84,15 @@ exports.zTaskLockSchema = zod_1.z
     lock_until: zod_1.z.coerce.date(),
 })
     .passthrough();
+// Schema para ITaskRunnerState
+exports.zTaskRunnerStateSchema = zod_1.z
+    .object({
+    reclaim_count: zod_1.z.number().optional(),
+    fallback_index: zod_1.z.number().optional(),
+    last_dispatch_at: zod_1.z.coerce.date().optional(),
+    dispatched_attempts: zod_1.z.number().optional(),
+})
+    .passthrough();
 // Schema para ITaskRetryPolicy
 exports.zTaskRetryPolicySchema = zod_1.z
     .object({
@@ -179,6 +189,7 @@ exports.zTaskSchema = zod_schemas_1.zFireDocSchema
     lock: exports.zTaskLockSchema.optional(), // for auto tasks
     retry: exports.zTaskRetryPolicySchema.optional(), // for auto tasks
     on_failure: exports.zTaskOnFailureSchema.optional(), // for auto tasks
+    runner_state: exports.zTaskRunnerStateSchema.optional(), // for auto tasks (maintained by Task Runner)
     auto: exports.zTaskAutoSpecSchema.optional(), // for auto tasks (required when mode=auto)
 })
     .passthrough();

package/dist/apps/evo-task/zod-schemas.ts

@@ -15,6 +15,7 @@ export const zTaskStatusSchema = z.enum([
   "cancelled",
   "on_hold",
   "suppressed",
+  "dead_letter",
 ]);
 
 export const zTaskPrioritySchema = z.enum(["low", "medium", "high"]);
@@ -101,6 +102,16 @@ export const zTaskLockSchema = z
   })
   .passthrough();
 
+// Schema para ITaskRunnerState
+export const zTaskRunnerStateSchema = z
+  .object({
+    reclaim_count: z.number().optional(),
+    fallback_index: z.number().optional(),
+    last_dispatch_at: z.coerce.date().optional(),
+    dispatched_attempts: z.number().optional(),
+  })
+  .passthrough();
+
 // Schema para ITaskRetryPolicy
 export const zTaskRetryPolicySchema = z
   .object({
@@ -204,6 +215,7 @@ export const zTaskSchema = zFireDocSchema
     lock: zTaskLockSchema.optional(), // for auto tasks
     retry: zTaskRetryPolicySchema.optional(), // for auto tasks
     on_failure: zTaskOnFailureSchema.optional(), // for auto tasks
+    runner_state: zTaskRunnerStateSchema.optional(), // for auto tasks (maintained by Task Runner)
     auto: zTaskAutoSpecSchema.optional(), // for auto tasks (required when mode=auto)
   })
   .passthrough();

package/dist/apps/evo-task-runner/index.d.ts

@@ -0,0 +1 @@
+export * from "./zod-schemas";

package/dist/apps/evo-task-runner/index.js

@@ -0,0 +1,17 @@
+"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("./zod-schemas"), exports);

package/dist/apps/evo-task-runner/index.ts

@@ -0,0 +1 @@
+export * from "./zod-schemas";

package/dist/apps/evo-task-runner/zod-schemas.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const zTaskRunnerConfigSchema: z.ZodObject<{
+    active: z.ZodDefault<z.ZodBoolean>;
+    limits: z.ZodOptional<z.ZodObject<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    active: z.ZodDefault<z.ZodBoolean>;
+    limits: z.ZodOptional<z.ZodObject<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    active: z.ZodDefault<z.ZodBoolean>;
+    limits: z.ZodOptional<z.ZodObject<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        max_claims_per_tick: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ITaskRunnerConfig = z.infer<typeof zTaskRunnerConfigSchema>;

package/dist/apps/evo-task-runner/zod-schemas.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zTaskRunnerConfigSchema = void 0;
+const zod_1 = require("zod");
+exports.zTaskRunnerConfigSchema = zod_1.z
+    .object({
+    active: zod_1.z.boolean().default(false),
+    limits: zod_1.z
+        .object({
+        max_claims_per_tick: zod_1.z.number().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();

package/dist/apps/evo-task-runner/zod-schemas.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+
+export const zTaskRunnerConfigSchema = z
+  .object({
+    active: z.boolean().default(false),
+    limits: z
+      .object({
+        max_claims_per_tick: z.number().optional(),
+      })
+      .passthrough()
+      .optional(),
+  })
+  .passthrough();
+
+export type ITaskRunnerConfig = z.infer<typeof zTaskRunnerConfigSchema>;

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from "./types/evo-people";
 export * from "./types/evo-crm/dic";
 export * from "./types/evo-crm/lead";
 export * from "./types/evo-chat";
+export * from "./types/evo-chat/dic";
 export * from "./types/evo-med/calendar";
 export * from "./types/evo-med/appointment";
 export * from "./types/evo-med/dic";
@@ -29,6 +30,7 @@ export * from "./apps/evo-activity/zod-schemas";
 export * from "./apps/evo-people/zod-schemas";
 export * from "./apps/evo-crm/dic/zod-schemas";
 export * from "./apps/evo-crm/lead/zod-schemas";
+export * from "./apps/evo-chat/dic/ticket-close/zod-schemas";
 export * from "./apps/evo-chat/chatbee/zod-schemas";
 export * from "./apps/evo-chat/contact/zod-schemas";
 export * from "./apps/evo-chat/message/zod-schemas";
@@ -53,3 +55,4 @@ export * from "./apps/evo-survey/zod-schemas";
 export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
+export * from "./apps/evo-task-runner/zod-schemas";

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./types/evo-people"), exports);
 __exportStar(require("./types/evo-crm/dic"), exports);
 __exportStar(require("./types/evo-crm/lead"), exports);
 __exportStar(require("./types/evo-chat"), exports);
+__exportStar(require("./types/evo-chat/dic"), exports);
 __exportStar(require("./types/evo-med/calendar"), exports);
 __exportStar(require("./types/evo-med/appointment"), exports);
 __exportStar(require("./types/evo-med/dic"), exports);
@@ -47,6 +48,7 @@ __exportStar(require("./apps/evo-activity/zod-schemas"), exports);
 __exportStar(require("./apps/evo-people/zod-schemas"), exports);
 __exportStar(require("./apps/evo-crm/dic/zod-schemas"), exports);
 __exportStar(require("./apps/evo-crm/lead/zod-schemas"), exports);
+__exportStar(require("./apps/evo-chat/dic/ticket-close/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/chatbee/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/contact/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/message/zod-schemas"), exports);
@@ -71,3 +73,4 @@ __exportStar(require("./apps/evo-survey/zod-schemas"), exports);
 __exportStar(require("./apps/evo-finops/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notif-user/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/zod-schemas"), exports);
+__exportStar(require("./apps/evo-task-runner/zod-schemas"), exports);

package/dist/index.ts

@@ -9,6 +9,7 @@ export * from "./types/evo-people";
 export * from "./types/evo-crm/dic";
 export * from "./types/evo-crm/lead";
 export * from "./types/evo-chat";
+export * from "./types/evo-chat/dic";
 export * from "./types/evo-med/calendar";
 export * from "./types/evo-med/appointment";
 export * from "./types/evo-med/dic";
@@ -32,6 +33,7 @@ export * from "./apps/evo-activity/zod-schemas";
 export * from "./apps/evo-people/zod-schemas";
 export * from "./apps/evo-crm/dic/zod-schemas";
 export * from "./apps/evo-crm/lead/zod-schemas";
+export * from "./apps/evo-chat/dic/ticket-close/zod-schemas";
 export * from "./apps/evo-chat/chatbee/zod-schemas";
 export * from "./apps/evo-chat/contact/zod-schemas";
 export * from "./apps/evo-chat/message/zod-schemas";
@@ -56,3 +58,4 @@ export * from "./apps/evo-survey/zod-schemas";
 export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
+export * from "./apps/evo-task-runner/zod-schemas";

package/dist/types/evo-chat/dic/index.d.ts

@@ -0,0 +1,30 @@
+export * from "../fb_collections";
+import { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
+export declare const EvoChatDicPermissions: {
+    readonly List: "evo_chat_dics_read";
+    readonly Get: "evo_chat_dics_read";
+    readonly Create: "evo_chat_dics_write";
+    readonly Update: "evo_chat_dics_write";
+    readonly Delete: "evo_chat_dics_write";
+};
+export type EvoChatDicPermissions = (typeof EvoChatDicPermissions)[keyof typeof EvoChatDicPermissions];
+export interface ITicketCloseType extends IFireDoc {
+    code: string;
+    name: string;
+    tags?: ITag[] | null;
+    [key: string]: unknown;
+}
+export interface ITicketClose extends IFireDoc {
+    code: string;
+    name: string;
+    color: string;
+    notes_req: boolean;
+    description: string;
+    order: number;
+    type_code?: string;
+    type_name?: string;
+    typeRef?: FirestoreDocumentReference;
+    external_id?: string | null;
+    tags?: ITag[] | null;
+    [key: string]: unknown;
+}

package/dist/types/evo-chat/dic/index.js

@@ -0,0 +1,26 @@
+"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 });
+exports.EvoChatDicPermissions = void 0;
+__exportStar(require("../fb_collections"), exports);
+// Permissões para o dicionário
+exports.EvoChatDicPermissions = {
+    List: "evo_chat_dics_read",
+    Get: "evo_chat_dics_read",
+    Create: "evo_chat_dics_write",
+    Update: "evo_chat_dics_write",
+    Delete: "evo_chat_dics_write",
+};

package/dist/types/evo-chat/dic/index.ts

@@ -0,0 +1,39 @@
+export * from "../fb_collections";
+
+import { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
+
+// Permissões para o dicionário
+export const EvoChatDicPermissions = {
+  List: "evo_chat_dics_read",
+  Get: "evo_chat_dics_read",
+  Create: "evo_chat_dics_write",
+  Update: "evo_chat_dics_write",
+  Delete: "evo_chat_dics_write",
+} as const;
+
+export type EvoChatDicPermissions =
+  (typeof EvoChatDicPermissions)[keyof typeof EvoChatDicPermissions];
+
+// ----- EvoChatDicTypes
+
+export interface ITicketCloseType extends IFireDoc {
+  code: string;
+  name: string;
+  tags?: ITag[] | null;
+  [key: string]: unknown;
+}
+
+export interface ITicketClose extends IFireDoc {
+  code: string;
+  name: string;
+  color: string;
+  notes_req: boolean;
+  description: string;
+  order: number;
+  type_code?: string;
+  type_name?: string;
+  typeRef?: FirestoreDocumentReference;
+  external_id?: string | null;
+  tags?: ITag[] | null;
+  [key: string]: unknown;
+}

package/dist/types/evo-chat/fb_collections.d.ts

@@ -1,4 +1,8 @@
 export declare const EVO_CHAT_APP = "evo-chat";
+export declare const CHAT_DICS_COLLECTION = "dics";
+export declare const TICKET_CLOSES = "ticket-closes";
+export declare const TICKET_CLOSES_COLLECTION = "items";
+export declare const TICKET_CLOSE_TYPES_COLLECTION = "types";
 export declare const CONTACTS_COLLECTION = "contacts";
 export declare const PROTOCOLS_COLLECTION = "protocols";
 export declare const HSM_MESSAGES_COLLECTION = "hsm-messages";

package/dist/types/evo-chat/fb_collections.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HubWabaCollections = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.EVO_CHAT_APP = void 0;
+exports.HubWabaCollections = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.TICKET_CLOSE_TYPES_COLLECTION = exports.TICKET_CLOSES_COLLECTION = exports.TICKET_CLOSES = exports.CHAT_DICS_COLLECTION = exports.EVO_CHAT_APP = void 0;
 //EVO Chat Application Doc
 exports.EVO_CHAT_APP = "evo-chat";
+//dictionaries
+exports.CHAT_DICS_COLLECTION = "dics";
+exports.TICKET_CLOSES = "ticket-closes";
+exports.TICKET_CLOSES_COLLECTION = "items";
+exports.TICKET_CLOSE_TYPES_COLLECTION = "types";
 //contacts collection
 exports.CONTACTS_COLLECTION = "contacts";
 //protocols collection

package/dist/types/evo-chat/fb_collections.ts

@@ -1,6 +1,12 @@
 //EVO Chat Application Doc
 export const EVO_CHAT_APP = "evo-chat";
 
+//dictionaries
+export const CHAT_DICS_COLLECTION = "dics";
+export const TICKET_CLOSES = "ticket-closes";
+export const TICKET_CLOSES_COLLECTION = "items";
+export const TICKET_CLOSE_TYPES_COLLECTION = "types";
+
 //contacts collection
 export const CONTACTS_COLLECTION = "contacts";
 

package/dist/types/evo-chat/ticket/index.d.ts

@@ -1,11 +1,16 @@
 import { IFireDoc } from "../../shared";
 export type TicketStatus = 'open' | 'closed';
-export interface ITicketClose {
-    base: string;
-    label: string;
+export interface ITicketCloseInfo {
+    base?: string;
+    label?: string;
+    code?: string;
+    name?: string;
+    color?: string;
+    type_code?: string;
+    type_name?: string;
     notes?: string;
-    closed_by_user_id: string;
-    closed_at: Date;
+    closed_by_user_id?: string;
+    closed_at?: Date;
 }
 export interface ITicketCreatedBy {
     type: 'human' | 'automation' | 'system';
@@ -20,7 +25,7 @@ export interface ITicket extends IFireDoc {
     department_id: string;
     status: TicketStatus;
     channel_ids: string[];
-    close?: ITicketClose;
+    close?: ITicketCloseInfo;
     system_status?: 'normal' | 'moved';
     quality_indicator?: number | string;
     message_count?: number;

package/dist/types/evo-chat/ticket/index.ts

@@ -6,12 +6,17 @@ export type TicketStatus = 'open' | 'closed';
 
 // ── Ticket close info ──
 
-export interface ITicketClose {
-  base: string;
-  label: string;
+export interface ITicketCloseInfo {
+  base?: string;
+  label?: string;
+  code?: string;
+  name?: string;
+  color?: string;
+  type_code?: string;
+  type_name?: string;
   notes?: string;
-  closed_by_user_id: string;
-  closed_at: Date;
+  closed_by_user_id?: string;
+  closed_at?: Date;
 }
 
 // ── Ticket creator ──
@@ -35,7 +40,7 @@ export interface ITicket extends IFireDoc {
   // Channels active during this ticket
   channel_ids: string[];
 
-  close?: ITicketClose;
+  close?: ITicketCloseInfo;
 
   system_status?: 'normal' | 'moved';
   quality_indicator?: number | string;

package/dist/types/evo-task/index.d.ts

@@ -22,6 +22,7 @@ export declare const TaskStatusEnum: {
     readonly Cancelled: "cancelled";
     readonly OnHold: "on_hold";
     readonly Suppressed: "suppressed";
+    readonly DeadLetter: "dead_letter";
 };
 export type TaskStatus = (typeof TaskStatusEnum)[keyof typeof TaskStatusEnum];
 export declare const TaskPriorityEnum: {
@@ -73,6 +74,13 @@ export interface ITaskLock {
     lock_until: Date;
     [key: string]: unknown;
 }
+export interface ITaskRunnerState {
+    reclaim_count?: number;
+    fallback_index?: number;
+    last_dispatch_at?: Date;
+    dispatched_attempts?: number;
+    [key: string]: unknown;
+}
 export declare const TaskDedupScopeEnum: {
     readonly PerRecipient: "per_recipient";
     readonly PerRecipientAndObject: "per_recipient_and_object";
@@ -167,6 +175,7 @@ export interface IAutoTask extends ITaskBase {
     lock?: ITaskLock;
     retry?: ITaskRetryPolicy;
     on_failure?: ITaskOnFailure;
+    runner_state?: ITaskRunnerState;
     auto: ITaskAutoSpec;
 }
 export type ITask = IHumanTask | IAutoTask;

package/dist/types/evo-task/index.js

@@ -50,6 +50,7 @@ exports.TaskStatusEnum = {
     Cancelled: "cancelled",
     OnHold: "on_hold",
     Suppressed: "suppressed", // intentionally skipped (e.g., dedup)
+    DeadLetter: "dead_letter", // unrecoverable after reclaim attempts
 };
 // ----- Task priority (human-friendly)
 exports.TaskPriorityEnum = {

package/dist/types/evo-task/index.ts

@@ -48,6 +48,7 @@ export const TaskStatusEnum = {
   Cancelled: "cancelled",
   OnHold: "on_hold",
   Suppressed: "suppressed", // intentionally skipped (e.g., dedup)
+  DeadLetter: "dead_letter", // unrecoverable after reclaim attempts
 } as const;
 
 export type TaskStatus = (typeof TaskStatusEnum)[keyof typeof TaskStatusEnum];
@@ -123,6 +124,15 @@ export interface ITaskLock {
   [key: string]: unknown;
 }
 
+// ----- Runtime state maintained by the Task Runner
+export interface ITaskRunnerState {
+  reclaim_count?: number;
+  fallback_index?: number; // -1 = primary, 0..N = auto_fallbacks[i]
+  last_dispatch_at?: Date;
+  dispatched_attempts?: number;
+  [key: string]: unknown;
+}
+
 // ----- Dedup / suppression (optional)
 export const TaskDedupScopeEnum = {
   PerRecipient: "per_recipient",
@@ -276,6 +286,9 @@ export interface IAutoTask extends ITaskBase {
   retry?: ITaskRetryPolicy;
   on_failure?: ITaskOnFailure;
 
+  // Runtime state populated by the Task Runner
+  runner_state?: ITaskRunnerState;
+
   // What to execute
   auto: ITaskAutoSpec;
 }

package/dist/types/evo-task-runner/fb_collections.d.ts

@@ -0,0 +1 @@
+export declare const TASK_RUNNER_CONFIG_DOC = "config";

package/dist/types/evo-task-runner/fb_collections.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASK_RUNNER_CONFIG_DOC = void 0;
+// Per-tenant task runner configuration.
+// Path: tenants/{tenant}/apps/evo-task-runner/config/config
+// - `config` subcollection reuses the shared CONFIG_COLLECTION ("config")
+// - TASK_RUNNER_CONFIG_DOC is the fixed doc id inside that subcollection
+exports.TASK_RUNNER_CONFIG_DOC = "config";

package/dist/types/evo-task-runner/fb_collections.ts

@@ -0,0 +1,5 @@
+// Per-tenant task runner configuration.
+// Path: tenants/{tenant}/apps/evo-task-runner/config/config
+// - `config` subcollection reuses the shared CONFIG_COLLECTION ("config")
+// - TASK_RUNNER_CONFIG_DOC is the fixed doc id inside that subcollection
+export const TASK_RUNNER_CONFIG_DOC = "config";

package/dist/types/evo-task-runner/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./fb_collections";
 import type { IFireDoc } from "../shared";
 import type { TaskAutoHandler, TaskExecutionStatus, TaskRetryStrategy } from "../evo-task";
 export declare const EvoTaskRunnerPermissions: {
@@ -8,12 +9,15 @@ export declare const EvoTaskRunnerPermissions: {
     readonly Delete: "evo_task_runner_write";
 };
 export type EvoTaskRunnerPermissions = (typeof EvoTaskRunnerPermissions)[keyof typeof EvoTaskRunnerPermissions];
+export declare const EVO_TASK_RUNNER_APP = "evo-task-runner";
+export declare const TaskRunnerWorkerIdPrefix = "task-runner";
 export declare const TaskRunnerTopics: {
     readonly Tick: "task_runner.tick";
     readonly ExecuteRequests: "task_runner.execute_requests";
     readonly ExecutionReports: "task_runner.execution_reports";
 };
 export type TaskRunnerTopic = (typeof TaskRunnerTopics)[keyof typeof TaskRunnerTopics];
+export declare const taskRunnerHandlerTopic: (handler: string) => string;
 export declare const TaskRunnerTickReasonEnum: {
     readonly Schedule: "schedule";
     readonly Manual: "manual";

package/dist/types/evo-task-runner/index.js

@@ -1,6 +1,21 @@
 "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 });
-exports.TaskRunnerTickReasonEnum = exports.TaskRunnerTopics = exports.EvoTaskRunnerPermissions = void 0;
+exports.TaskRunnerTickReasonEnum = exports.taskRunnerHandlerTopic = exports.TaskRunnerTopics = exports.TaskRunnerWorkerIdPrefix = exports.EVO_TASK_RUNNER_APP = exports.EvoTaskRunnerPermissions = void 0;
+__exportStar(require("./fb_collections"), exports);
 // Permissões para o task runner
 exports.EvoTaskRunnerPermissions = {
     List: "evo_task_runner_read",
@@ -21,12 +36,19 @@ exports.EvoTaskRunnerPermissions = {
 // - Task payload schemas live in their respective modules.
 // - This contract is handler-agnostic and safe to share between backend/frontend.
 // ======================================================
+// ----- App identifier (Firestore path: tenants/{t}/apps/evo-task-runner/...)
+exports.EVO_TASK_RUNNER_APP = "evo-task-runner";
+// ----- Prefix used to compose worker ids (e.g. `${prefix}-${K_SERVICE}-${uuid}`)
+exports.TaskRunnerWorkerIdPrefix = "task-runner";
 // ----- Pub/Sub topic suggestions (logical names)
 exports.TaskRunnerTopics = {
     Tick: "task_runner.tick",
     ExecuteRequests: "task_runner.execute_requests",
     ExecutionReports: "task_runner.execution_reports",
 };
+// ----- Per-handler execute requests topic (one topic per handler id)
+const taskRunnerHandlerTopic = (handler) => `${handler}.execute_requests`;
+exports.taskRunnerHandlerTopic = taskRunnerHandlerTopic;
 // ----- Runner tick messages (optional)
 exports.TaskRunnerTickReasonEnum = {
     Schedule: "schedule",

package/dist/types/evo-task-runner/index.ts

@@ -1,3 +1,4 @@
+export * from "./fb_collections";
 import type { IFireDoc } from "../shared";
 import type {
   TaskAutoHandler,
@@ -29,6 +30,12 @@ export type EvoTaskRunnerPermissions =
 // - This contract is handler-agnostic and safe to share between backend/frontend.
 // ======================================================
 
+// ----- App identifier (Firestore path: tenants/{t}/apps/evo-task-runner/...)
+export const EVO_TASK_RUNNER_APP = "evo-task-runner";
+
+// ----- Prefix used to compose worker ids (e.g. `${prefix}-${K_SERVICE}-${uuid}`)
+export const TaskRunnerWorkerIdPrefix = "task-runner";
+
 // ----- Pub/Sub topic suggestions (logical names)
 export const TaskRunnerTopics = {
   Tick: "task_runner.tick",
@@ -39,6 +46,10 @@ export const TaskRunnerTopics = {
 export type TaskRunnerTopic =
   (typeof TaskRunnerTopics)[keyof typeof TaskRunnerTopics];
 
+// ----- Per-handler execute requests topic (one topic per handler id)
+export const taskRunnerHandlerTopic = (handler: string) =>
+  `${handler}.execute_requests`;
+
 // ----- Runner tick messages (optional)
 export const TaskRunnerTickReasonEnum = {
   Schedule: "schedule",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.321",
+  "version": "1.3.326",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",