evo360-types 1.3.405 → 1.3.408

package/dist/apps/hub-automation/zod-schemas.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zAutomationDryRunRequestSchema = exports.zHubAutomationConfigSchema = exports.zAutomationRoutineSchema = exports.zAutomationBranchModeSchema = exports.zAutomationBranchSchema = exports.zAutomationOutputSchema = exports.zAutomationHumanTaskOutputSchema = exports.zAutomationAutoTaskOutputSchema = exports.zAutomationExecuteAtSchema = exports.zAutomationConditionGroupSchema = exports.zAutomationConditionSchema = exports.zAutomationOperatorSchema = exports.zAutomationSelectionSchema = exports.zAutomationAppointmentSelectionSchema = exports.zAutomationDateWindowSchema = exports.zAutomationDateOffsetModeSchema = exports.zAutomationTriggerSchema = exports.zAutomationCronTriggerSchema = void 0;
+const zod_1 = require("zod");
+const zod_schemas_1 = require("../evo-task/zod-schemas");
+// ------------------------------------------------------
+// Trigger (F1: cron only)
+// ------------------------------------------------------
+exports.zAutomationCronTriggerSchema = zod_1.z.object({
+    type: zod_1.z.literal("cron"),
+    cron: zod_1.z.object({
+        expression: zod_1.z.string().min(1),
+        timezone: zod_1.z.string().optional(),
+    }),
+});
+exports.zAutomationTriggerSchema = exports.zAutomationCronTriggerSchema;
+// ------------------------------------------------------
+// Selection (F1: appointment target only)
+// ------------------------------------------------------
+exports.zAutomationDateOffsetModeSchema = zod_1.z.enum(["calendar", "business"]);
+exports.zAutomationDateWindowSchema = zod_1.z.object({
+    offset_days: zod_1.z.number().int(), // may be negative (retroactive routines)
+    offset_mode: exports.zAutomationDateOffsetModeSchema,
+});
+exports.zAutomationAppointmentSelectionSchema = zod_1.z.object({
+    target: zod_1.z.literal("appointment"),
+    appointment: zod_1.z.object({
+        calendar_ids: zod_1.z.array(zod_1.z.string()).optional(),
+        date_window: exports.zAutomationDateWindowSchema,
+        status_in: zod_1.z.array(zod_1.z.string()).optional(),
+        status_base_in: zod_1.z.array(zod_1.z.string()).optional(),
+        appointment_type_not_in: zod_1.z.array(zod_1.z.string()).optional(),
+    }),
+});
+exports.zAutomationSelectionSchema = exports.zAutomationAppointmentSelectionSchema;
+// ------------------------------------------------------
+// Conditions (recursive AND/OR groups via z.lazy)
+// ------------------------------------------------------
+exports.zAutomationOperatorSchema = zod_1.z.enum([
+    "eq",
+    "neq",
+    "in",
+    "not_in",
+    "exists",
+    "not_exists",
+    "is_true",
+    "is_false",
+]);
+exports.zAutomationConditionSchema = zod_1.z.object({
+    fact: zod_1.z.string().min(1),
+    operator: exports.zAutomationOperatorSchema,
+    value: zod_1.z.unknown().optional(),
+});
+exports.zAutomationConditionGroupSchema = zod_1.z.lazy(() => zod_1.z.object({
+    combinator: zod_1.z.enum(["and", "or"]),
+    conditions: zod_1.z.array(zod_1.z.union([exports.zAutomationConditionSchema, exports.zAutomationConditionGroupSchema])),
+}));
+// ------------------------------------------------------
+// Outputs (auto Task | human Task)
+// ------------------------------------------------------
+exports.zAutomationExecuteAtSchema = zod_1.z.discriminatedUnion("rule", [
+    zod_1.z.object({ rule: zod_1.z.literal("immediate") }),
+    zod_1.z.object({
+        rule: zod_1.z.literal("send_at_local"),
+        time: zod_1.z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "expected HH:mm"),
+        base: zod_1.z.enum(["target_date", "run_date"]),
+    }),
+]);
+exports.zAutomationAutoTaskOutputSchema = zod_1.z.object({
+    type: zod_1.z.literal("auto_task"),
+    handler: zod_schemas_1.zTaskAutoHandlerSchema,
+    kind: zod_1.z.string().min(1),
+    payload: zod_1.z.record(zod_1.z.unknown()).default({}),
+    execute_at: exports.zAutomationExecuteAtSchema,
+    retry: zod_schemas_1.zTaskRetryPolicySchema.optional(),
+    on_failure: zod_schemas_1.zTaskOnFailureSchema.optional(),
+});
+exports.zAutomationHumanTaskOutputSchema = zod_1.z.object({
+    type: zod_1.z.literal("human_task"),
+    title: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    assignee_ref: zod_1.z.string().optional(),
+});
+exports.zAutomationOutputSchema = zod_1.z.discriminatedUnion("type", [
+    exports.zAutomationAutoTaskOutputSchema,
+    exports.zAutomationHumanTaskOutputSchema,
+]);
+// ------------------------------------------------------
+// Branches
+// ------------------------------------------------------
+exports.zAutomationBranchSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    when: exports.zAutomationConditionGroupSchema.optional(),
+    is_fallback: zod_1.z.boolean().optional(),
+    outputs: zod_1.z.array(exports.zAutomationOutputSchema),
+});
+exports.zAutomationBranchModeSchema = zod_1.z.enum(["all", "exclusive"]);
+// ------------------------------------------------------
+// Routine
+// ------------------------------------------------------
+exports.zAutomationRoutineSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    active: zod_1.z.boolean().default(false),
+    version: zod_1.z.number().int().default(1),
+    trigger: exports.zAutomationTriggerSchema,
+    selection: exports.zAutomationSelectionSchema,
+    branch_mode: exports.zAutomationBranchModeSchema,
+    branches: zod_1.z.array(exports.zAutomationBranchSchema),
+    guards: zod_1.z.object({
+        max_tasks_per_run: zod_1.z.number().int().positive(),
+    }),
+    dry_run_stamp: zod_1.z
+        .object({
+        version: zod_1.z.number().int(),
+        at: zod_1.z.coerce.date(),
+        by: zod_1.z.string(),
+    })
+        .optional(),
+    trigger_state: zod_1.z
+        .object({
+        last_fired_at: zod_1.z.coerce.date().optional(),
+    })
+        .optional(),
+    stats: zod_1.z
+        .object({
+        last_run_at: zod_1.z.coerce.date().optional(),
+        last_materialized_at: zod_1.z.coerce.date().optional(),
+        last_run_id: zod_1.z.string().optional(),
+    })
+        .optional(),
+    created_at: zod_1.z.coerce.date(),
+    updated_at: zod_1.z.coerce.date(),
+});
+// ------------------------------------------------------
+// Module config (mirrors zTaskRunnerConfigSchema: active default false, passthrough)
+// ------------------------------------------------------
+exports.zHubAutomationConfigSchema = zod_1.z
+    .object({
+    active: zod_1.z.boolean().default(false),
+    limits: zod_1.z
+        .object({
+        max_tasks_per_run_default: zod_1.z.number().int().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+// ------------------------------------------------------
+// Dry-run request (endpoint POST /routines/:id/dry-run)
+// ------------------------------------------------------
+exports.zAutomationDryRunRequestSchema = zod_1.z.object({
+    run_date: zod_1.z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "expected yyyy-MM-dd")
+        .optional(),
+});

package/dist/apps/hub-automation/zod-schemas.ts

@@ -0,0 +1,191 @@
+import { z } from "zod";
+import {
+  zTaskAutoHandlerSchema,
+  zTaskRetryPolicySchema,
+  zTaskOnFailureSchema,
+} from "../evo-task/zod-schemas";
+
+// ------------------------------------------------------
+// Trigger (F1: cron only)
+// ------------------------------------------------------
+export const zAutomationCronTriggerSchema = z.object({
+  type: z.literal("cron"),
+  cron: z.object({
+    expression: z.string().min(1),
+    timezone: z.string().optional(),
+  }),
+});
+
+export const zAutomationTriggerSchema = zAutomationCronTriggerSchema;
+
+// ------------------------------------------------------
+// Selection (F1: appointment target only)
+// ------------------------------------------------------
+export const zAutomationDateOffsetModeSchema = z.enum(["calendar", "business"]);
+
+export const zAutomationDateWindowSchema = z.object({
+  offset_days: z.number().int(), // may be negative (retroactive routines)
+  offset_mode: zAutomationDateOffsetModeSchema,
+});
+
+export const zAutomationAppointmentSelectionSchema = z.object({
+  target: z.literal("appointment"),
+  appointment: z.object({
+    calendar_ids: z.array(z.string()).optional(),
+    date_window: zAutomationDateWindowSchema,
+    status_in: z.array(z.string()).optional(),
+    status_base_in: z.array(z.string()).optional(),
+    appointment_type_not_in: z.array(z.string()).optional(),
+  }),
+});
+
+export const zAutomationSelectionSchema = zAutomationAppointmentSelectionSchema;
+
+// ------------------------------------------------------
+// Conditions (recursive AND/OR groups via z.lazy)
+// ------------------------------------------------------
+export const zAutomationOperatorSchema = z.enum([
+  "eq",
+  "neq",
+  "in",
+  "not_in",
+  "exists",
+  "not_exists",
+  "is_true",
+  "is_false",
+]);
+
+export const zAutomationConditionSchema = z.object({
+  fact: z.string().min(1),
+  operator: zAutomationOperatorSchema,
+  value: z.unknown().optional(),
+});
+
+// z.lazy needs an explicit type annotation for the recursive reference.
+type ZAutomationConditionGroup = {
+  combinator: "and" | "or";
+  conditions: Array<
+    z.infer<typeof zAutomationConditionSchema> | ZAutomationConditionGroup
+  >;
+};
+
+export const zAutomationConditionGroupSchema: z.ZodType<ZAutomationConditionGroup> =
+  z.lazy(() =>
+    z.object({
+      combinator: z.enum(["and", "or"]),
+      conditions: z.array(
+        z.union([zAutomationConditionSchema, zAutomationConditionGroupSchema])
+      ),
+    })
+  );
+
+// ------------------------------------------------------
+// Outputs (auto Task | human Task)
+// ------------------------------------------------------
+export const zAutomationExecuteAtSchema = z.discriminatedUnion("rule", [
+  z.object({ rule: z.literal("immediate") }),
+  z.object({
+    rule: z.literal("send_at_local"),
+    time: z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "expected HH:mm"),
+    base: z.enum(["target_date", "run_date"]),
+  }),
+]);
+
+export const zAutomationAutoTaskOutputSchema = z.object({
+  type: z.literal("auto_task"),
+  handler: zTaskAutoHandlerSchema,
+  kind: z.string().min(1),
+  payload: z.record(z.unknown()).default({}),
+  execute_at: zAutomationExecuteAtSchema,
+  retry: zTaskRetryPolicySchema.optional(),
+  on_failure: zTaskOnFailureSchema.optional(),
+});
+
+export const zAutomationHumanTaskOutputSchema = z.object({
+  type: z.literal("human_task"),
+  title: z.string().min(1),
+  description: z.string().optional(),
+  assignee_ref: z.string().optional(),
+});
+
+export const zAutomationOutputSchema = z.discriminatedUnion("type", [
+  zAutomationAutoTaskOutputSchema,
+  zAutomationHumanTaskOutputSchema,
+]);
+
+// ------------------------------------------------------
+// Branches
+// ------------------------------------------------------
+export const zAutomationBranchSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1),
+  when: zAutomationConditionGroupSchema.optional(),
+  is_fallback: z.boolean().optional(),
+  outputs: z.array(zAutomationOutputSchema),
+});
+
+export const zAutomationBranchModeSchema = z.enum(["all", "exclusive"]);
+
+// ------------------------------------------------------
+// Routine
+// ------------------------------------------------------
+export const zAutomationRoutineSchema = z.object({
+  id: z.string(),
+  name: z.string().min(1),
+  description: z.string().optional(),
+  active: z.boolean().default(false),
+  version: z.number().int().default(1),
+  trigger: zAutomationTriggerSchema,
+  selection: zAutomationSelectionSchema,
+  branch_mode: zAutomationBranchModeSchema,
+  branches: z.array(zAutomationBranchSchema),
+  guards: z.object({
+    max_tasks_per_run: z.number().int().positive(),
+  }),
+  dry_run_stamp: z
+    .object({
+      version: z.number().int(),
+      at: z.coerce.date(),
+      by: z.string(),
+    })
+    .optional(),
+  trigger_state: z
+    .object({
+      last_fired_at: z.coerce.date().optional(),
+    })
+    .optional(),
+  stats: z
+    .object({
+      last_run_at: z.coerce.date().optional(),
+      last_materialized_at: z.coerce.date().optional(),
+      last_run_id: z.string().optional(),
+    })
+    .optional(),
+  created_at: z.coerce.date(),
+  updated_at: z.coerce.date(),
+});
+
+// ------------------------------------------------------
+// Module config (mirrors zTaskRunnerConfigSchema: active default false, passthrough)
+// ------------------------------------------------------
+export const zHubAutomationConfigSchema = z
+  .object({
+    active: z.boolean().default(false),
+    limits: z
+      .object({
+        max_tasks_per_run_default: z.number().int().optional(),
+      })
+      .passthrough()
+      .optional(),
+  })
+  .passthrough();
+
+// ------------------------------------------------------
+// Dry-run request (endpoint POST /routines/:id/dry-run)
+// ------------------------------------------------------
+export const zAutomationDryRunRequestSchema = z.object({
+  run_date: z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "expected yyyy-MM-dd")
+    .optional(),
+});

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export * from "./types/evo-finops";
 export * from "./types/evo-notif-user";
 export * from "./types/evo-notifications";
 export * from "./types/evo-task-runner";
