evo360-types 1.3.324 → 1.3.326

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export declare const zTaskActionSchema: z.ZodEnum<["CREATE_TASK", "DELETE_TASK", "UPDATE_TASK"]>;
-export declare const zTaskStatusSchema: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed"]>;
+export declare const zTaskStatusSchema: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed", "dead_letter"]>;
 export declare const zTaskPrioritySchema: z.ZodEnum<["low", "medium", "high"]>;
 export declare const zTaskSourceSchema: z.ZodEnum<["user", "automation_hub", "system"]>;
 export declare const zTaskModeSchema: z.ZodEnum<["human", "auto"]>;
@@ -79,6 +79,22 @@ export declare const zTaskLockSchema: z.ZodObject<{
     locked_by: z.ZodString;
     lock_until: z.ZodDate;
 }, z.ZodTypeAny, "passthrough">>;
+export declare const zTaskRunnerStateSchema: z.ZodObject<{
+    reclaim_count: z.ZodOptional<z.ZodNumber>;
+    fallback_index: z.ZodOptional<z.ZodNumber>;
+    last_dispatch_at: z.ZodOptional<z.ZodDate>;
+    dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    reclaim_count: z.ZodOptional<z.ZodNumber>;
+    fallback_index: z.ZodOptional<z.ZodNumber>;
+    last_dispatch_at: z.ZodOptional<z.ZodDate>;
+    dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    reclaim_count: z.ZodOptional<z.ZodNumber>;
+    fallback_index: z.ZodOptional<z.ZodNumber>;
+    last_dispatch_at: z.ZodOptional<z.ZodDate>;
+    dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
 export declare const zTaskRetryPolicySchema: z.ZodObject<{
     max_attempts: z.ZodNumber;
     attempt: z.ZodNumber;
@@ -422,7 +438,7 @@ export declare const zTaskSchema: z.ZodObject<{
 } & {
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed"]>;
+    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed", "dead_letter"]>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     importance: z.ZodOptional<z.ZodNumber>;
     source: z.ZodEnum<["user", "automation_hub", "system"]>;
@@ -814,6 +830,22 @@ export declare const zTaskSchema: z.ZodObject<{
             payload: Record<string, unknown>;
         }>, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
+    runner_state: z.ZodOptional<z.ZodObject<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
     auto: z.ZodOptional<z.ZodObject<{
         handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom"]>;
         kind: z.ZodString;
@@ -844,7 +876,7 @@ export declare const zTaskSchema: z.ZodObject<{
 } & {
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed"]>;
+    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed", "dead_letter"]>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     importance: z.ZodOptional<z.ZodNumber>;
     source: z.ZodEnum<["user", "automation_hub", "system"]>;
@@ -1236,6 +1268,22 @@ export declare const zTaskSchema: z.ZodObject<{
             payload: Record<string, unknown>;
         }>, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
+    runner_state: z.ZodOptional<z.ZodObject<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
     auto: z.ZodOptional<z.ZodObject<{
         handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom"]>;
         kind: z.ZodString;
@@ -1266,7 +1314,7 @@ export declare const zTaskSchema: z.ZodObject<{
 } & {
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed"]>;
+    status: z.ZodEnum<["not_started", "in_progress", "completed", "failed", "cancelled", "on_hold", "suppressed", "dead_letter"]>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     importance: z.ZodOptional<z.ZodNumber>;
     source: z.ZodEnum<["user", "automation_hub", "system"]>;
@@ -1658,6 +1706,22 @@ export declare const zTaskSchema: z.ZodObject<{
             payload: Record<string, unknown>;
         }>, "many">>;
     }, z.ZodTypeAny, "passthrough">>>;
+    runner_state: z.ZodOptional<z.ZodObject<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        reclaim_count: z.ZodOptional<z.ZodNumber>;
+        fallback_index: z.ZodOptional<z.ZodNumber>;
+        last_dispatch_at: z.ZodOptional<z.ZodDate>;
+        dispatched_attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
     auto: z.ZodOptional<z.ZodObject<{
         handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom"]>;
         kind: z.ZodString;

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

@@ -55,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

@@ -73,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

@@ -58,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-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.324",
+  "version": "1.3.326",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",