evo360-types 1.3.408 → 1.3.409

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

@@ -1,10 +1,10 @@
 "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;
+exports.zAutomationTriggerRequestSchema = exports.zAutomationDryRunRequestSchema = exports.zHubAutomationConfigSchema = exports.zAutomationRoutineUpdateRequestSchema = exports.zAutomationRoutineWriteSchema = 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.zAutomationWebhookTriggerSchema = exports.zAutomationCronTriggerSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../evo-task/zod-schemas");
 // ------------------------------------------------------
-// Trigger (F1: cron only)
+// Trigger (cron sweep | webhook reverse-trigger)
 // ------------------------------------------------------
 exports.zAutomationCronTriggerSchema = zod_1.z.object({
     type: zod_1.z.literal("cron"),
@@ -13,7 +13,14 @@ exports.zAutomationCronTriggerSchema = zod_1.z.object({
         timezone: zod_1.z.string().optional(),
     }),
 });
-exports.zAutomationTriggerSchema = exports.zAutomationCronTriggerSchema;
+// F2: fired only by POST /routines/:id/trigger; invisible to the sweep.
+exports.zAutomationWebhookTriggerSchema = zod_1.z.object({
+    type: zod_1.z.literal("webhook"),
+});
+exports.zAutomationTriggerSchema = zod_1.z.discriminatedUnion("type", [
+    exports.zAutomationCronTriggerSchema,
+    exports.zAutomationWebhookTriggerSchema,
+]);
 // ------------------------------------------------------
 // Selection (F1: appointment target only)
 // ------------------------------------------------------
@@ -135,6 +142,32 @@ exports.zAutomationRoutineSchema = zod_1.z.object({
     updated_at: zod_1.z.coerce.date(),
 });
 // ------------------------------------------------------
+// Routine write payload (CRUD via POST/PUT — F3)
+// Same structure as zAutomationRoutineSchema WITHOUT the server-managed fields
+// (version/dry_run_stamp/trigger_state/stats/created_at/updated_at), which the
+// backend owns. `active` defaults false (create) — activation is a separate
+// endpoint that also enforces the Q11 dry-run gate.
+// ------------------------------------------------------
+exports.zAutomationRoutineWriteSchema = 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),
+    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(),
+    }),
+});
+// PUT /routines/:id body — optimistic concurrency: expected_version must match
+// the stored routine's version or the backend returns 409.
+exports.zAutomationRoutineUpdateRequestSchema = zod_1.z.object({
+    routine: exports.zAutomationRoutineWriteSchema,
+    expected_version: zod_1.z.number().int().positive(),
+});
+// ------------------------------------------------------
 // Module config (mirrors zTaskRunnerConfigSchema: active default false, passthrough)
 // ------------------------------------------------------
 exports.zHubAutomationConfigSchema = zod_1.z
@@ -157,3 +190,14 @@ exports.zAutomationDryRunRequestSchema = zod_1.z.object({
         .regex(/^\d{4}-\d{2}-\d{2}$/, "expected yyyy-MM-dd")
         .optional(),
 });
+// ------------------------------------------------------
+// Trigger request (endpoint POST /routines/:id/trigger)
+// Same shape as the dry-run request — only an optional run_date; no
+// calendar_ids override or arbitrary payload (F2 scope, see plan-f2 §1).
+// ------------------------------------------------------
+exports.zAutomationTriggerRequestSchema = 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

@@ -6,7 +6,7 @@ import {
 } from "../evo-task/zod-schemas";
 
 // ------------------------------------------------------
-// Trigger (F1: cron only)
+// Trigger (cron sweep | webhook reverse-trigger)
 // ------------------------------------------------------
 export const zAutomationCronTriggerSchema = z.object({
   type: z.literal("cron"),
@@ -16,7 +16,15 @@ export const zAutomationCronTriggerSchema = z.object({
   }),
 });
 
-export const zAutomationTriggerSchema = zAutomationCronTriggerSchema;
+// F2: fired only by POST /routines/:id/trigger; invisible to the sweep.
+export const zAutomationWebhookTriggerSchema = z.object({
+  type: z.literal("webhook"),
+});
+
+export const zAutomationTriggerSchema = z.discriminatedUnion("type", [
+  zAutomationCronTriggerSchema,
+  zAutomationWebhookTriggerSchema,
+]);
 
 // ------------------------------------------------------
 // Selection (F1: appointment target only)
@@ -165,6 +173,34 @@ export const zAutomationRoutineSchema = z.object({
   updated_at: z.coerce.date(),
 });
 
+// ------------------------------------------------------
+// Routine write payload (CRUD via POST/PUT — F3)
+// Same structure as zAutomationRoutineSchema WITHOUT the server-managed fields
+// (version/dry_run_stamp/trigger_state/stats/created_at/updated_at), which the
+// backend owns. `active` defaults false (create) — activation is a separate
+// endpoint that also enforces the Q11 dry-run gate.
+// ------------------------------------------------------
+export const zAutomationRoutineWriteSchema = z.object({
+  id: z.string(),
+  name: z.string().min(1),
+  description: z.string().optional(),
+  active: z.boolean().default(false),
+  trigger: zAutomationTriggerSchema,
+  selection: zAutomationSelectionSchema,
+  branch_mode: zAutomationBranchModeSchema,
+  branches: z.array(zAutomationBranchSchema),
+  guards: z.object({
+    max_tasks_per_run: z.number().int().positive(),
+  }),
+});
+
+// PUT /routines/:id body — optimistic concurrency: expected_version must match
+// the stored routine's version or the backend returns 409.
+export const zAutomationRoutineUpdateRequestSchema = z.object({
+  routine: zAutomationRoutineWriteSchema,
+  expected_version: z.number().int().positive(),
+});
+
 // ------------------------------------------------------
 // Module config (mirrors zTaskRunnerConfigSchema: active default false, passthrough)
 // ------------------------------------------------------
