@t4dhg/mcp-factorial 9.0.0 → 10.0.0

package/dist/types.d.ts

@@ -7,13 +7,9 @@
 export type { Employee, Team, Location, Contract, ContractSummary, Leave, LeaveType, Allowance, Shift, Folder, Document, JobRole, JobLevel, } from './schemas.js';
 export type { PaginationInput, PaginationParams, PaginationMeta, PaginatedResponse, } from './pagination.js';
 /**
- * Leave status options
+ * Half day values as the API serialises them (Factorial's spelling)
  */
-export type LeaveStatus = 'pending' | 'approved' | 'declined';
-/**
- * Half day options
- */
-export type HalfDay = 'all_day' | 'start' | 'finish';
+export type HalfDay = 'beggining_of_day' | 'end_of_day';
 /**
  * Options for listing employees
  */
@@ -27,10 +23,12 @@ export interface ListEmployeesOptions {
  * Options for listing leaves
  */
 export interface ListLeavesOptions {
-    employee_id?: number;
-    status?: LeaveStatus;
-    start_on_gte?: string;
-    start_on_lte?: string;
+    /** Filter by employee IDs (employee_ids[]) */
+    employee_ids?: number[];
+    /** Leaves overlapping the window starting on this date (YYYY-MM-DD) */
+    from?: string;
+    /** Leaves overlapping the window ending on this date (YYYY-MM-DD) */
+    to?: string;
     page?: number;
     limit?: number;
 }
@@ -44,14 +42,31 @@ export interface ListAllowancesOptions {
 }
 /**
  * Options for listing shifts
+ *
+ * Only filters the API honours are listed. /attendance/shifts ignores
+ * `employee_id` (singular), `clock_in_gte`, `clock_in_lte`, `page` and
+ * `limit`, and returns every matching record with `paginateable: false`, so
+ * page and limit are applied client-side.
  */
 export interface ListShiftsOptions {
-    employee_id?: number;
-    clock_in_gte?: string;
-    clock_in_lte?: string;
+    employee_ids?: number[];
+    start_on?: string;
+    end_on?: string;
+    ids?: number[];
+    updated_at?: string;
+    workable?: boolean;
+    half_day?: HalfDay;
     page?: number;
     limit?: number;
 }
+/**
+ * Options for the per-day attendance summaries (estimated_times, worked_times)
+ */
+export interface DailyTimesOptions {
+    employee_ids: number[];
+    start_on: string;
+    end_on: string;
+}
 /**
  * Options for listing documents
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/write-safety.d.ts

@@ -157,6 +157,24 @@ declare const POLICIES: {
         requiresPreview: true;
         impactDescription: string;
     };
+    clock_in: {
+        risk: OperationRisk.LOW;
+        requiresConfirmation: false;
+        requiresPreview: false;
+        impactDescription: string;
+    };
+    clock_out: {
+        risk: OperationRisk.LOW;
+        requiresConfirmation: false;
+        requiresPreview: false;
+        impactDescription: string;
+    };
+    backfill_shifts: {
+        risk: OperationRisk.HIGH;
+        requiresConfirmation: true;
+        requiresPreview: true;
+        impactDescription: string;
+    };
     upload_document: {
         risk: OperationRisk.MEDIUM;
         requiresConfirmation: false;

package/dist/write-safety.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-safety.d.ts","sourceRoot":"","sources":["../src/write-safety.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,qEAAqE;IACrE,GAAG,QAAQ;IACX,wEAAwE;IACxE,MAAM,WAAW;IACjB,gEAAgE;IAChE,IAAI,SAAS;IACb,kFAAkF;IAClF,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsO6B,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,QAAQ,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAY,CAAC;AAE5E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CASzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAetE"}
+{"version":3,"file":"write-safety.d.ts","sourceRoot":"","sources":["../src/write-safety.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,qEAAqE;IACrE,GAAG,QAAQ;IACX,wEAAwE;IACxE,MAAM,WAAW;IACjB,gEAAgE;IAChE,IAAI,SAAS;IACb,kFAAkF;IAClF,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0P6B,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,QAAQ,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAY,CAAC;AAE5E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CASzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAetE"}

package/dist/write-safety.js

@@ -141,6 +141,25 @@ const POLICIES = {
         requiresPreview: true,
         impactDescription: 'Deletes the shift record',
     },
+    clock_in: {
+        risk: OperationRisk.LOW,
+        requiresConfirmation: false,
+        requiresPreview: false,
+        impactDescription: 'Opens a shift for an employee at the current time',
+    },
+    clock_out: {
+        risk: OperationRisk.LOW,
+        requiresConfirmation: false,
+        requiresPreview: false,
+        impactDescription: 'Closes the open shift of an employee at the current time',
+    },
+    backfill_shifts: {
+        risk: OperationRisk.HIGH,
+        requiresConfirmation: true,
+        requiresPreview: true,
+        impactDescription: 'Writes many attendance records for one employee at once. Gated by a confirmation token bound ' +
+            'to the previewed plan (the preview names the person, the dates and the totals), not by confirm: true.',
+    },
     // Document operations
     upload_document: {
         risk: OperationRisk.MEDIUM,

package/dist/write-safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-safety.js","sourceRoot":"","sources":["../src/write-safety.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write-safety.js","sourceRoot":"","sources":["../src/write-safety.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,qEAAqE;IACrE,4BAAW,CAAA;IACX,wEAAwE;IACxE,kCAAiB,CAAA;IACjB,gEAAgE;IAChE,8BAAa,CAAA;IACb,kFAAkF;IAClF,sCAAqB,CAAA;AACvB,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAyBD;;GAEG;AACH,MAAM,QAAQ,GAAG;IACf,sBAAsB;IACtB,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,6CAA6C;KACjE;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,8BAA8B;KAClD;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,qEAAqE;KACzF;IAED,kBAAkB;IAClB,WAAW,EAAE;QACX,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,oBAAoB;KACxC;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,0BAA0B;KAC9C;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,sDAAsD;KAC1E;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,8BAA8B;KAClD;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,mCAAmC;KACvD;IAED,sBAAsB;IACtB,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,+BAA+B;KACnD;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,8BAA8B;KAClD;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,wDAAwD;KAC5E;IAED,mBAAmB;IACnB,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,6BAA6B;KACjD;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,+BAA+B;KACnD;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2BAA2B;KAC/C;IACD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,sDAAsD;KAC1E;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2BAA2B;KAC/C;IAED,mBAAmB;IACnB,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,oCAAoC;KACxD;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,kCAAkC;KACtD;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,0BAA0B;KAC9C;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,mDAAmD;KACvE;IACD,SAAS,EAAE;QACT,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,0DAA0D;KAC9E;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EACf,+FAA+F;YAC/F,uGAAuG;KAC1G;IAED,sBAAsB;IACtB,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,wBAAwB;KAC5C;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,2BAA2B;KAC/C;IACD,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,kCAAkC;KACtD;IAED,qBAAqB;IACrB,cAAc,EAAE;QACd,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,uBAAuB;KAC3C;IACD,cAAc,EAAE;QACd,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,yBAAyB;KAC7C;IACD,cAAc,EAAE;QACd,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2DAA2D;KAC/E;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,0BAA0B;KAC9C;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,yBAAyB;KAC7C;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EACf,qGAAqG;KACxG;IAED,iBAAiB;IACjB,kBAAkB,EAAE;QAClB,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2BAA2B;KAC/C;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,8CAA8C;KAClE;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,0CAA0C;KAC9D;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EACf,6FAA6F;KAChG;IAED,sBAAsB;IACtB,eAAe,EAAE;QACf,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,kDAAkD;KACtE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,8BAA8B;KAClD;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2DAA2D;KAC/E;CACwC,CAAC;AAW5C,MAAM,CAAC,MAAM,kBAAkB,GAAoC,QAAQ,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,CACL,kBAAkB,CAAC,aAAa,CAAC,IAAI;QACnC,IAAI,EAAE,aAAa,CAAC,MAAM;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,8BAA8B;KAClD,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,OAAO,kBAAkB,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ,CAAC;IAEhG,IAAI,UAAU,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAC9C,OAAO,CACL,0BAA0B,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,iBAAiB,IAAI;YACrF,CAAC,MAAM,CAAC,oBAAoB;gBAC1B,CAAC,CAAC,4CAA4C;gBAC9C,CAAC,CAAC,4CAA4C,CAAC,CAClD,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/llms.txt

@@ -9,7 +9,7 @@ MCP FactorialHR provides comprehensive access to FactorialHR data through the Mo
 ## Key Features
 
 - **80+ Tools**: Full CRUD operations for all major HR entities
-- **Safety Guardrails**: Every operation that deletes a record, or terminates an employee, requires `confirm: true`. See the README for the full list.
+- **Safety Guardrails**: Every operation that deletes a record, or terminates an employee, requires `confirm: true`. Attendance writes for another person, and all bulk attendance writes, require a confirmation token from a preview. See the README for the full lists.
 - **Audit Logging**: All write operations are logged in-process for debugging. The log is in-memory, capped at 1000 entries, and not retrievable through any tool.
 - **Read-only Payroll**: Payroll data is accessible but read-only for security
 - **Pagination**: All list operations support pagination
@@ -34,9 +34,11 @@ MCP FactorialHR provides comprehensive access to FactorialHR data through the Mo
 - list_leaves, get_leave, list_leave_types, get_leave_type, list_allowances
 - create_leave, update_leave, cancel_leave, approve_leave, reject_leave
 
-### Attendance (5 tools)
-- list_shifts, get_shift
-- create_shift, update_shift, delete_shift
+### Attendance (11 actions, registro horario)
+- list, get, create, update, delete (shift records; list needs start_on/end_on, paging is client-side)
+- clock_in, clock_out, status (live clocking; FACTORIAL_EMPLOYEE_ID supplies the default employee)
+- gaps (workdays with missing hours), log_range (daily pattern over a range), log_days (explicit days)
+- Bulk writes and writes for another person return a preview plus a confirmation_token first; repeat the call with the token to write
 
 ### Projects (17 tools)
 - list_projects, get_project, create_project, update_project, delete_project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t4dhg/mcp-factorial",
-  "version": "9.0.0",
+  "version": "10.0.0",
   "mcpName": "io.github.t4dhg/mcp-factorial",
   "description": "The definitive MCP server for FactorialHR - Full CRUD operations for employees, teams, time off, projects, training, recruiting (ATS), and payroll. Context-optimized with 14 hierarchical tools (117 operations) and safety guardrails.",
   "type": "module",