@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/workers/workers.contract.js

@@ -1,24 +1,117 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaginatedWorkerResponseSchema = exports.FilterWorkerSchema = exports.MergeDuplicatesResponseSchema = exports.MergeDuplicatesRequestSchema = exports.MergeDuplicateCuratedWorkerSchema = exports.FindDuplicatesSummaryResponseSchema = exports.DuplicateGroupSummarySchema = exports.DuplicateGroupSummaryWorkerSchema = exports.FindDuplicatesResponseSchema = exports.DuplicateGroupSchema = exports.DuplicateGroupWorkerSchema = exports.FilterDuplicatesSchema = exports.FilterSuggestedMatchesSchema = exports.PromoteWorkerResponseSchema = exports.BulkLinkWorkersResponseSchema = exports.BulkLinkWorkersSchema = exports.LinkWithMergeResponseSchema = exports.LinkWithMergeSchema = exports.MergeFieldSchema = exports.LinkWorkerResponseSchema = exports.LinkWorkerSchema = exports.SuggestCuratedMatchesResponseSchema = exports.MatchFieldCountsSchema = exports.SuggestedMatchSchema = exports.MatchConfidenceSchema = exports.MatchFieldSchema = exports.CuratedWorkerMatchSummarySchema = exports.WorkerMatchSummarySchema = exports.UpdateWorkerSchema = exports.CreateWorkerBodySchema = exports.CreateWorkerSchema = exports.WorkerSchema = exports.WorkerLiveStatusSchema = exports.WorkerUserSchema = exports.TradeFilterSchema = exports.ShareCodeSchema = exports.UpdateWorkerIdDocumentSchema = exports.CreateWorkerIdDocumentSchema = exports.WorkerIdDocumentSchema = exports.IdDocumentTypeSchema = exports.CreateWorkerQualificationSchema = exports.WorkerQualificationSchema = exports.CreateWorkerTradeSchema = exports.WorkerTradeSchema = exports.UpsertWorkerPhoneNumberSchema = exports.CreateWorkerPhoneNumberSchema = exports.WorkerPhoneNumberSchema = exports.BooleanFilterSchema = exports.WorkerSortableFieldsSchema = exports.AvailabilitySchema = void 0;
-exports.workersContractRouter = exports.WorkerImportResultSchema = exports.WorkerImportJobSchema = exports.StartWorkerImportSchema = exports.WorkerImportJobStatusSchema = void 0;
+exports.SuggestCuratedMatchGroupsResponseSchema = exports.CuratedMatchGroupSchema = exports.SuggestCuratedMatchesResponseSchema = exports.MatchFieldCountsSchema = exports.SuggestedMatchSchema = exports.MatchConfidenceSchema = exports.MatchFieldSchema = exports.CuratedWorkerMatchSummarySchema = exports.WorkerMatchSummarySchema = exports.UpdateWorkerBodySchema = exports.UpdateWorkerSchema = exports.CreateSingleWorkerBodySchema = exports.CreateWorkerBodySchema = exports.CreateWorkerSchema = exports.WorkerListItemSchema = exports.WorkerSchema = exports.WorkerLiveStatusSchema = exports.WorkerUserSchema = exports.TradeFilterSchema = exports.ShareCodeSchema = exports.UpdateWorkerIdDocumentSchema = exports.CreateWorkerIdDocumentSchema = exports.WorkerIdDocumentSchema = exports.CreateWorkerQualificationSchema = exports.WorkerQualificationSchema = exports.CreateWorkerTradeSchema = exports.WorkerTradeSchema = exports.CheckWorkerAvailabilityResponseSchema = exports.CheckWorkerAvailabilityQuerySchema = exports.AvailabilityConflictWorkerSchema = exports.UpsertWorkerPhoneNumberSchema = exports.CreateWorkerPhoneNumberSchema = exports.WorkerPhoneNumberSchema = exports.OfferOpennessSchema = exports.BooleanFilterSchema = exports.WorkerSortFieldMapping = exports.WorkerSortableFieldsSchema = exports.OccupancyStatusSchema = exports.WorkerCreateConflictResponseSchema = exports.WorkerCreateGenericConflictResponseSchema = exports.WorkerCreateGenericConflictCodeSchema = exports.WorkerLeadAttributionRequiredResponseSchema = exports.ResolveWorkerSourceAttributionBodySchema = exports.WorkerSourceAttributionChallengeSchema = exports.WorkerLeadAttributionMatchSchema = exports.WorkerSourceAttributionAnswerSchema = exports.WorkerSourceAttributionStatusSchema = exports.WorkerSourceAttributionContextSchema = exports.WorkerSourceSchema = exports.IdDocumentTypeSchema = void 0;
+exports.workersContractRouter = exports.InvalidateWorkerSourceAttributionChallengeBodySchema = exports.ResolveWorkerSourceAttributionChallengesBatchResponseSchema = exports.ResolveWorkerSourceAttributionChallengeResultSchema = exports.ResolveWorkerSourceAttributionChallengesBatchBodySchema = exports.WorkerSourceAttributionChallengeListResponseSchema = exports.AdminListWorkerSourceAttributionChallengesQuerySchema = exports.ListWorkerSourceAttributionChallengesQuerySchema = exports.WorkerImportResultSchema = exports.WorkerImportJobSchema = exports.StartWorkerImportSchema = exports.WorkerImportJobStatusSchema = exports.FindAllWorkersResponseSchema = exports.PaginatedWorkerListResponseSchema = exports.PaginatedWorkerResponseSchema = exports.FilterWorkerSchema = exports.MergeDuplicatesResponseSchema = exports.MergeDuplicatesRequestSchema = exports.MergeDuplicateCuratedWorkerSchema = exports.FindWorkersByPhonesResponseSchema = exports.WorkerPhoneLookupResultSchema = exports.FindWorkersByPhonesBodySchema = exports.FindDuplicatesSummaryResponseSchema = exports.DuplicateGroupSummarySchema = exports.DuplicateGroupSummaryWorkerSchema = exports.FindDuplicatesResponseSchema = exports.DuplicateGroupSchema = exports.DuplicateGroupWorkerSchema = exports.FilterDuplicatesSchema = exports.FilterSuggestedMatchesSchema = exports.BulkPromoteUnmatchedResponseSchema = exports.BulkPromoteUnmatchedPreviewResponseSchema = exports.PromoteWorkerResponseSchema = exports.BatchCreateWorkersResponseSchema = exports.BatchCreateWorkerResultSchema = exports.BatchCreateWorkersBodySchema = exports.BulkLinkWorkersResponseSchema = exports.BulkLinkWorkersSchema = exports.LinkWorkersWithMergeResponseSchema = exports.LinkWorkersWithMergeSchema = exports.LinkWithMergeResponseSchema = exports.LinkWithMergeSchema = exports.ScalarMergeFieldSchema = exports.LinkWorkerResponseSchema = exports.LinkWorkerSchema = void 0;
 const zod_openapi_1 = require("@anatine/zod-openapi");
 const core_1 = require("@ts-rest/core");
 const zod_1 = require("zod");
 const common_schemas_1 = require("../common/common-schemas");
+var common_schemas_2 = require("../common/common-schemas");
+Object.defineProperty(exports, "IdDocumentTypeSchema", { enumerable: true, get: function () { return common_schemas_2.IdDocumentTypeSchema; } });
 const error_schemas_1 = require("../common/error-schemas");
 const pagination_query_schema_1 = require("../common/pagination-query.schema");
 const pagination_schema_1 = require("../common/pagination.schema");
-const curated_workers_contract_1 = require("../curated-workers/curated-workers.contract");
+const booking_history_schema_1 = require("../shared/booking-history.schema");
+const contact_suppressions_contract_1 = require("../shared/contact-suppressions.contract");
 const crews_contract_1 = require("../crews/crews.contract");
+const summary_schemas_1 = require("../shared/summary-schemas");
 const users_contract_1 = require("../users/users.contract");
+const worker_source_identity_conflicts_schemas_1 = require("../worker-source-identity-conflicts/worker-source-identity-conflicts.schemas");
 (0, zod_openapi_1.extendZodWithOpenApi)(zod_1.z);