+export * from "./types/hub-automation";
 export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 export * from "./types/nex-tenants";
@@ -66,4 +67,5 @@ export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-notifications/quick-reply-action/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
+export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";

package/dist/index.js

@@ -40,6 +40,7 @@ __exportStar(require("./types/evo-finops"), exports);
 __exportStar(require("./types/evo-notif-user"), exports);
 __exportStar(require("./types/evo-notifications"), exports);
 __exportStar(require("./types/evo-task-runner"), exports);
+__exportStar(require("./types/hub-automation"), exports);
 __exportStar(require("./types/evo-integrations"), exports);
 __exportStar(require("./types/nex-customers"), exports);
 __exportStar(require("./types/nex-tenants"), exports);
@@ -84,4 +85,5 @@ __exportStar(require("./apps/evo-notif-user/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/quick-reply-action/zod-schemas"), exports);
 __exportStar(require("./apps/evo-task-runner/zod-schemas"), exports);
+__exportStar(require("./apps/hub-automation/zod-schemas"), exports);
 __exportStar(require("./apps/evo-integrations/zod-schemas"), exports);

package/dist/index.ts

@@ -24,6 +24,7 @@ export * from "./types/evo-finops";
 export * from "./types/evo-notif-user";
 export * from "./types/evo-notifications";
 export * from "./types/evo-task-runner";