@@ -189,3 +225,15 @@ export const zAutomationDryRunRequestSchema = z.object({
     .regex(/^\d{4}-\d{2}-\d{2}$/, "expected yyyy-MM-dd")
     .optional(),
 });
+
+// ------------------------------------------------------
+// Trigger request (endpoint POST /routines/:id/trigger)
+// Same shape as the dry-run request — only an optional run_date; no
+// calendar_ids override or arbitrary payload (F2 scope, see plan-f2 §1).
+// ------------------------------------------------------
+export const zAutomationTriggerRequestSchema = z.object({
+  run_date: z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "expected yyyy-MM-dd")
+    .optional(),
+});

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

@@ -12,7 +12,10 @@ export interface IAutomationCronTrigger {
         timezone?: string;
     };
 }
-export type IAutomationTrigger = IAutomationCronTrigger;
+export interface IAutomationWebhookTrigger {
+    type: "webhook";
+}
+export type IAutomationTrigger = IAutomationCronTrigger | IAutomationWebhookTrigger;
 export type AutomationDateOffsetMode = "calendar" | "business";
 export interface IAutomationDateWindow {
     offset_days: number;
@@ -118,6 +121,19 @@ export interface IAutomationRoutine {
     created_at: Date;
     updated_at: Date;
 }
+export interface IAutomationRoutineWrite {
+    id: string;
+    name: string;
+    description?: string;
+    active: boolean;
+    trigger: IAutomationTrigger;
+    selection: IAutomationSelection;
+    branch_mode: AutomationBranchMode;
+    branches: IAutomationBranch[];
+    guards: {
+        max_tasks_per_run: number;
+    };
+}
 export interface IHubAutomationConfig {
     active: boolean;
     limits?: {
@@ -147,10 +163,12 @@ export interface IAutomationRunSample {
     appointment_id: string;
     branch_id?: string;
     decision: string;
+    task_id?: string;
     conditions?: IAutomationConditionResult[];
     [key: string]: unknown;
 }
 export interface IAutomationRunTrace {
+    run_id?: string;
     routine_id: string;
     routine_version: number;
     trigger: {

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

@@ -27,7 +27,7 @@ export type HubAutomationPermissions =
   (typeof HubAutomationPermissions)[keyof typeof HubAutomationPermissions];
 
 // ------------------------------------------------------
-// Trigger (F1: cron only)
+// Trigger (cron sweep | webhook reverse-trigger)
 // ------------------------------------------------------
 export interface IAutomationCronTrigger {
   type: "cron";
@@ -39,7 +39,15 @@ export interface IAutomationCronTrigger {
   };
 }
 
-export type IAutomationTrigger = IAutomationCronTrigger;
+// F2: fired only by POST /routines/:id/trigger (n8n as a client of the engine);
+// invisible to the sweep (listActiveCronRoutines filters type === 'cron').
+export interface IAutomationWebhookTrigger {
+  type: "webhook";
+}
+
+export type IAutomationTrigger =
+  | IAutomationCronTrigger
+  | IAutomationWebhookTrigger;
 
 // ------------------------------------------------------
 // Selection (F1: appointment target only)
@@ -230,6 +238,27 @@ export interface IAutomationRoutine {
   updated_at: Date;
 }
 
+// ------------------------------------------------------
+// Routine write payload (CRUD via POST/PUT on hub_automation_admin — F3)
+// The routine WITHOUT server-managed fields: `version`, `dry_run_stamp`,
+// `trigger_state`, `stats`, `created_at`, `updated_at` are set by the backend
+// (version bookkeeping, Q11 gate, cursor, run stats, timestamps). The FE never
+// writes them. Written by hand (no utility types) to keep the contract explicit.
+// ------------------------------------------------------
+export interface IAutomationRoutineWrite {
+  id: string;
+  name: string;
+  description?: string;
+  active: boolean;
+  trigger: IAutomationTrigger;
+  selection: IAutomationSelection;
+  branch_mode: AutomationBranchMode;
+  branches: IAutomationBranch[];
+  guards: {
+    max_tasks_per_run: number;
+  };
+}
+
 // ------------------------------------------------------
 // Module config (Firestore doc: tenants/{t}/apps/hub-automation/config/config)
 // ------------------------------------------------------
@@ -275,11 +304,17 @@ export interface IAutomationRunSample {
   branch_id?: string;
   // e.g. 'created' | 'already_existed' | 'not_matched' | 'suppressed_by_limit'
   decision: string;
+  // Set by the materializer when decision === 'created'; lets the run viewer
+  // deep-link from a sample to the materialized Task (F3).
+  task_id?: string;
   conditions?: IAutomationConditionResult[];
   [key: string]: unknown;
 }
 
 export interface IAutomationRunTrace {
+  // Engine-generated run id; surfaced in the webhook trigger response (F2) so
+  // the caller can deep-link to this run. Optional for backward compatibility.
+  run_id?: string;
   routine_id: string;
   routine_version: number;
   trigger: {

package/package.json

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