-// --- Enums ---
-exports.AvailabilitySchema = zod_1.z.enum([
-    'AVAILABLE',
-    'PARTIALLY_AVAILABLE',
-    'UNAVAILABLE',
+exports.WorkerSourceSchema = zod_1.z.enum([
+    'MANUAL',
+    'LEAD_MATCH',
+    'PROMOTED',
+    'IMPORT',
 ]);
+exports.WorkerSourceAttributionContextSchema = zod_1.z.enum([
+    'SINGLE',
+    'BATCH',
+    'IMPORT',
+]);
+exports.WorkerSourceAttributionStatusSchema = zod_1.z.enum([
+    'PENDING',
+    'RESOLVED_YES',
+    'RESOLVED_NO',
+    'INVALIDATED',
+]);
+exports.WorkerSourceAttributionAnswerSchema = zod_1.z.enum(['YES', 'NO']);
+exports.WorkerLeadAttributionMatchSchema = zod_1.z
+    .object({
+    curatedWorker: zod_1.z
+        .object({
+        id: zod_1.z.string().uuid(),
+        firstName: zod_1.z.string(),
+        lastName: zod_1.z.string().nullable(),
+    })
+        .strict(),
+    phoneMasked: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictPhoneMaskSchema,
+    contactedAt: zod_1.z.string().datetime(),
+    channel: zod_1.z.enum(['PHONE', 'WHATSAPP']),
+    outcome: zod_1.z.string().min(1),
+    qualifyingContactCount: zod_1.z.number().int().positive(),
+})
+    .strict();
+exports.WorkerSourceAttributionChallengeSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    context: exports.WorkerSourceAttributionContextSchema,
+    status: exports.WorkerSourceAttributionStatusSchema,
+    submittedWorkerName: zod_1.z.string(),
+    match: exports.WorkerLeadAttributionMatchSchema,
+    expiresAt: zod_1.z.string().datetime(),
+    createdAt: zod_1.z.string().datetime(),
+    identityReviewAdjustment: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityReviewAdjustmentSchema.nullable().optional(),
+})
+    .strict();
+exports.ResolveWorkerSourceAttributionBodySchema = zod_1.z.object({
+    answer: exports.WorkerSourceAttributionAnswerSchema,
+    explanation: zod_1.z.string().trim().max(500).optional(),
+});
+exports.WorkerLeadAttributionRequiredResponseSchema = zod_1.z
+    .object({
+    message: zod_1.z.string(),
+    code: zod_1.z.literal('WORKER_LEAD_ATTRIBUTION_REQUIRED'),
+    statusCode: zod_1.z.literal(409),
+    details: zod_1.z
+        .object({
+        challengeId: zod_1.z.string().uuid(),
+        expiresAt: zod_1.z.string().datetime(),
+        submittedWorkerName: zod_1.z.string(),
+        match: exports.WorkerLeadAttributionMatchSchema,
+        identityReviewAdjustment: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityReviewAdjustmentSchema.nullable(),
+    })
+        .strict(),
+})
+    .strict();
+// CLOSED enumeration of every ErrorCode the worker-create path may return
+// with HTTP 409. Adding a new 409 to POST /v2/workers (or its batch/import
+// variants) without listing the code here makes strict parsers of
+// WorkerCreateConflictResponseSchema reject the response — update this enum
+// (and its contract spec) together with the API change.
+exports.WorkerCreateGenericConflictCodeSchema = zod_1.z.enum([
+    'BAD_REQUEST',
+    'CREW_MEMBER_LIMIT_REACHED',
+    'ENTITY_HAS_RELATED_RECORDS',
+    'FILE_ATTACHMENT_INVALID',
+    'INVALID_WORKER_DATA',
+    'VALIDATION_ERROR',
+    'WORKER_ALREADY_EXISTS',
+    'WORKER_ALREADY_HAS_QUALIFICATION',
+]);
+exports.WorkerCreateGenericConflictResponseSchema = zod_1.z
+    .object({
+    ...error_schemas_1.ErrorResponseSchema.shape,
+    statusCode: zod_1.z.literal(409),
+    code: exports.WorkerCreateGenericConflictCodeSchema,
+})
+    .strict();
+exports.WorkerCreateConflictResponseSchema = zod_1.z.discriminatedUnion('code', [
+    exports.WorkerLeadAttributionRequiredResponseSchema,
+    worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictRequiredResponseSchema,
+    exports.WorkerCreateGenericConflictResponseSchema,
+]);
+exports.OccupancyStatusSchema = zod_1.z.enum(['ACTIVE', 'BOOKED']).nullable();
 // EnglishLevelSchema and NationalitySchema are now imported from common-schemas
 exports.WorkerSortableFieldsSchema = zod_1.z
     .enum([
@@ -28,7 +121,6 @@ exports.WorkerSortableFieldsSchema = zod_1.z
     'email',
     'phone',
     'postcode',
-    'availability',
     'englishLevel',
     'nationality',
     'hasTools',
@@ -43,12 +135,42 @@ exports.WorkerSortableFieldsSchema = zod_1.z
     'createdByName',
     'createdAt',
     'updatedAt',
+    'workedCount',
+    'noShowCount',
 ])
     .openapi({ title: 'WorkerSortableFields' });
+/** Maps sort field values to ability field paths on SortWorkerSchema. */
+exports.WorkerSortFieldMapping = {
+    nameSimilarity: 'nameSimilarity',
+    fullName: 'fullName',
+    distance: 'distance',
+    email: 'email',
+    phone: 'phone',
+    postcode: 'postcode',
+    englishLevel: 'englishLevel',
+    nationality: 'nationality',
+    hasTools: 'hasTools',
+    hasPpe: 'hasPpe',
+    transportation: 'transportation',
+    dateOfBirth: 'dateOfBirth',
+    mainTrade: 'mainTrade',
+    bio: 'bio',
+    qualificationsCount: 'qualificationsCount',
+    nino: 'nino',
+    shareCodeExpiry: 'shareCodeExpiry',
+    createdByName: 'createdByName',
+    createdAt: 'createdAt',
+    updatedAt: 'updatedAt',
+};
 exports.BooleanFilterSchema = zod_1.z
-    .enum(['only_with', 'only_without', 'all'])
+    .enum(['only_with', 'only_without', 'unknown', 'all'])
     .default('all')
     .openapi({ title: 'BooleanFilter' });
+exports.OfferOpennessSchema = zod_1.z.enum([
+    'ACTIVELY_LOOKING',
+    'OPEN',
+    'NOT_INTERESTED',
+]);
 // --- Nested Schemas ---
 exports.WorkerPhoneNumberSchema = common_schemas_1.PhoneNumberResponseSchema.openapi({
     title: 'WorkerPhoneNumber',
@@ -59,6 +181,33 @@ exports.CreateWorkerPhoneNumberSchema = common_schemas_1.CreatePhoneNumberSchema
 exports.UpsertWorkerPhoneNumberSchema = common_schemas_1.UpsertPhoneNumberSchema.openapi({
     title: 'UpsertWorkerPhoneNumber',
 });
+exports.AvailabilityConflictWorkerSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string().nullable().optional(),
+    createdByUserId: zod_1.z.string().uuid().nullable().optional(),
+    /**
+     * True when a submit using this email/phone would be rejected by the
+     * database (workers.email is globally unique; worker_phone_numbers is
+     * unique per (phoneNumber, createdByUserId)). When false the conflict is
+     * informational and submission is allowed.
+     */
+    blocking: zod_1.z.boolean(),
+})
+    .openapi({ title: 'AvailabilityConflictWorker' });
+exports.CheckWorkerAvailabilityQuerySchema = zod_1.z.object({
+    email: zod_1.z.string().trim().email().optional(),
+    phoneNumber: zod_1.z.string().min(1).optional(),
+    excludeWorkerId: zod_1.z.string().uuid().optional(),
+});
+exports.CheckWorkerAvailabilityResponseSchema = zod_1.z
+    .object({
+    email: exports.AvailabilityConflictWorkerSchema.nullable(),
+    phoneNumber: exports.AvailabilityConflictWorkerSchema.nullable(),
+    workerLeadAttributionMatch: exports.WorkerLeadAttributionMatchSchema.nullable().optional(),
+})
+    .openapi({ title: 'CheckWorkerAvailabilityResponse' });
 exports.WorkerTradeSchema = zod_1.z
     .object({
     id: zod_1.z.string().uuid().optional(),
@@ -93,6 +242,7 @@ exports.WorkerQualificationSchema = zod_1.z
         .nullable()
         .describe('Reference Number'),
     proofDocumentFileId: zod_1.z.string().uuid().optional().nullable(),
+    createdAt: zod_1.z.coerce.date().optional(),
 })
     .openapi({ title: 'WorkerQualification' });
 exports.CreateWorkerQualificationSchema = zod_1.z
@@ -111,17 +261,11 @@ exports.CreateWorkerQualificationSchema = zod_1.z
 })
     .openapi({ title: 'CreateWorkerQualification' });
 // ─── ID Document ────────────────────────────────────────────────────────────