+export * from "./types/hub-automation";
 export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 export * from "./types/nex-tenants";
@@ -69,4 +70,5 @@ export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-notifications/quick-reply-action/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
+export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";

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

@@ -46,6 +46,13 @@ export interface IIntegrationsAdapterDoc extends IFireDoc {
      * Precedência: calendar.integration.workflow_overrides → este doc → adapter code default.
      */
     default_workflow_urls: Partial<Record<CapabilityName, string>>;
+    /**
+     * Config de janelas default do adapter — largura/cadência que valem pra
+     * qualquer calendar que não sobrescreva.
+     * Precedência: calendar.integration.sync_config → este doc → default do código.
+     * Merge é campo-a-campo (ver ISyncWindowConfig), não substituição de bloco.
+     */
+    default_sync_config?: ISyncConfig | null;
     supported_capabilities: readonly CapabilityName[];
     auth_schema_version?: number;
 }
@@ -74,9 +81,32 @@ export interface ISyncedHashes {
 }
 export interface ISyncState extends IFireDoc {
     calendar_id: string;
+    /**
+     * Escalar: última run de QUALQUER janela. Não distingue qual janela rodou,
+     * então um `cold` de 5 min atrás faz o `hot` parecer fresco. Use
+     * `last_run_by_window` pra decidir cadência/frescor por janela.
+     */
     last_sync_at?: Date | null;
     last_window_type?: SyncWindowType;
+    /**
+     * Timestamp da última run POR janela. Sucessor de `last_sync_at` pra
+     * qualquer decisão de cadência ou de freshness gate.
+     */
+    last_run_by_window?: Partial<Record<SyncWindowType, Date>>;
+    /**
+     * Sobrescrito INTEIRO a cada run (o engine grava o snapshot da janela que
+     * acabou de rodar). Janelas disjuntas — ex.: `hot` -7/+14 vs
+     * `recent_reconcile` -30/-8 — destroem o cache uma da outra, e a run seguinte
+     * re-processa 100% da janela. Sucedido por `hashes_by_bucket`; mantido por
+     * compat durante a migração.
+     */
     last_synced_hashes: ISyncedHashes;
+    /**
+     * Hashes particionados por bucket, pra que cada janela preserve o próprio
+     * cache. Chave do bucket = window_type (ex.: `hot`) ou, em janelas longas
+     * chunkadas, o chunk (ex.: `warm:2026-08`).
+     */
+    hashes_by_bucket?: Record<string, ISyncedHashes>;
     last_coveredWindow?: ICoveredWindow | null;
 }
 export type SyncRunStatus = "success" | "partial" | "error";
