@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/curated-worker-leads/jobs-tab.contract.js

@@ -0,0 +1,642 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jobsTabContract = exports.JobCandidatesResponseSchema = exports.CandidateCardsBodySchema = exports.OwnedJobMatchWorkerCardSchema = exports.CuratedJobMatchWorkerCardSchema = exports.OwnedCandidateCardSchema = exports.JobCandidateCardSchema = exports.OwnedCandidateCrewSchema = exports.CandidateLocationSchema = exports.OwnedCandidateQualificationSchema = exports.JobCandidateQualificationSchema = exports.CandidateRowSchema = exports.CandidateOfferChannelSchema = exports.ConvertToWorkerResponseSchema = exports.BookCandidateWithDetailsResponseSchema = exports.BookCandidateWithDetailsBodySchema = exports.CandidateBookingFieldsSchema = exports.BookJobMatchResponseSchema = exports.BookJobMatchBodySchema = exports.DispositionBatchSchema = exports.DispositionJobMatchSchema = exports.NotInterestedReasonSchema = exports.JobFeedMatchCountBatchItemSchema = exports.JobFeedMatchCountSchema = exports.JobsTabResponseSchema = exports.WorkerJobGroupSchema = exports.WorkerJobMatchItemSchema = exports.MatchTupleSchema = exports.OfferChannelSchema = exports.WorkerJobMatchStatusSchema = exports.SubjectKindSchema = void 0;
+const zod_openapi_1 = require("@anatine/zod-openapi");
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const crews_contract_1 = require("../crews/crews.contract");
+const booking_history_schema_1 = require("../shared/booking-history.schema");
+const live_booking_schema_1 = require("../shared/live-booking.schema");
+const bookings_contract_1 = require("../bookings/bookings.contract");
+const jobs_contract_1 = require("../jobs/jobs.contract");
+const workers_contract_1 = require("../workers/workers.contract");
+const curated_workers_contract_1 = require("../curated-workers/curated-workers.contract");
+const do_not_contact_contract_1 = require("../workers/do-not-contact.contract");
+const common_schemas_1 = require("../common/common-schemas");
+const workers_contract_2 = require("../workers/workers.contract");
+const candidate_coordination_contract_1 = require("./candidate-coordination.contract");
+(0, zod_openapi_1.extendZodWithOpenApi)(zod_1.z);
+const c = (0, core_1.initContract)();
+exports.SubjectKindSchema = zod_1.z
+    .enum(['OWNED', 'CURATED'])
+    .openapi({ title: 'SubjectKind' });
+exports.WorkerJobMatchStatusSchema = zod_1.z
+    .enum(['NEW', 'TOO_FAR', 'NOT_INTERESTED', 'OFFER_SENT', 'BOOKED'])
+    .openapi({ title: 'WorkerJobMatchStatus' });
+exports.OfferChannelSchema = zod_1.z
+    .enum(['WHATSAPP', 'PHONE'])
+    .openapi({ title: 'OfferChannel' });
+exports.MatchTupleSchema = zod_1.z
+    .object({
+    subjectKind: exports.SubjectKindSchema,
+    subjectId: zod_1.z.string().uuid(),
+    jobId: zod_1.z.string().uuid(),
+})
+    .openapi({ title: 'MatchTuple' });
+exports.WorkerJobMatchItemSchema = zod_1.z
+    .object({
+    subjectKind: exports.SubjectKindSchema,
+    subjectId: zod_1.z.string().uuid(),
+    jobId: zod_1.z.string().uuid(),
+    distanceKm: zod_1.z.number().nullable(),
+    driveMinutes: zod_1.z.number().nullable(),
+    transitMinutes: zod_1.z.number().nullable(),
+    status: exports.WorkerJobMatchStatusSchema,
+    statusUpdatedAt: zod_1.z.string().datetime().nullable(),
+})
+    .openapi({ title: 'WorkerJobMatchItem' });
+exports.WorkerJobGroupSchema = zod_1.z
+    .object({
+    source: zod_1.z.enum(['OWN', 'CURATED']),
+    curatedWorkerId: zod_1.z.string().uuid().nullable(),
+    workerId: zod_1.z.string().uuid().nullable(),
+    /** Live booking on this worker's identity (see LiveBookingSummary); null/absent = not booked. */
+    liveBooking: live_booking_schema_1.LiveBookingSummarySchema.nullable().optional(),
+    matches: zod_1.z.array(exports.WorkerJobMatchItemSchema),
+})
+    .openapi({ title: 'WorkerJobGroup' });
+exports.JobsTabResponseSchema = zod_1.z
+    .object({
+    groups: zod_1.z.array(exports.WorkerJobGroupSchema),
+    hasMore: zod_1.z.boolean(),
+})
+    .openapi({ title: 'JobsTabResponse' });
+exports.JobFeedMatchCountSchema = zod_1.z.object({
+    owned: zod_1.z.number().int().min(0),
+    curated: zod_1.z.number().int().min(0),
+    /** Distinct workers this viewer contacted for this job. */
+    workersContactedByViewerCount: zod_1.z.number().int().min(0),
+    /** Distinct workers contacted for this job by users other than the viewer. */
+    workersContactedByOthersCount: zod_1.z.number().int().min(0),
+    /** Rows awaiting travel-time enrichment, viewer-scoped. */
+    pendingEnrichmentCount: zod_1.z.number().int().min(0),
+    /** Presence is delivered separately today; retained for response compatibility. */
+    activeAgentCount: zod_1.z.number().int().min(0).optional(),
+});
+exports.JobFeedMatchCountBatchItemSchema = exports.JobFeedMatchCountSchema.extend({
+    jobId: zod_1.z.string().uuid(),
+});
+const CommaSeparatedJobIdsSchema = zod_1.z
+    .string()
+    .min(1)
+    .superRefine((value, ctx) => {
+    const ids = value.split(',').map((id) => id.trim());
+    if (ids.length > 200) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.too_big,
+            maximum: 200,
+            type: 'array',
+            inclusive: true,
+            message: 'At most 200 job IDs may be requested',
+        });
+    }
+    if (ids.some((id) => !zod_1.z.string().uuid().safeParse(id).success)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'jobIds must be a comma-separated list of UUIDs',
+        });
+    }
+});
+var candidate_coordination_contract_2 = require("./candidate-coordination.contract");
+Object.defineProperty(exports, "NotInterestedReasonSchema", { enumerable: true, get: function () { return candidate_coordination_contract_2.NotInterestedReasonSchema; } });
+/** NOT_INTERESTED requires a reason; reason OTHER requires a non-empty comment. */
+const requireReasonAndComment = (data, ctx) => {
+    if (data.status === 'NOT_INTERESTED' && !data.reason) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['reason'],
+            message: 'A reason is required for Not interested',
+        });
+    }
+    if (data.reason === 'OTHER' && !data.comment?.trim()) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['comment'],
+            message: 'A comment is required when the reason is Other',
+        });
+    }
+};
+exports.DispositionJobMatchSchema = zod_1.z
+    .object({
+    tuple: exports.MatchTupleSchema,
+    status: zod_1.z.enum(['NOT_INTERESTED', 'OFFER_SENT']),
+    channel: exports.OfferChannelSchema.optional(),
+    /**
+     * How the agent reached the worker before a NOT_INTERESTED decline — one
+     * or both channels. Each is recorded as a contact event so a decline is
+     * never on record without a preceding contact. Ignored for OFFER_SENT
+     * (that path uses `channel`).
+     */
+    contactChannels: zod_1.z.array(exports.OfferChannelSchema).min(1).max(2).optional(),
+    reason: candidate_coordination_contract_1.NotInterestedReasonSchema.optional(),
+    comment: zod_1.z.string().trim().max(500).optional(),
+})
+    .superRefine(requireReasonAndComment)
+    .openapi({ title: 'DispositionJobMatch' });
+exports.DispositionBatchSchema = zod_1.z
+    .object({
+    tuples: zod_1.z.array(exports.MatchTupleSchema).min(1).max(50),
+    status: zod_1.z.enum(['NOT_INTERESTED', 'OFFER_SENT']),
+    channel: exports.OfferChannelSchema.optional(),
+    reason: candidate_coordination_contract_1.NotInterestedReasonSchema.optional(),
+    comment: zod_1.z.string().trim().max(500).optional(),
+})
+    .superRefine(requireReasonAndComment)
+    .openapi({ title: 'DispositionBatch' });
+exports.BookJobMatchBodySchema = zod_1.z
+    .object({ tuple: exports.MatchTupleSchema })
+    .openapi({ title: 'BookJobMatchBody' });
+exports.BookJobMatchResponseSchema = zod_1.z
+    .object({ bookingId: zod_1.z.string().uuid() })
+    .openapi({ title: 'BookJobMatchResponse' });
+exports.CandidateBookingFieldsSchema = zod_1.z
+    .object({
+    startDate: zod_1.z.string(),
+    endDate: zod_1.z.string().nullable().optional(),
+    expectedEndDate: zod_1.z.string().nullable().optional(),
+    pay: bookings_contract_1.BookingPaySchema.optional(),
+    status: bookings_contract_1.BookingStatusSchema.optional(),
+    comment: zod_1.z.string().optional(),
+    workingDays: bookings_contract_1.WorkingDaysSchema.optional(),
+})
+    .strict()
+    .superRefine(bookings_contract_1.bookingItemCrossFieldRules)
+    .openapi({ title: 'CandidateBookingFields' });
+exports.BookCandidateWithDetailsBodySchema = zod_1.z
+    .object({
+    tuple: exports.MatchTupleSchema.extend({ subjectKind: zod_1.z.literal('CURATED') }),
+    /** Client-generated UUID, stable across retries of the same submission. */
+    submissionId: zod_1.z.string().uuid(),
+    booking: exports.CandidateBookingFieldsSchema,
+})
+    .openapi({ title: 'BookCandidateWithDetailsBody' });
+exports.BookCandidateWithDetailsResponseSchema = zod_1.z
+    .object({
+    bookingId: zod_1.z.string().uuid(),
+    workerId: zod_1.z.string().uuid(),
+    reusedWorker: zod_1.z.boolean(),
+})
+    .openapi({ title: 'BookCandidateWithDetailsResponse' });
+exports.ConvertToWorkerResponseSchema = zod_1.z
+    .object({ workerId: zod_1.z.string().uuid() })
+    .openapi({ title: 'ConvertToWorkerResponse' });
+exports.CandidateOfferChannelSchema = zod_1.z.enum(['WHATSAPP', 'PHONE']);
+exports.CandidateRowSchema = zod_1.z
+    .object({
+    subjectKind: exports.SubjectKindSchema,
+    subjectId: zod_1.z.string().uuid(),
+    canonicalWorker: candidate_coordination_contract_1.CandidateCoordinationStateSchema.shape.canonicalWorker.optional(),
+    distanceKm: zod_1.z.number().nullable(),
+    driveMinutes: zod_1.z.number().nullable(),
+    transitMinutes: zod_1.z.number().nullable(),
+    /** This agent's disposition for THIS job; null = never dispositioned. */
+    disposition: zod_1.z
+        .object({
+        status: exports.WorkerJobMatchStatusSchema,
+        channel: exports.OfferChannelSchema.nullable(),
+        dispositionAt: zod_1.z.string().datetime().nullable(),
+        reason: candidate_coordination_contract_1.NotInterestedReasonSchema.nullable(),
+        comment: zod_1.z.string().nullable(),
+        /** Job's top offerable rate at RATE-decline time (COALESCE(payRateMax, payRate)). */
+        declinedRate: zod_1.z.number().nullable(),
+        declinedRateUnit: zod_1.z.enum(['DAILY', 'HOURLY']).nullable(),
+    })
+        .nullable(),
+    /** Latest lead_activity_events row for this subject across ALL jobs. */
+    lastActivityAt: zod_1.z.string().datetime().nullable(),
+    /** This viewer has logged contact with this candidate for THIS job. */
+    contactedByViewer: zod_1.z.boolean().optional(),
+    /**
+     * The team's one WhatsApp outreach for this candidate identity and job.
+     * Null means WhatsApp is still available; phone calls remain independent.
+     */
+    whatsappContact: zod_1.z
+        .object({
+        agent: candidate_coordination_contract_1.CoordinationUserSummarySchema,
+        contactedAt: zod_1.z.string().datetime(),
+    })
+        .nullable()
+        .optional(),
+    offerChannels: zod_1.z.array(exports.CandidateOfferChannelSchema).optional(),
+    offerContactedAt: zod_1.z.string().datetime().nullable().optional(),
+    /**
+     * Booking track record over the candidate's linked identity (all worker
+     * copies of the curated worker when a curated link exists, else just this
+     * record). worked = status_category IN_PROGRESS/FINISHED_THE_JOB; noShow =
+     * status_type DIDNT_START_BECAUSE_OF_WORKER. byMe = subset booked by the
+     * viewing user. Optional so cached pre-field payloads still parse.
+     */
+    bookingHistory: booking_history_schema_1.BookingHistorySchema.optional(),
+    /** Live booking on this candidate's identity; null/absent = not booked. */
+    liveBooking: live_booking_schema_1.LiveBookingSummarySchema.nullable().optional(),
+    /** True when at least one usable number may be revealed on demand. */
+    hasPhoneNumber: zod_1.z.boolean().optional(),
+    /** Live call/edit/ownership state. Phone values are never included here. */
+    coordination: candidate_coordination_contract_1.CandidateCoordinationStateSchema.optional(),
+})
+    .openapi({ title: 'JobCandidateRow' });
+/** Qualification details rendered on a candidate card, excluding proof files. */
+exports.JobCandidateQualificationSchema = zod_1.z.object({
+    id: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.id,
+    qualificationId: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.qualificationId,
+    qualificationTypeId: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.qualificationTypeId,
+    issueDate: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.issueDate,
+    expiryDate: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.expiryDate,
+    referenceNumber: curated_workers_contract_1.CuratedWorkerQualificationResponseSchema.shape.referenceNumber,
+});
+/** Owned-lane equivalent of the candidate-safe qualification projection. */
+exports.OwnedCandidateQualificationSchema = zod_1.z.object({
+    id: workers_contract_1.WorkerQualificationSchema.shape.id,
+    qualificationId: workers_contract_1.WorkerQualificationSchema.shape.qualificationId,
+    qualificationTypeId: workers_contract_1.WorkerQualificationSchema.shape.qualificationTypeId,
+    issueDate: workers_contract_1.WorkerQualificationSchema.shape.issueDate,
+    expiryDate: workers_contract_1.WorkerQualificationSchema.shape.expiryDate,
+    referenceNumber: workers_contract_1.WorkerQualificationSchema.shape.referenceNumber,
+});
+/** Display location used by candidate-card headers and directions links. */
+exports.CandidateLocationSchema = zod_1.z.object({
+    postcode: common_schemas_1.LocationDetailsSchema.shape.postcode,
+    postTown: common_schemas_1.LocationDetailsSchema.shape.postTown,
+    adminDistrict: common_schemas_1.LocationDetailsSchema.shape.adminDistrict,
+    builtUpArea: common_schemas_1.LocationDetailsSchema.shape.builtUpArea,
+    areaCovered: common_schemas_1.LocationDetailsSchema.shape.areaCovered,
+});
+/** Crew badge/link only; candidate hydration never returns crew contact data. */
+exports.OwnedCandidateCrewSchema = zod_1.z.object({
+    id: crews_contract_1.CrewSummarySchema.shape.id,
+    name: crews_contract_1.CrewSummarySchema.shape.name,
+});
+/**
+ * Candidate-card projections contain only fields rendered by the job-scoped
+ * Candidates workflow. Phone values and other sensitive identity/source data
+ * are deliberately absent; unknown input keys are stripped by Zod.
+ */
+exports.JobCandidateCardSchema = curated_workers_contract_1.CuratedWorkerResponseSchema.pick({
+    id: true,
+    firstName: true,
+    lastName: true,
+    dateOfBirth: true,
+    bio: true,
+    englishLevel: true,
+    nationality: true,
+    hasTools: true,
+    hasPpe: true,
+    bookingHistory: true,
+    transportation: true,
+    location: true,
+    offerOpenness: true,
+    offerOpennessSetAt: true,
+    offerNote: true,
+    offerNoteUpdatedAt: true,
+    offerSignalUpdatedById: true,
+    offerSignalUpdatedByName: true,
+    liveStatus: true,
+    distanceKm: true,
+    workingUntil: true,
+    createdAt: true,
+    updatedAt: true,
+    trades: true,
+    qualifications: true,
+})
+    .extend({
+    /** True when at least one usable number may be revealed on demand. */
+    hasPhoneNumber: zod_1.z.boolean(),
+    location: exports.CandidateLocationSchema.nullable().optional(),
+    qualifications: zod_1.z
+        .array(exports.JobCandidateQualificationSchema)
+        .nullable()
+        .optional(),
+})
+    .openapi({ title: 'JobCandidateCard' });
+exports.OwnedCandidateCardSchema = workers_contract_1.WorkerListItemSchema.pick({
+    id: true,
+    firstName: true,
+    lastName: true,
+    dateOfBirth: true,
+    bio: true,
+    trades: true,
+    qualifications: true,
+    englishLevel: true,
+    nationality: true,
+    hasTools: true,
+    hasPpe: true,
+    transportation: true,
+    location: true,
+    liveStatus: true,
+    offerOpenness: true,
+    offerOpennessSetAt: true,
+    offerNote: true,
+    offerNoteUpdatedAt: true,
+    distanceKm: true,
+    driveMinutes: true,
+    transitMinutes: true,
+    travelTimeEnriched: true,
+    bookingHistory: true,
+    crew: true,
+    createdAt: true,
+    updatedAt: true,
+})
+    .extend({
+    /** True when at least one usable number may be revealed on demand. */
+    hasPhoneNumber: zod_1.z.boolean(),
+    location: exports.CandidateLocationSchema.nullable().optional(),
+    qualifications: zod_1.z.array(exports.OwnedCandidateQualificationSchema).optional(),
+    crew: exports.OwnedCandidateCrewSchema.nullable().optional(),
+})
+    .openapi({ title: 'OwnedCandidateCard' });
+/**
+ * Worker-first Job Matches cards reuse only the explicitly allowlisted,
+ * phone-free candidate-card fields and add their live coordination overlay.
+ */
+exports.CuratedJobMatchWorkerCardSchema = exports.JobCandidateCardSchema.extend({
+    coordination: candidate_coordination_contract_1.CandidateCoordinationStateSchema.optional(),
+}).openapi({ title: 'CuratedJobMatchWorkerCard' });
+exports.OwnedJobMatchWorkerCardSchema = exports.OwnedCandidateCardSchema.extend({
+    coordination: candidate_coordination_contract_1.CandidateCoordinationStateSchema.optional(),
+}).openapi({ title: 'OwnedJobMatchWorkerCard' });
+exports.CandidateCardsBodySchema = zod_1.z.object({
+    own: zod_1.z.array(exports.OwnedCandidateCardSchema),
+    curated: zod_1.z.array(exports.JobCandidateCardSchema),
+});
+exports.JobCandidatesResponseSchema = zod_1.z
+    .object({
+    owned: zod_1.z.array(exports.CandidateRowSchema),
+    curated: zod_1.z.array(exports.CandidateRowSchema),
+    cards: exports.CandidateCardsBodySchema,
+    totalOwned: zod_1.z.number().int().min(0),
+    totalCurated: zod_1.z.number().int().min(0),
+    page: zod_1.z.number().int().min(1),
+    pageSize: zod_1.z.number().int().min(1),
+    totalPages: zod_1.z.number().int().min(0),
+    pendingEnrichmentCount: zod_1.z.number().int().min(0),
+    /** Distinct workers this viewer contacted for THIS job. Event-log based, so it survives later status changes. */
+    workersContactedByViewerCount: zod_1.z.number().int().min(0),
+    /** Distinct workers contacted for THIS job by users other than the viewer. */
+    workersContactedByOthersCount: zod_1.z.number().int().min(0),
+    /** This agent's non-resurfaced NOT_INTERESTED rows, both lanes, disposition_at DESC, cap 50. Also includes consent-written TOO_FAR rows (shown as reason Distance). */
+    dismissed: zod_1.z.array(exports.CandidateRowSchema),
+})
+    .openapi({ title: 'JobCandidatesResponse' });
+exports.jobsTabContract = c.router({
+    listGroupedByWorker: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs-tab',
+        query: zod_1.z.object({
+            page: zod_1.z.coerce.number().int().min(0).optional(),
+            lane: zod_1.z.enum(['OWN', 'CURATED']).optional(),
+            tradeIds: zod_1.z.string().optional(),
+            maxCommuteMinutes: zod_1.z.coerce.number().int().min(1).optional(),
+            workerName: zod_1.z
+                .object({
+                value: zod_1.z.string().optional(),
+                exact: zod_1.z.coerce.boolean().optional(),
+            })
+                .optional(),
+            workerPhone: zod_1.z.string().optional(),
+            hideBooked: zod_1.z.coerce.boolean().optional(),
+        }),
+        responses: { 200: exports.JobsTabResponseSchema, 403: error_schemas_1.ErrorResponseSchema },
+        summary: 'Consented + owned workers (for this agent) with live matching jobs, grouped by worker',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    disposition: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/disposition',
+        body: exports.DispositionJobMatchSchema,
+        responses: {
+            200: exports.WorkerJobMatchItemSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Disposition a job match (too far / not interested / offer sent)',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    dispositionBatch: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/disposition-batch',
+        body: exports.DispositionBatchSchema,
+        responses: {
+            200: zod_1.z.array(exports.WorkerJobMatchItemSchema),
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Disposition multiple job matches at once (e.g. a multi-job offer sent)',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    reconsider: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/reconsider',
+        body: zod_1.z.object({ tuple: exports.MatchTupleSchema }),
+        responses: {
+            200: zod_1.z.object({ ok: zod_1.z.literal(true) }),
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Clear a NOT_INTERESTED disposition so the worker rejoins the candidates list',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    book: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/book',
+        body: exports.BookJobMatchBodySchema,
+        responses: {
+            201: exports.BookJobMatchResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Book the worker for this matched job',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    convertToWorker: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/convert-to-worker',
+        body: exports.BookJobMatchBodySchema,
+        responses: {
+            200: exports.ConvertToWorkerResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Resolve a curated match to an agent-owned Worker copy (copy-on-book), without creating a booking — used to open the pre-filled bookings form',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    bookWithDetails: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/book-with-details',
+        body: exports.BookCandidateWithDetailsBodySchema,
+        responses: {
+            201: exports.BookCandidateWithDetailsResponseSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Create the owned Worker copy (if needed) and the Booking for a curated candidate atomically',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    candidateBookingConflicts: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs/:jobId/candidates/:subjectKind/:subjectId/booking-conflicts',
+        pathParams: zod_1.z.object({
+            jobId: zod_1.z.string().uuid(),
+            subjectKind: exports.SubjectKindSchema,
+            subjectId: zod_1.z.string().uuid(),
+        }),
+        responses: {
+            200: bookings_contract_1.BookingConflictsResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Advisory booking-conflict preflight over the canonical identity; creates no Worker or claim',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    setDoNotContact: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/worker/:curatedWorkerId/do-not-contact',
+        pathParams: zod_1.z.object({ curatedWorkerId: zod_1.z.string().uuid() }),
+        body: do_not_contact_contract_1.SetDoNotContactSchema.and(zod_1.z.object({
+            /**
+             * Job context for tuple authorization. Required for candidate-only
+             * curated viewers; optional for other roles during rollout.
+             */
+            jobId: zod_1.z.string().uuid().optional(),
+        })).openapi({ title: 'SetCuratedDoNotContact' }),
+        responses: {
+            200: zod_1.z.object({ ok: zod_1.z.literal(true) }),
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Set/extend a curated worker do-not-contact window (reason + 1-90 days) for this agent',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    clearDoNotContact: {
+        method: 'POST',
+        path: '/curated-worker-leads/job-matches/worker/:curatedWorkerId/do-not-contact/clear',
+        pathParams: zod_1.z.object({ curatedWorkerId: zod_1.z.string().uuid() }),
+        body: zod_1.z
+            .object({
+            /**
+             * Job context for tuple authorization, mirroring setDoNotContact:
+             * required for candidate-only curated viewers, optional for other
+             * roles. Clearing a DNC is the inverse of setting one, so it is
+             * authorized the same way rather than through the consent queue's
+             * parked-lead route (which requires a worker_lead_profiles row a
+             * DNC-only worker never has).
+             */
+            jobId: zod_1.z.string().uuid().optional(),
+        })
+            .strict()
+            .openapi({ title: 'ClearCuratedDoNotContact' }),
+        responses: {
+            200: zod_1.z.object({ ok: zod_1.z.literal(true) }),
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Clear a curated worker do-not-contact window (bring back into contact)',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    participation: {
+        method: 'GET',
+        path: '/curated-worker-leads/participation',
+        responses: { 200: zod_1.z.object({ isCuratedLaneParticipant: zod_1.z.boolean() }) },
+        summary: 'Whether the user participates in the cross-agent (curated) lane',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    getJobCards: {
+        method: 'GET',
+        path: '/curated-worker-leads/job-cards',
+        query: zod_1.z.object({ jobIds: zod_1.z.string().min(1) }),
+        responses: { 200: zod_1.z.array(jobs_contract_1.JobListItemSchema), 403: error_schemas_1.ErrorResponseSchema },
+        summary: "Full job-card data (pay/hours/positions/qualifications/first-agent) for the agent's matched jobs",
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    getWorkerCards: {
+        method: 'GET',
+        path: '/curated-worker-leads/worker-cards',
+        query: zod_1.z.object({
+            ownIds: zod_1.z.string().optional(),
+            curatedIds: zod_1.z.string().optional(),
+        }),
+        responses: {
+            200: zod_1.z.object({
+                own: zod_1.z.array(exports.OwnedJobMatchWorkerCardSchema),
+                curated: zod_1.z.array(exports.CuratedJobMatchWorkerCardSchema),
+            }),
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: "Full worker-card data for the agent's matched workers, both lanes",
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    getCandidateCards: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs/:jobId/candidate-cards',
+        pathParams: zod_1.z.object({ jobId: zod_1.z.string().uuid() }),
+        query: zod_1.z.object({
+            ownedIds: zod_1.z.string().optional(),
+            curatedIds: zod_1.z.string().optional(),
+        }),
+        responses: {
+            200: exports.CandidateCardsBodySchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: "Job-scoped candidate-card hydration. IDs outside the job's canonical eligible set are omitted and counted. Max 200 IDs across both lanes; malformed IDs are rejected. Response is viewer-scoped and must not be shared-cacheable.",
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    matchCount: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs/:jobId/match-count',
+        pathParams: zod_1.z.object({ jobId: zod_1.z.string().uuid() }),
+        responses: {
+            200: exports.JobFeedMatchCountSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Role-scoped worker-match counts for a job feed card (owned + curated) from the proximity tables',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    matchCounts: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs/match-counts',
+        query: zod_1.z.object({ jobIds: CommaSeparatedJobIdsSchema }),
+        responses: {
+            200: zod_1.z.object({ items: zod_1.z.array(exports.JobFeedMatchCountBatchItemSchema) }),
+            403: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Role-scoped worker-match counts for up to 200 job feed cards in one request',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+    candidates: {
+        method: 'GET',
+        path: '/curated-worker-leads/jobs/:jobId/candidates',
+        pathParams: zod_1.z.object({ jobId: zod_1.z.string().uuid() }),
+        query: zod_1.z.object({
+            page: zod_1.z.coerce.number().int().min(1).max(100).optional(),
+            maxCommuteMinutes: zod_1.z.coerce.number().int().min(1).optional(),
+            nationality: common_schemas_1.NationalitySchema.optional(),
+            englishLevels: zod_1.z.array(common_schemas_1.EnglishLevelSchema).optional(),
+            transportationMethods: zod_1.z.array(common_schemas_1.TransportationMethodSchema).optional(),
+            hasTools: workers_contract_2.BooleanFilterSchema.optional(),
+            hasPpe: workers_contract_2.BooleanFilterSchema.optional(),
+            workedBefore: workers_contract_2.BooleanFilterSchema.optional(),
+            noShows: workers_contract_2.BooleanFilterSchema.optional(),
+            offerOpenness: zod_1.z.array(workers_contract_2.OfferOpennessSchema).optional(),
+            name: common_schemas_1.NameFilterSchema.optional(),
+            phone: zod_1.z.string().optional(),
+            qualificationFilters: zod_1.z.array(common_schemas_1.QualificationFilterSchema).optional(),
+            lane: zod_1.z.enum(['OWNED', 'CURATED']).optional(),
+            hideBooked: zod_1.z.coerce.boolean().optional(),
+        }),
+        responses: { 200: exports.JobCandidatesResponseSchema, 403: error_schemas_1.ErrorResponseSchema },
+        summary: 'Paginated, globally commute-ranked candidate workers for one job — owned lane always (CASL-scoped), curated lane for global curated viewers. OFFER_SENT rows retain their rank; NOT_INTERESTED/TOO_FAR/DNC rows are hidden from the main page; live owned bookings are flagged (hideBooked=true excludes them).',
+        metadata: { tags: ['Curated Worker Lead Jobs'] },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});