-exports.IdDocumentTypeSchema = zod_1.z.enum([
-    'passport',
-    'id_card',
-    'driving_license',
-    'unknown',
-]);
 exports.WorkerIdDocumentSchema = zod_1.z
     .object({
     id: zod_1.z.string().uuid().optional(),
     fileId: zod_1.z.string().uuid().nullable().optional(),
-    documentType: exports.IdDocumentTypeSchema.nullable().optional(),
+    documentType: common_schemas_1.IdDocumentTypeSchema.nullable().optional(),
     expiryDate: zod_1.z
         .union([zod_1.z.string().date(), zod_1.z.date()])
         .transform((val) => val instanceof Date ? val.toISOString().split('T')[0] : val)
@@ -141,7 +285,7 @@ exports.WorkerIdDocumentSchema = zod_1.z
 exports.CreateWorkerIdDocumentSchema = zod_1.z
     .object({
     fileId: zod_1.z.string().uuid().nullable().optional(),
-    documentType: exports.IdDocumentTypeSchema.nullable().optional(),
+    documentType: common_schemas_1.IdDocumentTypeSchema.nullable().optional(),
     expiryDate: zod_1.z.string().date().nullable().optional(),
     documentNumber: zod_1.z.string().max(100).nullable().optional(),
 })
@@ -165,6 +309,7 @@ exports.ShareCodeSchema = zod_1.z
         .optional()
         .nullable()
         .describe('Enter expiry date for the share code'),
+    fileId: zod_1.z.string().uuid().optional().nullable(),
 })
     .openapi({
     title: 'ShareCode',
@@ -214,16 +359,7 @@ exports.WorkerLiveStatusSchema = zod_1.z.object({
     bookingId: zod_1.z.string().uuid().nullable().optional(),
     active: zod_1.z
         .object({
-        statusSa: zod_1.z.enum([
-            'PENDING',
-            'ACTIVE',
-            'VACATION',
-            'LEFT_THE_SITE',
-            'MEDICAL_LEAVE',
-            'DAY_OFF',
-            'INJURY',
-        ]),
-        statusFa: zod_1.z.enum([
+        status: zod_1.z.enum([
             'PENDING',
             'ACTIVE',
             'VACATION',
@@ -231,11 +367,21 @@ exports.WorkerLiveStatusSchema = zod_1.z.object({
             'MEDICAL_LEAVE',
             'DAY_OFF',
             'INJURY',
+            'OFF_SCHEDULE',
         ]),
     })
         .nullable()
         .optional(),
     activeId: zod_1.z.string().uuid().nullable().optional(),
+    bookingAgent: zod_1.z
+        .object({
+        id: zod_1.z.string().uuid(),
+        firstName: zod_1.z.string(),
+        lastName: zod_1.z.string(),
+    })
+        .nullable()
+        .optional()
+        .describe('Agent who created the active booking'),
 });
 // --- Main Schemas ---
 exports.WorkerSchema = zod_1.z
@@ -276,25 +422,48 @@ exports.WorkerSchema = zod_1.z
     nationality: common_schemas_1.NationalitySchema.nullable()
         .optional()
         .describe('Nationality'),
-    hasTools: zod_1.z.boolean().describe('Has Tools'),
-    hasPpe: zod_1.z.boolean().describe('Has PPE'),
+    hasTools: zod_1.z.boolean().nullable().describe('Has Tools'),
+    hasPpe: zod_1.z.boolean().nullable().describe('Has PPE'),
     transportation: common_schemas_1.TransportationSchema.nullable()
         .optional()
         .describe('Transportation'),
     location: common_schemas_1.LocationDetailsSchema.nullable().optional().describe('Location'),
+    locationId: zod_1.z
+        .string()
+        .uuid()
+        .nullable()
+        .optional()
+        .describe('Location ID (FK) — lets a picked worker location be copied on merge'),
     shareCode: exports.ShareCodeSchema.optional().nullable().describe('Share Code'),
     liveStatus: exports.WorkerLiveStatusSchema.optional().describe('Live Status'),
-    availability: exports.AvailabilitySchema.describe('Availability'),
+    offerOpenness: exports.OfferOpennessSchema.default('OPEN'),
+    offerOpennessSetAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((v) => (v instanceof Date ? v.toISOString() : v))
+        .nullable()
+        .optional(),
+    offerNote: zod_1.z.string().nullable().optional(),
+    offerNoteUpdatedAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((v) => (v instanceof Date ? v.toISOString() : v))
+        .nullable()
+        .optional(),
     curatedWorkerId: zod_1.z
         .string()
         .uuid()
         .nullable()
         .optional()
         .describe('Curated Worker ID'),
-    effectiveStatus: zod_1.z
-        .union([exports.AvailabilitySchema, curated_workers_contract_1.CuratedWorkerStatusSchema])
+    blacklistReason: zod_1.z
+        .string()
+        .nullable()
         .optional()
-        .describe('Effective status (inherited from curated worker when linked)'),
+        .describe('Blacklist reason from curated worker'),
+    occupancyStatus: exports.OccupancyStatusSchema.describe('Booking-derived occupancy; null when the worker has no live booking').optional(),
+    suppression: contact_suppressions_contract_1.SuppressionStateSchema,
+    // findAll parses with this schema (not WorkerListItemSchema) — list
+    // fields must exist here too or Zod strips them from every row.
+    source: exports.WorkerSourceSchema.optional(),
     createdByUserId: zod_1.z
         .string()
         .uuid()
@@ -303,6 +472,25 @@ exports.WorkerSchema = zod_1.z
         .describe('Created By User ID'),
     createdBy: users_contract_1.UserSchema.nullable().optional().describe('Created By User'),
     distanceKm: zod_1.z.number().nullable().optional().describe('Distance in KM'),
+    // Travel time to the proximityJobId job (book-workers flow). Mirrored from
+    // WorkerListItemSchema because the findAll controller parses its response with
+    // PaginatedWorkerResponseSchema (built on THIS schema) — fields absent here are
+    // stripped before the response is sent, even though the contract declares
+    // WorkerListItemSchema for findAll.
+    driveMinutes: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Driving minutes (free-flow) to the proximityJobId job; null = beyond the routing cap.'),
+    transitMinutes: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Public-transport minutes to the proximityJobId job; null = beyond the routing cap.'),
+    travelTimeEnriched: zod_1.z
+        .boolean()
+        .optional()
+        .describe('True when the (proximityJobId, worker) lead_proximity_owned row is enriched; gates the travel chips.'),
     crew: crews_contract_1.CrewSummarySchema.nullable().optional().describe('Crew'),
     createdAt: zod_1.z
         .union([zod_1.z.string().datetime(), zod_1.z.date()])
@@ -312,33 +500,144 @@ exports.WorkerSchema = zod_1.z
         .union([zod_1.z.string().datetime(), zod_1.z.date()])
         .transform((val) => (val instanceof Date ? val.toISOString() : val))
         .describe('Last Update Date'),
+    bookingHistory: booking_history_schema_1.BookingHistorySchema.optional(),
 })
     .openapi({ title: 'Worker' });
+/**
+ * Lightweight schema for worker list views (table rows / cards).
+ * Excludes heavy fields not needed in lists: curatedWorkerId, createdByUserId.
+ * Uses UserSummarySchema for createdBy instead of full UserSchema.
+ * Includes idDocuments (already batch-loaded by findAll, no N+1) so rows can
+ * decide whether to show the "Documents" button without a per-row fetch.
+ */
+exports.WorkerListItemSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid().describe('Worker ID'),
+    firstName: zod_1.z.string().describe('First Name'),
+    lastName: zod_1.z.string().optional().nullable().describe('Last Name'),
+    email: zod_1.z.string().email().nullable().optional().describe('Email'),
+    phoneNumbers: zod_1.z
+        .array(exports.WorkerPhoneNumberSchema)
+        .optional()
+        .default([])
+        .describe('Phone Numbers'),
+    nino: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('National Insurance Number'),
+    dateOfBirth: zod_1.z
+        .union([zod_1.z.string().date(), zod_1.z.date()])
+        .transform((val) => val instanceof Date ? val.toISOString().split('T')[0] : val)
+        .nullable()
+        .optional()
+        .describe('Date of Birth'),
+    bio: zod_1.z.string().nullable().optional().describe('Bio'),
+    trades: zod_1.z.array(exports.WorkerTradeSchema).optional().describe('Trades'),
+    qualifications: zod_1.z
+        .array(exports.WorkerQualificationSchema)
+        .optional()
+        .describe('Qualifications'),
+    idDocuments: zod_1.z
+        .array(exports.WorkerIdDocumentSchema)
+        .optional()
+        .describe('ID Documents'),
+    englishLevel: common_schemas_1.EnglishLevelSchema.nullable()
+        .optional()
+        .describe('English Level'),
+    nationality: common_schemas_1.NationalitySchema.nullable()
+        .optional()
+        .describe('Nationality'),
+    hasTools: zod_1.z.boolean().nullable().describe('Has Tools'),
+    hasPpe: zod_1.z.boolean().nullable().describe('Has PPE'),
+    transportation: common_schemas_1.TransportationSchema.nullable()
+        .optional()
+        .describe('Transportation'),
+    location: common_schemas_1.LocationDetailsSchema.nullable().optional().describe('Location'),
+    shareCode: exports.ShareCodeSchema.optional().nullable().describe('Share Code'),
+    liveStatus: exports.WorkerLiveStatusSchema.optional().describe('Live Status'),
+    offerOpenness: exports.OfferOpennessSchema.default('OPEN'),
+    offerOpennessSetAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((v) => (v instanceof Date ? v.toISOString() : v))
+        .nullable()
+        .optional(),
+    offerNote: zod_1.z.string().nullable().optional(),
+    offerNoteUpdatedAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((v) => (v instanceof Date ? v.toISOString() : v))
+        .nullable()
+        .optional(),
+    blacklistReason: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Blacklist reason from curated worker'),
+    occupancyStatus: exports.OccupancyStatusSchema.describe('Booking-derived occupancy; null when the worker has no live booking').optional(),
+    suppression: contact_suppressions_contract_1.SuppressionStateSchema,
+    createdBy: summary_schemas_1.UserSummarySchema.nullable().optional().describe('Created By'),
+    createdByUserId: zod_1.z
+        .string()
+        .uuid()
+        .nullable()
+        .optional()
+        .describe('Owning agent id — needed client-side for the CASL "update Worker" ownership check (createdByUserId === user.id) that gates inline edit controls + the Edit action.'),
+    distanceKm: zod_1.z.number().nullable().optional().describe('Distance in KM'),
+    crew: crews_contract_1.CrewSummarySchema.nullable().optional().describe('Crew'),
+    createdAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .describe('Creation Date'),
+    updatedAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .describe('Last Update Date'),
+    source: exports.WorkerSourceSchema.optional(),
+    driveMinutes: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Driving minutes (free-flow) to the proximityJobId job; null = beyond the routing cap. Only present when proximityJobId was queried and the (job, worker) pair is travel-time enriched.'),
+    transitMinutes: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Public-transport minutes to the proximityJobId job; null = beyond the routing cap. Only present when proximityJobId was queried and the (job, worker) pair is travel-time enriched.'),
+    travelTimeEnriched: zod_1.z
+        .boolean()
+        .optional()
+        .describe('True when a lead_proximity_owned row for (proximityJobId, worker) exists and has been enriched (enriched_at set). Gates whether the travel chips render — distinguishes "beyond cap" (null minutes) from "no data yet".'),
+    bookingHistory: booking_history_schema_1.BookingHistorySchema.optional(),
+})
+    .openapi({ title: 'WorkerListItem' });
 exports.CreateWorkerSchema = zod_1.z
     .object({
-    firstName: zod_1.z.string().min(3).max(100).describe('First Name'),
+    firstName: zod_1.z.string().trim().min(3).max(100).describe('First Name'),
     lastName: zod_1.z
-        .string()
-        .min(3)
-        .max(100)
-        .nullish()
-        .or(zod_1.z.literal(''))
+        .preprocess((val) => (typeof val === 'string' ? val.trim() : val), zod_1.z.string().min(3).max(100).nullish().or(zod_1.z.literal('')))
         .transform((val) => (val === '' ? null : val))
         .describe('Last Name'),
     email: zod_1.z
+        .preprocess((val) => (typeof val === 'string' ? val.trim() : val), zod_1.z.string().email().nullish().or(zod_1.z.literal('')))
+        .transform((val) => (val === '' ? undefined : val))
+        .describe('Email'),
+    nationality: common_schemas_1.NationalitySchema.optional()
+        .nullable()
+        .describe('Nationality'),
+    crewId: zod_1.z
         .string()
-        .email()
-        .nullish()
+        .uuid()
+        .optional()
         .or(zod_1.z.literal(''))
         .transform((val) => (val === '' ? undefined : val))
-        .describe('Email'),
+        .describe('Crew ID'),
     phoneNumbers: zod_1.z
         .array(exports.CreateWorkerPhoneNumberSchema)
         .describe('Phone Numbers'),
-    crewId: zod_1.z.string().uuid().optional().describe('Crew ID'),
     nino: zod_1.z
         .string()
-        .regex(/^(?:[A-Z]{2}[0-9]{6}[A-D])?$/)
+        .regex(/^(?:(?!BG|GB|NK|KN|TN|NT|ZZ)[A-CEGHJ-PR-TW-Z][A-CEGHJ-NPR-TW-Z]\s?[0-9]{2}\s?[0-9]{2}\s?[0-9]{2}\s?[A-Z])?$/)
+        .transform((val) => val?.replace(/\s/g, ''))
         .optional()
         .nullable()
         .describe('National Insurance Number'),
@@ -365,19 +664,15 @@ exports.CreateWorkerSchema = zod_1.z
     englishLevel: common_schemas_1.EnglishLevelSchema.optional()
         .nullable()
         .describe('English Level'),
-    nationality: common_schemas_1.NationalitySchema.optional()
-        .nullable()
-        .describe('Nationality'),
-    hasTools: zod_1.z.boolean().describe('Has Tools'),
-    hasPpe: zod_1.z.boolean().describe('Has PPE'),
+    hasTools: zod_1.z.boolean().nullable().optional().describe('Has Tools'),
+    hasPpe: zod_1.z.boolean().nullable().optional().describe('Has PPE'),
     transportation: common_schemas_1.TransportationSchema.optional()
         .nullable()
         .describe('Transportation'),
     location: common_schemas_1.CreateLocationSchema.optional().nullable().describe('Location'),
     shareCode: exports.ShareCodeSchema.optional().nullable().describe('Share Code'),
-    availability: exports.AvailabilitySchema.optional()
-        .default('AVAILABLE')
-        .describe('Availability'),
+    offerOpenness: exports.OfferOpennessSchema.optional().default('OPEN'),
+    offerNote: zod_1.z.string().nullable().optional(),
 })
     .openapi({ title: 'CreateWorker' });
 /**
@@ -385,7 +680,7 @@ exports.CreateWorkerSchema = zod_1.z
  * Used as the contract endpoint body. The base CreateWorkerSchema remains
  * a plain ZodObject so it can be .extend()-ed in the frontend.
  */
-exports.CreateWorkerBodySchema = exports.CreateWorkerSchema.superRefine((data, ctx) => {
+function validateCreateWorkerPhones(data, ctx) {
     if (!data.crewId) {
         if (data.phoneNumbers.length < 1) {
             ctx.addIssue({
@@ -393,7 +688,7 @@ exports.CreateWorkerBodySchema = exports.CreateWorkerSchema.superRefine((data, c
                 minimum: 1,
                 type: 'array',
                 inclusive: true,
-                message: 'At least one phone number is required',
+                message: 'A worker phone number is required when worker is not part of a crew',
                 path: ['phoneNumbers'],
             });
         }
@@ -413,36 +708,56 @@ exports.CreateWorkerBodySchema = exports.CreateWorkerSchema.superRefine((data, c
             path: ['phoneNumbers'],
         });
     }
-});
+}
+exports.CreateWorkerBodySchema = exports.CreateWorkerSchema.superRefine(validateCreateWorkerPhones);
+/**
+ * The single-create request may explicitly retire a challenge returned by its
+ * preceding submit. This attempt metadata is never part of the worker payload
+ * and is intentionally unavailable to batch/import requests.
+ */
+exports.CreateSingleWorkerBodySchema = exports.CreateWorkerSchema.extend({
+    supersedesAttributionChallengeId: zod_1.z.string().uuid().optional(),
+}).superRefine(validateCreateWorkerPhones);
 exports.UpdateWorkerSchema = zod_1.z
     .object({
-    firstName: zod_1.z.string().min(3).max(100).optional().describe('First Name'),
-    lastName: zod_1.z
+    firstName: zod_1.z
         .string()
+        .trim()
         .min(3)
         .max(100)
-        .nullish()
-        .or(zod_1.z.literal(''))
+        .optional()
+        .describe('First Name'),
+    lastName: zod_1.z
+        .preprocess((val) => (typeof val === 'string' ? val.trim() : val), zod_1.z.string().min(3).max(100).nullish().or(zod_1.z.literal('')))
         .transform((val) => (val === '' ? null : val))
         .describe('Last Name'),
     email: zod_1.z
-        .string()
-        .email()
-        .nullish()
-        .or(zod_1.z.literal(''))
+        .preprocess((val) => (typeof val === 'string' ? val.trim() : val), zod_1.z.string().email().nullish().or(zod_1.z.literal('')))
         .transform((val) => (val === '' ? undefined : val))
         .describe('Email'),
+    nationality: common_schemas_1.NationalitySchema.optional()
+        .nullable()
+        .describe('Nationality'),
+    crewId: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .nullable()
+        .or(zod_1.z.literal(''))
+        .transform((val) => (val === '' ? null : val))
+        .describe('Crew ID'),
     phoneNumbers: zod_1.z
         .array(exports.UpsertWorkerPhoneNumberSchema)
-        .min(1, { message: 'At least one phone number is required' })
-        .refine((phoneNumbers) => phoneNumbers.some((phone) => phone.isPrimary), {
+        .refine((phoneNumbers) => phoneNumbers.length === 0 ||
+        phoneNumbers.some((phone) => phone.isPrimary), {
         message: 'Must have at least one primary phone number',
     })
         .optional()
         .describe('Phone Numbers'),
     nino: zod_1.z
         .string()
-        .regex(/^(?:[A-Z]{2}[0-9]{6}[A-D])?$/)
+        .regex(/^(?:(?!BG|GB|NK|KN|TN|NT|ZZ)[A-CEGHJ-PR-TW-Z][A-CEGHJ-NPR-TW-Z]\s?[0-9]{2}\s?[0-9]{2}\s?[0-9]{2}\s?[A-Z])?$/)
+        .transform((val) => val?.replace(/\s/g, ''))
         .optional()
         .nullable()
         .describe('National Insurance Number'),
@@ -469,19 +784,46 @@ exports.UpdateWorkerSchema = zod_1.z
     englishLevel: common_schemas_1.EnglishLevelSchema.optional()
         .nullable()
         .describe('English Level'),
-    nationality: common_schemas_1.NationalitySchema.optional()
-        .nullable()
-        .describe('Nationality'),
-    hasTools: zod_1.z.boolean().optional().describe('Has Tools'),
-    hasPpe: zod_1.z.boolean().optional().describe('Has PPE'),
+    hasTools: zod_1.z.boolean().nullable().optional().describe('Has Tools'),
+    hasPpe: zod_1.z.boolean().nullable().optional().describe('Has PPE'),
     transportation: common_schemas_1.TransportationSchema.optional()
         .nullable()
         .describe('Transportation'),
     location: common_schemas_1.CreateLocationSchema.optional().nullable().describe('Location'),
     shareCode: exports.ShareCodeSchema.optional().nullable().describe('Share Code'),
-    availability: exports.AvailabilitySchema.optional().describe('Availability'),
+    offerOpenness: exports.OfferOpennessSchema.optional(),
+    offerNote: zod_1.z.string().nullable().optional(),
 })
     .openapi({ title: 'UpdateWorker' });
+/**
+ * UpdateWorkerSchema with crew-aware phone number validation.
+ * Used as the contract endpoint body. Mirrors CreateWorkerBodySchema pattern.
+ *
+ * When phoneNumbers is provided (not undefined):
+ * - Standalone workers (no crewId): must have at least 1 phone with a primary
+ * - Crew members (has crewId): phone numbers optional, but if provided must have a primary
+ *
+ * When phoneNumbers is omitted (undefined): no phone validation runs.
+ */
+exports.UpdateWorkerBodySchema = exports.UpdateWorkerSchema.superRefine((data, ctx) => {
+    // Only validate phone numbers if they are explicitly provided
+    if (data.phoneNumbers === undefined)
+        return;
+    if (!data.crewId) {
+        // Standalone worker: must have at least one phone number
+        if (data.phoneNumbers.length < 1) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.too_small,
+                minimum: 1,
+                type: 'array',
+                inclusive: true,
+                message: 'At least one phone number is required',
+                path: ['phoneNumbers'],
+            });
+        }
+    }
+    // Primary phone check is already handled by the base schema's refine
+});
 // --- Curated Worker Linking Schemas ---
 exports.WorkerMatchSummarySchema = zod_1.z
     .object({
@@ -519,7 +861,9 @@ exports.CuratedWorkerMatchSummarySchema = zod_1.z
         .optional()
         .default([])
         .describe('Phone Numbers'),
-    status: curated_workers_contract_1.CuratedWorkerStatusSchema.describe('Status'),
+    blacklisted: zod_1.z
+        .boolean()
+        .describe('Whether the curated worker is blacklisted'),
 })
     .openapi({ title: 'CuratedWorkerMatchSummary' });
 exports.MatchFieldSchema = zod_1.z.enum(['NINO', 'EMAIL', 'PHONE']);
@@ -549,6 +893,25 @@ exports.SuggestCuratedMatchesResponseSchema = zod_1.z
     limit: zod_1.z.number().describe('Items per page'),
 })
     .openapi({ title: 'SuggestCuratedMatchesResponse' });
+exports.CuratedMatchGroupSchema = zod_1.z
+    .object({
+    curatedWorker: exports.CuratedWorkerMatchSummarySchema,
+    workers: zod_1.z.array(zod_1.z.object({
+        worker: exports.WorkerMatchSummarySchema,
+        matchedOn: zod_1.z.array(exports.MatchFieldSchema),
+        confidence: exports.MatchConfidenceSchema,
+    })),
+})
+    .openapi({ title: 'CuratedMatchGroup' });
+exports.SuggestCuratedMatchGroupsResponseSchema = zod_1.z
+    .object({
+    groups: zod_1.z.array(exports.CuratedMatchGroupSchema),
+    totalGroups: zod_1.z.number(),
+    totalPages: zod_1.z.number(),
+    page: zod_1.z.number(),
+    limit: zod_1.z.number(),
+})
+    .openapi({ title: 'SuggestCuratedMatchGroupsResponse' });
 exports.LinkWorkerSchema = zod_1.z
     .object({
     curatedWorkerId: zod_1.z.string().uuid().describe('Curated Worker ID to link to'),
@@ -560,40 +923,162 @@ exports.LinkWorkerResponseSchema = zod_1.z
     curatedWorkerId: zod_1.z.string().uuid().describe('Linked Curated Worker ID'),
 })
     .openapi({ title: 'LinkWorkerResponse' });
-exports.MergeFieldSchema = zod_1.z.enum([
+exports.ScalarMergeFieldSchema = zod_1.z.enum([
     'firstName',
     'lastName',
     'email',
     'nino',
     'dateOfBirth',
     'bio',
-    'rating',
     'hasTools',
     'hasPpe',
     'englishLevel',
     'nationality',
     'locationId',
     'transportation',
-    'phoneNumbers',
-    'trades',
-    'qualifications',
 ]);
 exports.LinkWithMergeSchema = zod_1.z
     .object({
     curatedWorkerId: zod_1.z.string().uuid().describe('Curated Worker ID to link to'),
-    mergeFields: zod_1.z
-        .array(exports.MergeFieldSchema)
-        .min(0)
-        .describe('Fields to overwrite on curated worker from worker data'),
+    scalarFields: zod_1.z
+        .array(exports.ScalarMergeFieldSchema)
+        .optional()
+        .default([])
+        .describe('Scalar fields to overwrite on curated worker from worker data'),
+    phoneNumbers: zod_1.z
+        .array(zod_1.z.object({
+        phoneNumber: common_schemas_1.PhoneSchema,
+        isPrimary: zod_1.z.boolean(),
+        description: zod_1.z.string().nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    trades: zod_1.z
+        .array(zod_1.z.object({
+        tradeId: zod_1.z.string().uuid(),
+        mainTrade: zod_1.z.boolean(),
+    }))
+        .optional()
+        .default([]),
+    qualifications: zod_1.z
+        .array(zod_1.z.object({
+        qualificationId: zod_1.z.string().uuid(),
+        qualificationTypeId: zod_1.z.string().uuid().nullable().optional(),
+        issueDate: zod_1.z.string().date().nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+        referenceNumber: zod_1.z.string().nullable().optional(),
+        proofDocumentFileId: zod_1.z.string().uuid().nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    idDocuments: zod_1.z
+        .array(zod_1.z.object({
+        fileId: zod_1.z.string().uuid().nullable().optional(),
+        documentType: common_schemas_1.IdDocumentTypeSchema.nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+        documentNumber: zod_1.z.string().max(100).nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    shareCode: zod_1.z
+        .object({
+        code: zod_1.z.string().nullable().optional(),
+        expiryDate: zod_1.z.string().nullable().optional(),
+        fileId: zod_1.z.string().uuid().nullable().optional(),
+    })
+        .nullable()
+        .optional(),
 })
     .openapi({ title: 'LinkWithMerge' });
 exports.LinkWithMergeResponseSchema = zod_1.z
     .object({
     workerId: zod_1.z.string().uuid().describe('Worker ID'),
     curatedWorkerId: zod_1.z.string().uuid().describe('Linked Curated Worker ID'),
-    mergedFields: zod_1.z.array(exports.MergeFieldSchema).describe('Fields that were merged'),
+    mergedScalarFields: zod_1.z
+        .array(exports.ScalarMergeFieldSchema)
+        .describe('Scalar fields that were merged'),
+    added: zod_1.z
+        .object({
+        phoneNumbers: zod_1.z.number().int(),
+        trades: zod_1.z.number().int(),
+        qualifications: zod_1.z.number().int(),
+        idDocuments: zod_1.z.number().int(),
+    })
+        .describe('Counts of relation items added to the curated worker'),
 })
     .openapi({ title: 'LinkWithMergeResponse' });
+exports.LinkWorkersWithMergeSchema = zod_1.z
+    .object({
+    curatedWorkerId: zod_1.z
+        .string()
+        .uuid()
+        .describe('Existing curated worker to update + link to'),
+    workerIds: zod_1.z
+        .array(zod_1.z.string().uuid())
+        .min(1)
+        .max(100)
+        .describe('Unmatched workers to link to the curated worker'),
+    // Resolved final values for the curated record (picked across workers + curated)
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string(),
+    email: zod_1.z.string().nullable().optional(),
+    nino: zod_1.z.string().nullable().optional(),
+    dateOfBirth: zod_1.z.string().date().nullable().optional(),
+    bio: zod_1.z.string().nullable().optional(),
+    hasTools: zod_1.z.boolean().nullable(),
+    hasPpe: zod_1.z.boolean().nullable(),
+    englishLevel: zod_1.z.string().nullable().optional(),
+    nationality: zod_1.z.string().nullable().optional(),
+    locationId: zod_1.z.string().uuid().nullable().optional(),
+    transportation: common_schemas_1.TransportationSchema.nullable().optional(),
+    phoneNumbers: zod_1.z
+        .array(zod_1.z.object({
+        phoneNumber: common_schemas_1.PhoneSchema,
+        isPrimary: zod_1.z.boolean(),
+        description: zod_1.z.string().nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    trades: zod_1.z
+        .array(zod_1.z.object({ tradeId: zod_1.z.string().uuid(), mainTrade: zod_1.z.boolean() }))
+        .optional()
+        .default([]),
+    qualifications: zod_1.z
+        .array(zod_1.z.object({
+        qualificationId: zod_1.z.string().uuid(),
+        qualificationTypeId: zod_1.z.string().uuid().nullable().optional(),
+        issueDate: zod_1.z.string().date().nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+        referenceNumber: zod_1.z.string().nullable().optional(),
+        proofDocumentFileId: zod_1.z.string().uuid().nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    idDocuments: zod_1.z
+        .array(zod_1.z.object({
+        fileId: zod_1.z.string().uuid().nullable().optional(),
+        documentType: common_schemas_1.IdDocumentTypeSchema.nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+        documentNumber: zod_1.z.string().max(100).nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    shareCode: zod_1.z
+        .object({
+        code: zod_1.z.string().nullable().optional(),
+        expiryDate: zod_1.z.string().nullable().optional(),
+        fileId: zod_1.z.string().uuid().nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+})
+    .openapi({ title: 'LinkWorkersWithMerge' });
+exports.LinkWorkersWithMergeResponseSchema = zod_1.z
+    .object({
+    curatedWorkerId: zod_1.z.string().uuid(),
+    linkedWorkerIds: zod_1.z.array(zod_1.z.string().uuid()),
+})
+    .openapi({ title: 'LinkWorkersWithMergeResponse' });
 exports.BulkLinkWorkersSchema = zod_1.z
     .object({
     links: zod_1.z
@@ -611,6 +1096,59 @@ exports.BulkLinkWorkersResponseSchema = zod_1.z
     linked: zod_1.z.number().describe('Number of workers linked'),
 })
     .openapi({ title: 'BulkLinkWorkersResponse' });
+// ---------------------------------------------------------------------------
+// Batch create
+// ---------------------------------------------------------------------------
+exports.BatchCreateWorkersBodySchema = zod_1.z
+    .object({
+    workers: zod_1.z
+        .array(exports.CreateWorkerBodySchema)
+        .min(1)
+        .max(100)
+        .describe('Array of workers to create'),
+})
+    .openapi({ title: 'BatchCreateWorkers' });
+exports.BatchCreateWorkerResultSchema = zod_1.z
+    .discriminatedUnion('status', [
+    zod_1.z
+        .object({
+        index: zod_1.z.number().int().min(0),
+        status: zod_1.z.literal('SUCCESS'),
+        workerId: zod_1.z.string().uuid(),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        index: zod_1.z.number().int().min(0),
+        status: zod_1.z.literal('FAILED'),
+        error: zod_1.z.string(),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        index: zod_1.z.number().int().min(0),
+        status: zod_1.z.literal('ATTRIBUTION_REQUIRED'),
+        challenge: exports.WorkerSourceAttributionChallengeSchema,
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        index: zod_1.z.number().int().min(0),
+        status: zod_1.z.literal('IDENTITY_CONFLICT'),
+        identityConflict: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictReferenceSchema,
+    })
+        .strict(),
+])
+    .openapi({ title: 'BatchCreateWorkerResult' });
+exports.BatchCreateWorkersResponseSchema = zod_1.z
+    .object({
+    results: zod_1.z
+        .array(exports.BatchCreateWorkerResultSchema)
+        .describe('Per-worker results'),
+    created: zod_1.z.number().describe('Total workers successfully created'),
+})
+    .strict()
+    .openapi({ title: 'BatchCreateWorkersResponse' });
 exports.PromoteWorkerResponseSchema = zod_1.z
     .object({
     workerId: zod_1.z.string().uuid().describe('Worker ID'),
@@ -620,6 +1158,69 @@ exports.PromoteWorkerResponseSchema = zod_1.z
         .describe('Newly created Curated Worker ID'),
 })
     .openapi({ title: 'PromoteWorkerResponse' });
+exports.BulkPromoteUnmatchedPreviewResponseSchema = zod_1.z
+    .object({
+    unmatchedWorkerCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unlinked workers with no suggested curated match'),
+    skippedNoPhoneCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unmatched workers excluded because they have no phone number'),
+    skippedSharedPhoneCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unmatched, phone-bearing workers excluded because their phone is shared with another worker (need manual merge)'),
+    eligibleWorkerCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unmatched workers with a unique phone number that will be promoted'),
+    resultingCuratedWorkerCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Curated workers that would be created (one per unique-phone worker)'),
+})
+    .openapi({ title: 'BulkPromoteUnmatchedPreviewResponse' });
+exports.BulkPromoteUnmatchedResponseSchema = zod_1.z
+    .object({
+    createdCuratedWorkerCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Curated workers created'),
+    linkedWorkerCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Workers linked to a newly created curated worker'),
+    skippedNoPhoneCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unmatched workers skipped for having no phone number'),
+    skippedSharedPhoneCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Unmatched workers skipped because their phone is shared with another worker (need manual merge)'),
+    skippedAlreadyLinkedCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Workers skipped because they were linked between preview and execute'),
+    failedGroupCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Groups whose transaction failed and were rolled back'),
+})
+    .openapi({ title: 'BulkPromoteUnmatchedResponse' });
 exports.FilterSuggestedMatchesSchema = pagination_query_schema_1.PaginationQuerySchema.extend({
     matchField: exports.MatchFieldSchema.optional().describe('Filter by match field tab'),
     sortBy: zod_1.z
@@ -644,18 +1245,23 @@ exports.DuplicateGroupWorkerSchema = zod_1.z
     email: zod_1.z.string().nullable().optional(),
     nino: zod_1.z.string().nullable().optional(),
     dateOfBirth: zod_1.z.coerce.date().nullable().optional(),
-    hasTools: zod_1.z.boolean().optional().default(false),
-    hasPpe: zod_1.z.boolean().optional().default(false),
+    hasTools: zod_1.z.boolean().nullable().optional().default(null),
+    hasPpe: zod_1.z.boolean().nullable().optional().default(null),
     bio: zod_1.z.string().nullable().optional(),
     englishLevel: common_schemas_1.EnglishLevelSchema.nullable().optional(),
     nationality: common_schemas_1.NationalitySchema.nullable().optional(),
     locationId: zod_1.z.string().uuid().nullable().optional(),
+    location: summary_schemas_1.LocationSummarySchema.nullable().optional(),
     transportation: common_schemas_1.TransportationSchema.nullable().optional(),
     phoneNumbers: zod_1.z.array(exports.WorkerPhoneNumberSchema).optional().default([]),
     trades: zod_1.z.array(exports.WorkerTradeSchema).optional().default([]),
     qualifications: zod_1.z.array(exports.WorkerQualificationSchema).optional().default([]),
+    idDocuments: zod_1.z.array(exports.WorkerIdDocumentSchema).optional().default([]),
+    shareCode: exports.ShareCodeSchema.nullable().optional().describe('Share Code'),
     createdByUserId: zod_1.z.string().uuid().nullable().optional(),
+    createdBy: summary_schemas_1.UserSummarySchema.nullable().optional().describe('Created By'),
     createdAt: zod_1.z.coerce.date(),
+    updatedAt: zod_1.z.coerce.date(),
 })
     .openapi({ title: 'DuplicateGroupWorker' });
 exports.DuplicateGroupSchema = zod_1.z
@@ -696,6 +1302,31 @@ exports.FindDuplicatesSummaryResponseSchema = zod_1.z
     limit: zod_1.z.number(),
 })
     .openapi({ title: 'FindDuplicatesSummaryResponse' });
+exports.FindWorkersByPhonesBodySchema = zod_1.z
+    .object({
+    phones: zod_1.z
+        .array(zod_1.z.string())
+        .min(1)
+        .max(500)
+        .describe('Phone numbers to look up'),
+})
+    .openapi({ title: 'FindWorkersByPhonesBody' });
+exports.WorkerPhoneLookupResultSchema = zod_1.z
+    .object({
+    phone: zod_1.z.string().describe('The phone number that was queried'),
+    workerId: zod_1.z.string().uuid().describe('ID of the matched worker'),
+    postcode: zod_1.z
+        .string()
+        .nullable()
+        .describe('Denormalized postcode from worker location, null if no location'),
+    bio: zod_1.z.string().nullable().describe('Worker bio, null if not set'),
+})
+    .openapi({ title: 'WorkerPhoneLookupResult' });
+exports.FindWorkersByPhonesResponseSchema = zod_1.z
+    .object({
+    results: zod_1.z.array(exports.WorkerPhoneLookupResultSchema),
+})
+    .openapi({ title: 'FindWorkersByPhonesResponse' });
 exports.MergeDuplicateCuratedWorkerSchema = zod_1.z
     .object({
     firstName: zod_1.z.string(),
@@ -704,15 +1335,15 @@ exports.MergeDuplicateCuratedWorkerSchema = zod_1.z
     nino: zod_1.z.string().nullable().optional(),
     dateOfBirth: zod_1.z.coerce.date().nullable().optional(),
     bio: zod_1.z.string().nullable().optional(),
-    hasTools: zod_1.z.boolean(),
-    hasPpe: zod_1.z.boolean(),
+    hasTools: zod_1.z.boolean().nullable(),
+    hasPpe: zod_1.z.boolean().nullable(),
     englishLevel: common_schemas_1.EnglishLevelSchema.nullable().optional(),
     nationality: common_schemas_1.NationalitySchema.nullable().optional(),
     locationId: zod_1.z.string().uuid().nullable().optional(),
     transportation: common_schemas_1.TransportationSchema.nullable().optional(),
     phoneNumbers: zod_1.z
         .array(zod_1.z.object({
-        phoneNumber: zod_1.z.string(),
+        phoneNumber: common_schemas_1.PhoneSchema,
         isPrimary: zod_1.z.boolean(),
         description: zod_1.z.string().nullable().optional(),
     }))
@@ -736,6 +1367,23 @@ exports.MergeDuplicateCuratedWorkerSchema = zod_1.z
     }))
         .optional()
         .default([]),
+    idDocuments: zod_1.z
+        .array(zod_1.z.object({
+        fileId: zod_1.z.string().uuid().nullable().optional(),
+        documentType: common_schemas_1.IdDocumentTypeSchema.nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+        documentNumber: zod_1.z.string().max(100).nullable().optional(),
+    }))
+        .optional()
+        .default([]),
+    shareCode: zod_1.z
+        .object({
+        code: zod_1.z.string().nullable().optional(),
+        expiryDate: zod_1.z.string().date().nullable().optional(),
+    })
+        .nullable()
+        .optional()
+        .describe('Share Code'),
 })
     .openapi({ title: 'MergeDuplicateCuratedWorker' });
 exports.MergeDuplicatesRequestSchema = zod_1.z
@@ -751,46 +1399,88 @@ exports.MergeDuplicatesResponseSchema = zod_1.z
 })
     .openapi({ title: 'MergeDuplicatesResponse' });
 exports.FilterWorkerSchema = pagination_query_schema_1.PaginationQuerySchema.extend({
-    name: zod_1.z.string().optional().describe('Search by name'),
+    createdBy: zod_1.z.string().uuid().optional().describe('Search Second Agent'),
+    name: common_schemas_1.NameFilterSchema.optional().describe('Search by name (value) with optional exact match'),
     email: zod_1.z.string().optional().describe('Filter by email'),
     phone: zod_1.z.string().optional().describe('Filter by phone'),
-    createdBy: zod_1.z.string().uuid().optional().describe('Search Second Agent'),
-    availability: exports.AvailabilitySchema.optional()
-        .nullable()
-        .describe('Availability'),
-    englishLevel: common_schemas_1.EnglishLevelSchema.optional()
-        .nullable()
-        .describe('English level'),
+    location: common_schemas_1.LocationFilterSchema.extend({
+        autoRadius: zod_1.z
+            .union([zod_1.z.boolean(), zod_1.z.enum(['true', 'false'])])
+            .transform((v) => v === true || v === 'true')
+            .optional()
+            .describe('When true, the server picks the radius from local worker supply'),
+    })
+        .optional()
+        .describe('Filter by location'),
+    tradeFilters: zod_1.z.array(exports.TradeFilterSchema).optional().describe('Trades'),
+    qualificationFilters: zod_1.z
+        .array(common_schemas_1.QualificationFilterSchema)
+        .optional()
+        .describe('Qualifications'),
+    occupancy: zod_1.z
+        .enum(['ACTIVE', 'BOOKED', 'FREE'])
+        .optional()
+        .describe('Filter by booking-derived occupancy'),
+    contact: zod_1.z
+        .enum(['CHASEABLE', 'PAUSED', 'BLACKLISTED'])
+        .optional()
+        .describe('Filter by active contact suppression state'),
     nationality: common_schemas_1.NationalitySchema.optional()
         .nullable()
         .describe('Filter by nationality'),
-    location: common_schemas_1.LocationFilterSchema.optional().describe('Filter by location'),
+    englishLevels: zod_1.z
+        .array(common_schemas_1.EnglishLevelSchema)
+        .optional()
+        .describe('Filter by English levels'),
     hasTools: exports.BooleanFilterSchema.optional().describe('Has Tools (default All)'),
     hasPpe: exports.BooleanFilterSchema.optional().describe('Has PPE (default All)'),
+    workedBefore: exports.BooleanFilterSchema.optional().describe('Worked before (default All)'),
+    noShows: exports.BooleanFilterSchema.optional().describe('No-shows (default All)'),
     transportationMethods: zod_1.z
         .array(common_schemas_1.TransportationMethodSchema)
         .optional()
         .describe('Filter by transportation methods'),
-    tradeFilters: zod_1.z.array(exports.TradeFilterSchema).optional().describe('Trades'),
-    qualificationFilters: zod_1.z
-        .array(curated_workers_contract_1.QualificationFilterSchema)
-        .optional()
-        .describe('Qualifications'),
     createdAt: common_schemas_1.DateRangeSchema.optional().describe('Filter by creation date'),
     updatedAt: common_schemas_1.DateRangeSchema.optional().describe('Filter by update date'),
-    sortBy: exports.WorkerSortableFieldsSchema.optional()
-        .nullable()
-        .describe('Sort by field'),
-    sortOrder: common_schemas_1.SortOrderSchema.optional().nullable().describe('Sort order'),
+    sort: (0, common_schemas_1.createSortArraySchema)(exports.WorkerSortableFieldsSchema),
     curatedWorkerId: zod_1.z
         .enum(['linked', 'unlinked'])
         .optional()
         .describe('Filter by curated worker link status'),
     crewId: zod_1.z.string().uuid().optional().describe('Filter by crew ID'),
+    parked: zod_1.z.coerce
+        .boolean()
+        .optional()
+        .describe('Filter to parked-only workers'),
+    offerOpenness: zod_1.z.array(exports.OfferOpennessSchema).optional(),
+    source: zod_1.z
+        .array(exports.WorkerSourceSchema)
+        .optional()
+        .describe('Filter by how the worker was added'),
+    proximityJobId: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Book-workers context: when set, each worker row is enriched with its precomputed travel time to this job (from lead_proximity_owned) — driveMinutes/transitMinutes/travelTimeEnriched.'),
 });
 exports.PaginatedWorkerResponseSchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.WorkerSchema)
     .describe('Workers retrieved successfully.')
     .openapi({ title: 'WorkersPaginatedResponse' });
+exports.PaginatedWorkerListResponseSchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.WorkerListItemSchema)
+    .describe('Workers list retrieved successfully.')
+    .openapi({ title: 'WorkerListPaginatedResponse' });
+exports.FindAllWorkersResponseSchema = exports.PaginatedWorkerListResponseSchema.extend({
+    appliedRadius: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Radius (km) the server actually applied; null when no distance filter ran'),
+    suggestedRadius: zod_1.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('Supply-tiered radius (km) for the filtered postcode, independent of the applied radius; null when no postcode resolved. Lets the client offer "Auto" without a round trip.'),
+}).openapi({ title: 'WorkerListPaginatedResponseWithRadius' });
 // --- Worker Import Schemas ---
 exports.WorkerImportJobStatusSchema = zod_1.z
     .enum(['PENDING', 'PROCESSING', 'COMPLETED', 'FAILED'])
@@ -800,6 +1490,18 @@ exports.StartWorkerImportSchema = zod_1.z
     fileId: zod_1.z.string().uuid().describe('ID of the uploaded CSV file'),
 })
     .openapi({ title: 'StartWorkerImport' });
+const WORKER_IMPORT_IDENTITY_CONFLICT_REVIEW_URL_PREFIX = '/workers/identity-matches?workerSourceIdentityConflictContext=IMPORT&workerSourceIdentityConflictContextId=';
+const WorkerImportIdentityConflictReviewUrlSchema = zod_1.z
+    .string()
+    .refine((value) => {
+    if (!value.startsWith(WORKER_IMPORT_IDENTITY_CONFLICT_REVIEW_URL_PREFIX)) {
+        return false;
+    }
+    return zod_1.z
+        .string()
+        .uuid()
+        .safeParse(value.slice(WORKER_IMPORT_IDENTITY_CONFLICT_REVIEW_URL_PREFIX.length)).success;
+}, 'Must be a relative, import-scoped Identity Matches review URL');
 exports.WorkerImportJobSchema = zod_1.z
     .object({
     id: zod_1.z.string().uuid().describe('Import Job ID'),
@@ -808,6 +1510,21 @@ exports.WorkerImportJobSchema = zod_1.z
     successCount: zod_1.z.number().describe('Successfully imported rows'),
     failedCount: zod_1.z.number().describe('Failed rows'),
     skippedCount: zod_1.z.number().describe('Skipped rows (duplicates)'),
+    awaitingAttributionCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Current pending, unexpired source attribution challenges'),
+    identityConflictCount: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .describe('Current OPEN identity conflict cases'),
+    identityConflictReviewUrl: WorkerImportIdentityConflictReviewUrlSchema.nullable().describe('Identity Matches review URL for current OPEN conflict cases'),
+    identityConflictCaseIds: zod_1.z
+        .array(zod_1.z.string().uuid())
+        .max(100)
+        .describe('Up to 100 current OPEN identity conflict case IDs'),
     errorMessage: zod_1.z
         .string()
         .nullable()
@@ -831,6 +1548,17 @@ exports.WorkerImportJobSchema = zod_1.z
         .nullable()
         .optional()
         .describe('Completion timestamp'),
+})
+    .strict()
+    .superRefine((job, context) => {
+    if (job.identityConflictReviewUrl !== null &&
+        job.identityConflictReviewUrl.slice(WORKER_IMPORT_IDENTITY_CONFLICT_REVIEW_URL_PREFIX.length) !== job.id) {
+        context.addIssue({
+            code: 'custom',
+            path: ['identityConflictReviewUrl'],
+            message: 'Identity Matches review URL must be scoped to this import job',
+        });
+    }
 })
     .openapi({ title: 'WorkerImportJob' });
 exports.WorkerImportResultSchema = zod_1.z
@@ -839,6 +1567,64 @@ exports.WorkerImportResultSchema = zod_1.z
     mimeType: zod_1.z.string().describe('MIME type (text/csv)'),
 })
     .openapi({ title: 'WorkerImportResult' });
+exports.ListWorkerSourceAttributionChallengesQuerySchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().int().min(1).default(1),
+    limit: zod_1.z.coerce.number().int().min(1).max(100).default(50),
+    context: exports.WorkerSourceAttributionContextSchema.optional(),
+    contextId: zod_1.z.string().uuid().optional(),
+    sourceIdentityConflictId: zod_1.z.string().uuid().optional(),
+});
+exports.AdminListWorkerSourceAttributionChallengesQuerySchema = exports.ListWorkerSourceAttributionChallengesQuerySchema.extend({
+    status: exports.WorkerSourceAttributionStatusSchema.optional(),
+});
+exports.WorkerSourceAttributionChallengeListResponseSchema = zod_1.z.object({
+    data: zod_1.z.array(exports.WorkerSourceAttributionChallengeSchema),
+    total: zod_1.z.number().int().min(0),
+    page: zod_1.z.number().int().positive(),
+    limit: zod_1.z.number().int().positive(),
+});
+exports.ResolveWorkerSourceAttributionChallengesBatchBodySchema = zod_1.z.object({
+    items: zod_1.z
+        .array(exports.ResolveWorkerSourceAttributionBodySchema.extend({
+        challengeId: zod_1.z.string().uuid(),
+    }))
+        .min(1)
+        .max(100),
+});
+exports.ResolveWorkerSourceAttributionChallengeResultSchema = zod_1.z.discriminatedUnion('status', [
+    zod_1.z
+        .object({
+        challengeId: zod_1.z.string().uuid(),
+        status: zod_1.z.literal('SUCCESS'),
+        workerId: zod_1.z.string().uuid(),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        challengeId: zod_1.z.string().uuid(),
+        status: zod_1.z.literal('FAILED'),
+        error: zod_1.z.string(),
+        terminal: zod_1.z.boolean(),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        challengeId: zod_1.z.string().uuid(),
+        status: zod_1.z.literal('IDENTITY_CONFLICT'),
+        error: zod_1.z.string(),
+        terminal: zod_1.z.literal(true),
+        identityConflict: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictReferenceSchema,
+    })
+        .strict(),
+]);
+exports.ResolveWorkerSourceAttributionChallengesBatchResponseSchema = zod_1.z
+    .object({
+    results: zod_1.z.array(exports.ResolveWorkerSourceAttributionChallengeResultSchema),
+})
+    .strict();
+exports.InvalidateWorkerSourceAttributionChallengeBodySchema = zod_1.z.object({
+    reason: zod_1.z.string().trim().min(1).max(500),
+});
 // --- Contract ---
 const c = (0, core_1.initContract)();
 exports.workersContractRouter = c.router({
@@ -847,9 +1633,9 @@ exports.workersContractRouter = c.router({
         path: '/v2/workers',
         responses: {
             201: exports.WorkerSchema,
-            409: error_schemas_1.ErrorResponseSchema,
+            409: exports.WorkerCreateConflictResponseSchema,
         },
-        body: exports.CreateWorkerBodySchema,
+        body: exports.CreateSingleWorkerBodySchema,
         summary: 'Create a new worker',
         metadata: { tags: ['Workers'], openApi: { operationId: 'createWorker' } },
     },
@@ -857,7 +1643,7 @@ exports.workersContractRouter = c.router({
         method: 'GET',
         path: '/v2/workers',
         responses: {
-            200: exports.PaginatedWorkerResponseSchema,
+            200: exports.FindAllWorkersResponseSchema,
         },
         query: exports.FilterWorkerSchema,
         summary: 'Get all workers',
@@ -912,6 +1698,85 @@ exports.workersContractRouter = c.router({
             openApi: { operationId: 'getWorkerImportResult' },
         },
     },
+    listSourceAttributionChallenges: {
+        method: 'GET',
+        path: '/v2/workers/source-attribution-challenges',
+        query: exports.ListWorkerSourceAttributionChallengesQuerySchema,
+        responses: {
+            200: exports.WorkerSourceAttributionChallengeListResponseSchema,
+        },
+        summary: "List the current user's pending source attribution challenges",
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'listWorkerSourceAttributionChallenges' },
+        },
+    },
+    resolveSourceAttributionChallengesBatch: {
+        method: 'POST',
+        path: '/v2/workers/source-attribution-challenges/resolve-batch',
+        body: exports.ResolveWorkerSourceAttributionChallengesBatchBodySchema,
+        responses: {
+            200: exports.ResolveWorkerSourceAttributionChallengesBatchResponseSchema,
+        },
+        summary: 'Resolve multiple source attribution challenges',
+        metadata: {
+            tags: ['Workers'],
+            openApi: {
+                operationId: 'resolveWorkerSourceAttributionChallengesBatch',
+            },
+        },
+    },
+    resolveSourceAttributionChallenge: {
+        method: 'POST',
+        path: '/v2/workers/source-attribution-challenges/:id/resolve',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid().describe('Source attribution challenge ID'),
+        }),
+        body: exports.ResolveWorkerSourceAttributionBodySchema,
+        responses: {
+            201: exports.WorkerSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Resolve a source attribution challenge',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'resolveWorkerSourceAttributionChallenge' },
+        },
+    },
+    adminListSourceAttributionChallenges: {
+        method: 'GET',
+        path: '/v2/workers/admin/source-attribution-challenges',
+        query: exports.AdminListWorkerSourceAttributionChallengesQuerySchema,
+        responses: {
+            200: exports.WorkerSourceAttributionChallengeListResponseSchema,
+        },
+        summary: 'List worker source attribution challenges for administrators',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'adminListWorkerSourceAttributionChallenges' },
+        },
+    },
+    adminInvalidateSourceAttributionChallenge: {
+        method: 'POST',
+        path: '/v2/workers/admin/source-attribution-challenges/:id/invalidate',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid().describe('Source attribution challenge ID'),
+        }),
+        body: exports.InvalidateWorkerSourceAttributionChallengeBodySchema,
+        responses: {
+            200: exports.WorkerSourceAttributionChallengeSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Invalidate a pending worker source attribution challenge',
+        metadata: {
+            tags: ['Workers'],
+            openApi: {
+                operationId: 'adminInvalidateWorkerSourceAttributionChallenge',
+            },
+        },
+    },
     suggestCuratedMatches: {
         method: 'GET',
         path: '/v2/workers/suggest-curated-matches',
@@ -925,6 +1790,21 @@ exports.workersContractRouter = c.router({
             openApi: { operationId: 'suggestCuratedMatches' },
         },
     },
+    suggestCuratedMatchGroups: {
+        method: 'GET',
+        path: '/v2/workers/suggest-curated-match-groups',
+        query: zod_1.z.object({
+            page: zod_1.z.coerce.number().int().min(1).default(1),
+            limit: zod_1.z.coerce.number().int().min(1).max(200).default(50),
+            matchField: exports.MatchFieldSchema.optional(),
+        }),
+        responses: { 200: exports.SuggestCuratedMatchGroupsResponseSchema },
+        summary: 'Suggested curated matches grouped by curated worker (paginated by group)',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'suggestCuratedMatchGroups' },
+        },
+    },
     findDuplicates: {
         method: 'GET',
         path: '/v2/workers/find-duplicates',
@@ -939,7 +1819,11 @@ exports.workersContractRouter = c.router({
     findDuplicateGroupWorkers: {
         method: 'GET',
         path: '/v2/workers/find-duplicates/by-phone',
-        query: zod_1.z.object({ phoneNumber: zod_1.z.string().describe('Phone number to find duplicate workers for') }),
+        query: zod_1.z.object({
+            phoneNumber: zod_1.z
+                .string()
+                .describe('Phone number to find duplicate workers for'),
+        }),
         responses: {
             200: zod_1.z.object({
                 phoneNumber: zod_1.z.string(),
@@ -947,7 +1831,23 @@ exports.workersContractRouter = c.router({
             }),
         },
         summary: 'Get full worker details for a duplicate group by phone number',
-        metadata: { tags: ['Workers'], openApi: { operationId: 'findDuplicateGroupWorkers' } },
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'findDuplicateGroupWorkers' },
+        },
+    },
+    findByPhones: {
+        method: 'POST',
+        path: '/v2/workers/find-by-phones',
+        body: exports.FindWorkersByPhonesBodySchema,
+        responses: {
+            200: exports.FindWorkersByPhonesResponseSchema,
+        },
+        summary: 'Find multiple workers by phone numbers in a single batch request',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'findWorkersByPhones' },
+        },
     },
     mergeDuplicates: {
         method: 'POST',
@@ -978,6 +1878,49 @@ exports.workersContractRouter = c.router({
             openApi: { operationId: 'bulkLinkWorkers' },
         },
     },
+    batchCreate: {
+        method: 'POST',
+        path: '/v2/workers/batch-create',
+        responses: {
+            201: exports.BatchCreateWorkersResponseSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+        },
+        body: exports.BatchCreateWorkersBodySchema,
+        summary: 'Create multiple workers in a single batch',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'batchCreateWorkers' },
+        },
+    },
+    jobMatchCount: {
+        method: 'GET',
+        path: '/v2/workers/job-match-count',
+        query: zod_1.z.object({
+            tradeId: zod_1.z.string().uuid().optional(),
+            postcode: zod_1.z.string().optional(),
+        }),
+        responses: {
+            200: zod_1.z.object({ count: zod_1.z.number().int().min(0) }),
+        },
+        summary: "Count workers matching a job's trade and location filters",
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'getWorkerJobMatchCount' },
+        },
+    },
+    checkAvailability: {
+        method: 'GET',
+        path: '/v2/workers/availability',
+        query: exports.CheckWorkerAvailabilityQuerySchema,
+        responses: {
+            200: exports.CheckWorkerAvailabilityResponseSchema,
+        },
+        summary: 'Look up a worker currently associated with the given phone number',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'checkWorkerAvailability' },
+        },
+    },
     findOne: {
         method: 'GET',
         path: '/v2/workers/:id',
@@ -1005,7 +1948,7 @@ exports.workersContractRouter = c.router({
         pathParams: zod_1.z.object({
             id: zod_1.z.string().uuid().describe('Worker ID'),
         }),
-        body: exports.UpdateWorkerSchema,
+        body: exports.UpdateWorkerBodySchema,
         summary: 'Update a worker',
         metadata: { tags: ['Workers'], openApi: { operationId: 'updateWorker' } },
     },
@@ -1059,6 +2002,21 @@ exports.workersContractRouter = c.router({
             openApi: { operationId: 'linkWorkerWithMerge' },
         },
     },
+    linkWorkersWithMerge: {
+        method: 'POST',
+        path: '/v2/workers/link-workers-with-merge',
+        responses: {
+            200: exports.LinkWorkersWithMergeResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        body: exports.LinkWorkersWithMergeSchema,
+        summary: 'Link multiple workers to an existing curated worker with merge',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'linkWorkersWithMerge' },
+        },
+    },
     promoteWorker: {
         method: 'POST',
         path: '/v2/workers/:id/promote',
@@ -1077,6 +2035,31 @@ exports.workersContractRouter = c.router({
             openApi: { operationId: 'promoteWorkerToCuratedWorker' },
         },
     },
+    bulkPromoteUnmatchedPreview: {
+        method: 'GET',
+        path: '/v2/workers/bulk-promote-unmatched/preview',
+        responses: {
+            200: exports.BulkPromoteUnmatchedPreviewResponseSchema,
+        },
+        summary: 'Preview the bulk-promote of unmatched workers to curated workers',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'previewBulkPromoteUnmatchedWorkers' },
+        },
+    },
+    bulkPromoteUnmatched: {
+        method: 'POST',
+        path: '/v2/workers/bulk-promote-unmatched',
+        body: c.noBody(),
+        responses: {
+            201: exports.BulkPromoteUnmatchedResponseSchema,
+        },
+        summary: 'Promote all unmatched workers (with a phone) to curated workers',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'bulkPromoteUnmatchedWorkers' },
+        },
+    },
 }, {
     commonResponses: {
         400: error_schemas_1.ErrorResponseSchema,