@@ -106,12 +136,23 @@ export interface ISyncRunEvent {
     n8n_calls: number;
     errors?: ISyncRunEventError[];
 }
+/**
+ * Todos os campos são opcionais: a config resolvida é um merge campo-a-campo de
+ * calendar.integration.sync_config → adapter.default_sync_config → default do
+ * código. Um calendar que só quer ajustar `window_days` omite o resto e herda.
+ *
+ * `window_days` é indivisível de propósito: `past` sem `future` não descreve
+ * janela nenhuma, e o resolver (`buildRequestedWindow`) consome o par.
+ */
 export interface ISyncWindowConfig {
-    enabled: boolean;
+    enabled?: boolean;
     /** Cadência em minutos. Ex.: hot=60, warm=360, cold=10080 (semanal). */
-    cadence_minutes: number;
-    /** Janela absoluta em dias a partir de "hoje". */
-    window_days: {
+    cadence_minutes?: number;
+    /**
+     * Janela absoluta em dias a partir de "hoje". `future` pode ser negativo —
+     * janela que termina no passado (ex.: recent_reconcile: past=30, future=-8).
+     */
+    window_days?: {
         past: number;
         future: number;
     };

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

@@ -114,6 +114,13 @@ export interface IIntegrationsAdapterDoc extends IFireDoc {
    * Precedência: calendar.integration.workflow_overrides → este doc → adapter code default.
    */
   default_workflow_urls: Partial<Record<CapabilityName, string>>;
+  /**
+   * Config de janelas default do adapter — largura/cadência que valem pra
+   * qualquer calendar que não sobrescreva.
+   * Precedência: calendar.integration.sync_config → este doc → default do código.
+   * Merge é campo-a-campo (ver ISyncWindowConfig), não substituição de bloco.
+   */
+  default_sync_config?: ISyncConfig | null;
   supported_capabilities: readonly CapabilityName[];
   auth_schema_version?: number;
 }
@@ -158,9 +165,32 @@ export interface ISyncedHashes {
 
 export interface ISyncState extends IFireDoc {
   calendar_id: string;
+  /**
+   * Escalar: última run de QUALQUER janela. Não distingue qual janela rodou,
+   * então um `cold` de 5 min atrás faz o `hot` parecer fresco. Use
+   * `last_run_by_window` pra decidir cadência/frescor por janela.
+   */
   last_sync_at?: Date | null;
   last_window_type?: SyncWindowType;
+  /**
+   * Timestamp da última run POR janela. Sucessor de `last_sync_at` pra
+   * qualquer decisão de cadência ou de freshness gate.
+   */
+  last_run_by_window?: Partial<Record<SyncWindowType, Date>>;
+  /**
+   * Sobrescrito INTEIRO a cada run (o engine grava o snapshot da janela que
+   * acabou de rodar). Janelas disjuntas — ex.: `hot` -7/+14 vs
+   * `recent_reconcile` -30/-8 — destroem o cache uma da outra, e a run seguinte
+   * re-processa 100% da janela. Sucedido por `hashes_by_bucket`; mantido por
+   * compat durante a migração.
+   */
   last_synced_hashes: ISyncedHashes;
+  /**
+   * Hashes particionados por bucket, pra que cada janela preserve o próprio
+   * cache. Chave do bucket = window_type (ex.: `hot`) ou, em janelas longas
+   * chunkadas, o chunk (ex.: `warm:2026-08`).
+   */
+  hashes_by_bucket?: Record<string, ISyncedHashes>;
   last_coveredWindow?: ICoveredWindow | null;
 }
 
@@ -204,12 +234,23 @@ export interface ISyncRunEvent {
 // Ver IMedCalendar em evo-types/src/types/evo-med/calendar.
 // ======================================================
 
+/**
+ * Todos os campos são opcionais: a config resolvida é um merge campo-a-campo de
+ * calendar.integration.sync_config → adapter.default_sync_config → default do
+ * código. Um calendar que só quer ajustar `window_days` omite o resto e herda.
+ *
+ * `window_days` é indivisível de propósito: `past` sem `future` não descreve
+ * janela nenhuma, e o resolver (`buildRequestedWindow`) consome o par.
+ */
 export interface ISyncWindowConfig {
-  enabled: boolean;
+  enabled?: boolean;
   /** Cadência em minutos. Ex.: hot=60, warm=360, cold=10080 (semanal). */
-  cadence_minutes: number;
-  /** Janela absoluta em dias a partir de "hoje". */
-  window_days: {
+  cadence_minutes?: number;
+  /**
+   * Janela absoluta em dias a partir de "hoje". `future` pode ser negativo —
+   * janela que termina no passado (ex.: recent_reconcile: past=30, future=-8).
+   */
+  window_days?: {
     past: number;
     future: number;
   };

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

@@ -55,6 +55,7 @@ export declare const TaskAutoHandlerEnum: {
     readonly LeadReactivation: "lead_reactivation";
     readonly AppointmentAction: "appointment_action";
     readonly AppointmentReminder: "appointment_reminder";
+    readonly IntegrationsSyncRun: "evo-integrations.sync-run";
 };
 export type TaskAutoHandler = (typeof TaskAutoHandlerEnum)[keyof typeof TaskAutoHandlerEnum];
 export declare const TaskRetryStrategyEnum: {

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

@@ -98,6 +98,13 @@ exports.TaskAutoHandlerEnum = {
     // por canal habilitado (WhatsApp/e-mail), com quick-reply de confirmar/remarcar.
     // Tópico PubSub do executor: `appointment_reminder.execute_requests`.
     AppointmentReminder: "appointment_reminder",
+    // feat-078: handler que roda um sync de agenda do evo-integrations. O valor
+    // é o nome do handler COM ponto de propósito — `resolveHandlerTopic` faz
+    // `${handler}.execute_requests`, e a CF `integrations_sync` já escuta
+    // `evo-integrations.sync-run.execute_requests` (= SYNC_RUN_HANDLER em
+    // types/evo-integrations). Permite que o `/force` roteie pelo task-runner e
+    // herde retry/backoff/DLQ, em vez de montar a mensagem PubSub na mão.
+    IntegrationsSyncRun: "evo-integrations.sync-run",
 };
 // ----- Retry policy
 exports.TaskRetryStrategyEnum = {

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

@@ -109,6 +109,13 @@ export const TaskAutoHandlerEnum = {
   // por canal habilitado (WhatsApp/e-mail), com quick-reply de confirmar/remarcar.
   // Tópico PubSub do executor: `appointment_reminder.execute_requests`.
   AppointmentReminder: "appointment_reminder",
+  // feat-078: handler que roda um sync de agenda do evo-integrations. O valor
+  // é o nome do handler COM ponto de propósito — `resolveHandlerTopic` faz
+  // `${handler}.execute_requests`, e a CF `integrations_sync` já escuta
+  // `evo-integrations.sync-run.execute_requests` (= SYNC_RUN_HANDLER em
+  // types/evo-integrations). Permite que o `/force` roteie pelo task-runner e
+  // herde retry/backoff/DLQ, em vez de montar a mensagem PubSub na mão.
+  IntegrationsSyncRun: "evo-integrations.sync-run",
 } as const;
 
 export type TaskAutoHandler =

package/dist/types/hub-automation/fb_collections.d.ts

@@ -0,0 +1,4 @@
+export declare const HUB_AUTOMATION_APP = "hub-automation";
+export declare const ROUTINES_COLLECTION = "routines";
+export declare const RUNS_COLLECTION = "runs";
+export declare const HUB_AUTOMATION_CONFIG_DOC = "config";

package/dist/types/hub-automation/fb_collections.js

@@ -0,0 +1,16 @@
+"use strict";
+// Firestore collection/doc identifiers for the hub-automation module.
+// Base path: tenants/{tenant}/apps/hub-automation/...
+// - `config` subcollection reuses the shared CONFIG_COLLECTION ("config")
+// - HUB_AUTOMATION_CONFIG_DOC is the fixed doc id inside that subcollection
+//   (path: tenants/{tenant}/apps/hub-automation/config/config)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUB_AUTOMATION_CONFIG_DOC = exports.RUNS_COLLECTION = exports.ROUTINES_COLLECTION = exports.HUB_AUTOMATION_APP = void 0;
+// ----- App identifier (Firestore path: tenants/{t}/apps/hub-automation/...)
+exports.HUB_AUTOMATION_APP = "hub-automation";
+// ----- Routines collection: tenants/{t}/apps/hub-automation/routines/{routineId}
+exports.ROUTINES_COLLECTION = "routines";
+// ----- Run traces collection: tenants/{t}/apps/hub-automation/runs/{runId}
+exports.RUNS_COLLECTION = "runs";
+// ----- Fixed config doc id inside the shared `config` subcollection
+exports.HUB_AUTOMATION_CONFIG_DOC = "config";

package/dist/types/hub-automation/fb_collections.ts

@@ -0,0 +1,17 @@
+// Firestore collection/doc identifiers for the hub-automation module.
+// Base path: tenants/{tenant}/apps/hub-automation/...
+// - `config` subcollection reuses the shared CONFIG_COLLECTION ("config")
+// - HUB_AUTOMATION_CONFIG_DOC is the fixed doc id inside that subcollection
+//   (path: tenants/{tenant}/apps/hub-automation/config/config)
+
+// ----- App identifier (Firestore path: tenants/{t}/apps/hub-automation/...)
+export const HUB_AUTOMATION_APP = "hub-automation";
+
+// ----- Routines collection: tenants/{t}/apps/hub-automation/routines/{routineId}
+export const ROUTINES_COLLECTION = "routines";
+
+// ----- Run traces collection: tenants/{t}/apps/hub-automation/runs/{runId}
+export const RUNS_COLLECTION = "runs";
+
+// ----- Fixed config doc id inside the shared `config` subcollection
+export const HUB_AUTOMATION_CONFIG_DOC = "config";