@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/dashboards/dashboard-widgets.contract.js

@@ -7,7 +7,7 @@
  *              Provides role-specific widgets for First Agent (FA) and Second Agent (SA).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dashboardWidgetsContract = exports.CollaborationsTrendSchema = exports.WorkersTrendSchema = exports.CallPerformanceTrendSchema = exports.BookingsTrendSchema = exports.ActivesTrendSchema = exports.AdminSaAggregateSchema = exports.AdminFaAggregateSchema = exports.SaActivesWidgetSchema = exports.SaBookingsWidgetSchema = exports.SaWorkersWidgetSchema = exports.FaBookingsWidgetSchema = exports.FaActivesWidgetSchema = exports.AllAgentsCallHistoryQuerySchema = exports.FaCallHistoryWidgetSchema = exports.FaCheckingsWidgetSchema = exports.FaClientsWidgetSchema = exports.FaPipelineWidgetSchema = exports.TrendDataPointSchema = exports.DateRangeQuerySchema = exports.DashboardWidgetQuerySchema = void 0;
+exports.dashboardWidgetsContract = exports.LeadActivityTrendSchema = exports.LeadActivityOutcomeKeySchema = exports.ProofsTrendSchema = exports.ProofsWidgetSchema = exports.CollaborationsTrendSchema = exports.JobsTrendSchema = exports.WorkersTrendSchema = exports.CallPerformanceTrendSchema = exports.BookingsTrendSchema = exports.ActivesTrendSchema = exports.AdminSaAggregateSchema = exports.AdminFaAggregateSchema = exports.SaActivesWidgetSchema = exports.SaBookingsWidgetSchema = exports.SaWorkersWidgetSchema = exports.FaJobsWidgetSchema = exports.FaBookingsWidgetSchema = exports.FaActivesWidgetSchema = exports.AllAgentsCallHistoryQuerySchema = exports.AgentStatsSortFieldSchema = exports.FaCallHistoryWidgetSchema = exports.FaCheckingsWidgetSchema = exports.FaClientsWidgetSchema = exports.FaPipelineWidgetSchema = exports.TrendDataPointSchema = exports.RoleScopedDateRangeQuerySchema = exports.AgentTrendQuerySchema = exports.DateRangeOfficeQuerySchema = exports.DateRangeQuerySchema = exports.DashboardWidgetQuerySchema = void 0;
 const core_1 = require("@ts-rest/core");
 const zod_1 = require("zod");
 const pagination_schema_1 = require("../common/pagination.schema");
@@ -17,6 +17,9 @@ const collaborations_contract_1 = require("../collaborations/collaborations.cont
 const bookings_contract_1 = require("../bookings/bookings.contract");
 const actives_contract_1 = require("../actives/actives.contract");
 const call_rating_schema_1 = require("../common/call-rating.schema");
+const common_schemas_1 = require("../common/common-schemas");
+const users_contract_1 = require("../users/users.contract");
+const proof_type_enum_1 = require("../proofs/proof-type.enum");
 const c = (0, core_1.initContract)();
 // =============================================================================
 // COMMON SCHEMAS
@@ -29,6 +32,11 @@ exports.DashboardWidgetQuerySchema = zod_1.z.object({
         .string()
         .optional()
         .describe('Date in YYYY-MM-DD format. Defaults to today if not provided.'),
+    office: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Filter by office ID. Omit for all accessible offices.'),
 });
 /**
  * Date range filter for historical queries
@@ -37,6 +45,35 @@ exports.DateRangeQuerySchema = zod_1.z.object({
     startDate: zod_1.z.string().describe('Start date in YYYY-MM-DD format'),
     endDate: zod_1.z.string().describe('End date in YYYY-MM-DD format'),
 });
+/**
+ * Date range + office filter for admin aggregate trends.
+ */
+exports.DateRangeOfficeQuerySchema = exports.DateRangeQuerySchema.extend({
+    office: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Filter by office ID. Omit for all accessible offices.'),
+});
+/** Date range + the agent's role (FA/SA), for per-agent admin trend lookups. */
+exports.AgentTrendQuerySchema = exports.DateRangeQuerySchema.extend({
+    role: zod_1.z
+        .enum(['FA', 'SA'])
+        .optional()
+        .describe('Agent role for role-scoped metrics'),
+});
+/**
+ * Date range + an optional self role scope for personal trends that exist in
+ * both the FA and SA widget sections (actives, bookings). When omitted the
+ * server falls back to the caller's default role. A role the caller does not
+ * hold is ignored server-side.
+ */
+exports.RoleScopedDateRangeQuerySchema = exports.DateRangeQuerySchema.extend({
+    role: zod_1.z
+        .enum(['FA', 'SA'])
+        .optional()
+        .describe('Self role scope (FA/SA) for the requesting user'),
+});
 /**
  * Common trend data point for time-series charts
  */
@@ -111,18 +148,88 @@ exports.FaCallHistoryWidgetSchema = zod_1.z.object({
         .describe('Own research leads that already existed in system'),
     ownResearchLeadsNew: zod_1.z.number().describe('Own research leads new to system'),
 });
+exports.AgentStatsSortFieldSchema = zod_1.z.enum([
+    'agentName',
+    'activesFaActive',
+    'activesFaOthers',
+    'activesSaActive',
+    'activesSaOthers',
+    'bookingsFaAttempts',
+    'bookingsFaFailed',
+    'bookingsFaInProgress',
+    'bookingsFaCompleted',
+    'bookingsFaCancelled',
+    'bookingsSaAttempts',
+    'bookingsSaFailed',
+    'bookingsSaInProgress',
+    'bookingsSaCompleted',
+    'bookingsSaCancelled',
+    'callsOnDate',
+    'efficientCalls',
+    'conversionsOnDate',
+    'dailyConversionRate',
+    'performanceScore',
+    'ownResearchLeadsAdded',
+    'jobsCreatedOnDate',
+    'jobsTotalOpenPositions',
+    'jobsFilledPositions',
+    'workersAddedToday',
+    'consentLeadsActioned',
+    'consentConsented',
+    'consentDeclined',
+    'consentWrongNumber',
+    'consentSnoozed',
+    'offersSent',
+    'offersBooked',
+]);
 /**
  * Query parameters for all agents call history endpoint
  */
 exports.AllAgentsCallHistoryQuerySchema = pagination_query_schema_1.PaginationQuerySchema.extend({
+    // The admin agent-stats table renders every agent in one unpaginated grid, so
+    // it asks for the whole set at once rather than the shared MAX_PAGE_SIZE.
+    limit: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .default(50)
+        .describe('The number of items to return per page.'),
     date: zod_1.z
         .string()
         .optional()
         .describe('Date in YYYY-MM-DD format. Defaults to today if not provided.'),
+    startDate: zod_1.z
+        .string()
+        .optional()
+        .describe('Range start (YYYY-MM-DD). When set with endDate and != endDate, the table aggregates over the range.'),
+    endDate: zod_1.z.string().optional().describe('Range end (YYYY-MM-DD).'),
     view: zod_1.z
         .enum(['FA', 'SA'])
         .optional()
         .describe('Filter by agent view context (FA or SA).'),
+    sort: (0, common_schemas_1.createSortArraySchema)(exports.AgentStatsSortFieldSchema)
+        .optional()
+        .describe('Sort order. Array of {field, order} objects.'),
+    search: zod_1.z
+        .string()
+        .optional()
+        .describe('Search agent name (case-insensitive partial match).'),
+    office: zod_1.z
+        .array(zod_1.z.string().uuid())
+        .optional()
+        .describe('Filter by office IDs.'),
+    status: users_contract_1.UserStatusSchema.optional()
+        .default('ACTIVE')
+        .describe('Filter by agent account status. Defaults to ACTIVE.'),
+    minScore: zod_1.z.coerce
+        .number()
+        .optional()
+        .describe('Minimum performance score filter.'),
+    maxScore: zod_1.z.coerce
+        .number()
+        .optional()
+        .describe('Maximum performance score filter.'),
 });
 /**
  * FA Actives Widget - Today's active workers (FA perspective)
@@ -133,19 +240,76 @@ exports.FaActivesWidgetSchema = zod_1.z.object({
         byStatusFa: zod_1.z.record(actives_contract_1.ActiveStatusSchema, zod_1.z.number()),
     }),
 });
+// Reusable shape for "forToday" / "createdToday" buckets.
+// `includeOfficeSplits` adds the FA/SA/FaSa optional splits (admin aggregates only).
+const bookingsCountsBlock = (includeOfficeSplits) => zod_1.z.object({
+    total: zod_1.z.number(),
+    byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
+    byCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
+    /**
+     * Bookings that start on this day AND were created on this day (booked and
+     * starting same-day). A subset of the start-side count, so the share of
+     * today's starts = sameDay / starting. Only populated for the `forToday`
+     * bucket (meaningless for `createdToday`).
+     */
+    sameDay: zod_1.z.number().optional(),
+    ...(includeOfficeSplits
+        ? {
+            byStatusFa: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()).optional(),
+            byStatusSa: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()).optional(),
+            byStatusFaSa: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()).optional(),
+            byCategoryFa: zod_1.z
+                .record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number())
+                .optional(),
+            byCategorySa: zod_1.z
+                .record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number())
+                .optional(),
+            byCategoryFaSa: zod_1.z
+                .record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number())
+                .optional(),
+        }
+        : {}),
+});
 /**
  * FA Bookings Widget - Booking management (FA perspective)
  */
 exports.FaBookingsWidgetSchema = zod_1.z.object({
-    totalToday: zod_1.z.number().describe('Total bookings created today'),
-    byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
-    byCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
-    ongoingBookings: zod_1.z
+    forToday: bookingsCountsBlock(false),
+    createdToday: bookingsCountsBlock(false),
+    ongoingBookings: zod_1.z.number(),
+    startingToday: zod_1.z.number(),
+    pendingConfirmation: zod_1.z.number(),
+    upcomingStarts: zod_1.z.number(),
+});
+/**
+ * FA Jobs Widget - Job metrics for a single First Agent
+ */
+exports.FaJobsWidgetSchema = zod_1.z.object({
+    totalCreated: zod_1.z
+        .number()
+        .describe('Jobs created by this agent on the selected date'),
+    totalOpenPositions: zod_1.z
+        .number()
+        .describe('Sum of positions across jobs that were AVAILABLE at any point during the selected date'),
+    availableJobs: zod_1.z
+        .number()
+        .describe('Count of distinct jobs that were AVAILABLE at any point during the selected date'),
+    filledPositions: zod_1.z.number().describe('Positions filled on the selected date'),
+    transitionCounts: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.number())
+        .describe('Job status transitions on the selected date'),
+    fillRate: zod_1.z
+        .number()
+        .describe('Sourcing fill-rate over jobs CLOSED on the selected date: filledForRate / total positions (0 when no closes). Declared-filled counts as fully filled; booking-filled capped at total.'),
+    positionsAdjusted: zod_1.z
+        .number()
+        .describe('Count of position-count changes (POSITIONS_CHANGED) on the selected date'),
+    positionsNetChange: zod_1.z
         .number()
-        .describe('Bookings where today is between startDate and endDate (or no endDate)'),
-    startingToday: zod_1.z.number().describe('Bookings with startDate equal to today'),
-    pendingConfirmation: zod_1.z.number().describe('Bookings awaiting confirmation'),
-    upcomingStarts: zod_1.z.number().describe('All future bookings not starting today'),
+        .describe('Net positions added/removed across adjustments on the selected date'),
+    overbookedCount: zod_1.z
+        .number()
+        .describe('Count of jobs closed on the selected date with more bookings than positions'),
 });
 // =============================================================================
 // SECOND AGENT (SA) WIDGET SCHEMAS
@@ -161,15 +325,12 @@ exports.SaWorkersWidgetSchema = zod_1.z.object({
  * SA Bookings Widget - Booking management (SA perspective)
  */
 exports.SaBookingsWidgetSchema = zod_1.z.object({
-    totalToday: zod_1.z.number().describe('Total bookings created today'),
-    byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
-    byCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
-    ongoingBookings: zod_1.z
-        .number()
-        .describe('Bookings where today is between startDate and endDate (or no endDate)'),
-    startingToday: zod_1.z.number().describe('Bookings with startDate equal to today'),
-    waitingForConfirmation: zod_1.z.number(),
-    upcomingStarts: zod_1.z.number().describe('All future bookings not starting today'),
+    forToday: bookingsCountsBlock(false),
+    createdToday: bookingsCountsBlock(false),
+    ongoingBookings: zod_1.z.number(),
+    startingToday: zod_1.z.number(),
+    pendingConfirmation: zod_1.z.number(),
+    upcomingStarts: zod_1.z.number(),
 });
 /**
  * SA Actives Widget - Today's active workers (SA perspective)
@@ -190,12 +351,16 @@ exports.AdminFaAggregateSchema = zod_1.z.object({
     actives: zod_1.z.object({
         /** Flat structure (unlike per-agent FaActivesWidgetSchema which nests under 'today') */
         total: zod_1.z.number(),
-        byStatusFa: zod_1.z.record(actives_contract_1.ActiveStatusSchema, zod_1.z.number()),
+        /**
+         * Actives grouped by unified status, counting every active in scope (FA OR SA
+         * in office). Replaces the former separate byStatusFa/byStatusSa breakdowns now
+         * that the FA/SA status fields are unified into a single `status`.
+         */
+        byStatus: zod_1.z.record(actives_contract_1.ActiveStatusSchema, zod_1.z.number()),
     }),
     bookings: zod_1.z.object({
-        totalToday: zod_1.z.number(),
-        byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
-        byCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
+        forToday: bookingsCountsBlock(true),
+        createdToday: bookingsCountsBlock(true),
         ongoingBookings: zod_1.z.number(),
         startingToday: zod_1.z.number(),
         pendingConfirmation: zod_1.z.number(),
@@ -251,6 +416,35 @@ exports.AdminFaAggregateSchema = zod_1.z.object({
             .number()
             .describe('Own research leads new to system'),
     }),
+    jobs: zod_1.z.object({
+        totalOpenPositions: zod_1.z
+            .number()
+            .describe('Sum of positions across jobs that were AVAILABLE at any point during the selected date, across all FA agents'),
+        availableJobs: zod_1.z
+            .number()
+            .describe('Count of distinct jobs that were AVAILABLE at any point during the selected date, across all FA agents'),
+        createdToday: zod_1.z
+            .number()
+            .describe('Jobs created on this date across all FA agents'),
+        filledPositions: zod_1.z
+            .number()
+            .describe('Filled positions (current booking state, window-scoped)'),
+        transitionCounts: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.number())
+            .describe('Aggregated status transition counts for the date'),
+        fillRate: zod_1.z
+            .number()
+            .describe('Sourcing fill-rate over jobs CLOSED on the selected date: filledForRate / total positions (0 when no closes). Declared-filled counts as fully filled; booking-filled capped at total.'),
+        positionsAdjusted: zod_1.z
+            .number()
+            .describe('Count of position-count changes (POSITIONS_CHANGED) on the selected date'),
+        positionsNetChange: zod_1.z
+            .number()
+            .describe('Net positions added/removed across adjustments on the selected date'),
+        overbookedCount: zod_1.z
+            .number()
+            .describe('Count of jobs closed on the selected date with more bookings than positions'),
+    }),
     agentCount: zod_1.z
         .number()
         .describe('Number of FA agents included in aggregation'),
@@ -265,12 +459,11 @@ exports.AdminSaAggregateSchema = zod_1.z.object({
         byStatusSa: zod_1.z.record(actives_contract_1.ActiveStatusSchema, zod_1.z.number()),
     }),
     bookings: zod_1.z.object({
-        totalToday: zod_1.z.number(),
-        byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
-        byCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
+        forToday: bookingsCountsBlock(true),
+        createdToday: bookingsCountsBlock(true),
         ongoingBookings: zod_1.z.number(),
         startingToday: zod_1.z.number(),
-        waitingForConfirmation: zod_1.z.number(),
+        pendingConfirmation: zod_1.z.number(),
         upcomingStarts: zod_1.z.number(),
     }),
     workers: zod_1.z.object({
@@ -300,13 +493,24 @@ exports.ActivesTrendSchema = zod_1.z.object({
     }),
 });
 /**
- * Bookings trend data for charts
+ * Bookings trend data for charts.
+ *
+ * Per day we expose TWO views of the same timeline:
+ *  - created* : bookings CREATED on that day (the line) — `total`/`byStatus`
+ *               kept under their legacy names for backward compatibility.
+ *  - forDay*  : bookings whose startDate OR endDate is that day (the stacked
+ *               bars), grouped by category, with per-status detail for tooltips.
  */
 exports.BookingsTrendSchema = zod_1.z.object({
     data: zod_1.z.array(zod_1.z.object({
         date: zod_1.z.string(),
+        // created-on-this-day (the line)
         total: zod_1.z.number(),
         byStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
+        // for-this-day = startDate OR endDate on this day (the stacked bars)
+        forDayTotal: zod_1.z.number(),
+        forDayByCategory: zod_1.z.record(bookings_contract_1.BookingCategoryEnumSchema, zod_1.z.number()),
+        forDayByStatus: zod_1.z.record(bookings_contract_1.BookingTypeSchema, zod_1.z.number()),
     })),
     summary: zod_1.z.object({
         averageDaily: zod_1.z.number(),
@@ -323,6 +527,9 @@ exports.CallPerformanceTrendSchema = zod_1.z.object({
         averageRating: zod_1.z.number(),
         conversionRate: zod_1.z.number(),
         performanceScore: zod_1.z.number(),
+        // calls grouped by rating weight (0–10; "unrated" bucket for null) — the
+        // stacked-bar breakdown in the range chart.
+        ratingBreakdown: zod_1.z.record(zod_1.z.string(), zod_1.z.number()),
     })),
     summary: zod_1.z.object({
         averageDailyCalls: zod_1.z.number(),
@@ -344,6 +551,25 @@ exports.WorkersTrendSchema = zod_1.z.object({
         averagePerDay: zod_1.z.number(),
     }),
 });
+/**
+ * Jobs trend data for charts (FA). created/day bars; open positions is the
+ * positions available during each date (date-scoped); filled is a per-day flow.
+ */
+exports.JobsTrendSchema = zod_1.z.object({
+    data: zod_1.z.array(zod_1.z.object({
+        date: zod_1.z.string(),
+        created: zod_1.z.number(),
+        openPositions: zod_1.z.number(),
+        filled: zod_1.z.number(),
+        fillRate: zod_1.z.number().describe('Sourcing fill-rate for the date'),
+    })),
+    summary: zod_1.z.object({
+        totalCreated: zod_1.z.number(),
+        totalFilled: zod_1.z.number(),
+        endOpenPositions: zod_1.z.number(),
+        fillRate: zod_1.z.number().describe('Sourcing fill-rate over the range'),
+    }),
+});
 /**
  * Collaborations trend data for charts (FA only)
  */
@@ -359,6 +585,74 @@ exports.CollaborationsTrendSchema = zod_1.z.object({
     }),
 });
 // =============================================================================
+// PROOFS WIDGET + TREND SCHEMAS
+// =============================================================================
+/** Per-category breakdown: a total plus per-platform (section-type) counts. */
+const ProofPostBreakdownSchema = zod_1.z.object({
+    total: zod_1.z.number(),
+    byType: zod_1.z.record(proof_type_enum_1.PostTypeEnum, zod_1.z.number()),
+});
+const ProofBookingBreakdownSchema = zod_1.z.object({
+    total: zod_1.z.number(),
+    byType: zod_1.z.record(proof_type_enum_1.BookingTypeEnum, zod_1.z.number()),
+});
+/**
+ * Proofs widget — section-entry counts split by category, each broken down by
+ * platform/type. Used by the per-user widget and the admin total.
+ */
+exports.ProofsWidgetSchema = zod_1.z.object({
+    post: ProofPostBreakdownSchema,
+    booking: ProofBookingBreakdownSchema,
+    total: zod_1.z.number().describe('post.total + booking.total'),
+});
+/**
+ * Proofs trend — per-date post/booking breakdowns over a range. Bars use
+ * post.total/booking.total; the per-platform byType detail feeds the tooltip.
+ */
+exports.ProofsTrendSchema = zod_1.z.object({
+    data: zod_1.z.array(zod_1.z.object({
+        date: zod_1.z.string(),
+        post: ProofPostBreakdownSchema,
+        booking: ProofBookingBreakdownSchema,
+        total: zod_1.z.number(),
+    })),
+    summary: zod_1.z.object({
+        totalPost: zod_1.z.number(),
+        totalBooking: zod_1.z.number(),
+        total: zod_1.z.number(),
+        averageDaily: zod_1.z.number(),
+    }),
+});
+/**
+ * Lead activity outcome keys (curated lead event types)
+ */
+exports.LeadActivityOutcomeKeySchema = zod_1.z.enum([
+    'CONSENTED',
+    'DECLINED',
+    'WRONG_NUMBER',
+    'SNOOZED',
+    'OFFER_SENT',
+    'BOOKED',
+    'BOOKING_CANCELLED',
+    'TOO_FAR',
+    'NOT_INTERESTED',
+]);
+/**
+ * Lead activity trend data for charts (curated leads, by outcome).
+ */
+exports.LeadActivityTrendSchema = zod_1.z.object({
+    data: zod_1.z.array(zod_1.z.object({
+        date: zod_1.z.string(),
+        total: zod_1.z.number(),
+        byOutcome: zod_1.z.record(exports.LeadActivityOutcomeKeySchema, zod_1.z.number()),
+    })),
+    summary: zod_1.z.object({
+        averageDaily: zod_1.z.number(),
+        peakDay: zod_1.z.string().nullable(),
+        peakValue: zod_1.z.number(),
+    }),
+});
+// =============================================================================
 // API CONTRACT ROUTER
 // =============================================================================
 exports.dashboardWidgetsContract = c.router({
@@ -425,6 +719,48 @@ exports.dashboardWidgetsContract = c.router({
         summary: 'Get FA bookings widget data',
         description: 'Returns booking management summary for First Agent dashboard',
     },
+    getFaJobs: {
+        method: 'GET',
+        path: '/widgets/fa/jobs',
+        query: exports.DashboardWidgetQuerySchema,
+        responses: {
+            200: exports.FaJobsWidgetSchema,
+        },
+        summary: 'Get FA jobs widget data',
+        description: 'Returns job metrics (created, open positions, filled, transitions) for First Agent dashboard',
+    },
+    getProofs: {
+        method: 'GET',
+        path: '/widgets/proofs',
+        query: exports.DashboardWidgetQuerySchema,
+        responses: { 200: exports.ProofsWidgetSchema },
+        summary: 'Get the current user’s proofs widget data',
+        description: 'Counts proofs (split POST/BOOKING) where forUserId = current user and proofDate = the selected date.',
+    },
+    getProofsTrend: {
+        method: 'GET',
+        path: '/trends/proofs',
+        query: exports.DateRangeQuerySchema,
+        responses: { 200: exports.ProofsTrendSchema },
+        summary: 'Get the current user’s proofs trend',
+        description: 'Per-date POST/BOOKING proof counts (by proofDate) over a range.',
+    },
+    getAdminProofs: {
+        method: 'GET',
+        path: '/widgets/admin/proofs',
+        query: exports.DashboardWidgetQuerySchema,
+        responses: { 200: exports.ProofsWidgetSchema },
+        summary: 'Get aggregate proofs total across in-scope agents (Admin)',
+        description: 'Counts proofs (split POST/BOOKING) for all agents in the office/CASL scope on a date.',
+    },
+    getAdminProofsTrend: {
+        method: 'GET',
+        path: '/trends/admin/proofs',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: { 200: exports.ProofsTrendSchema },
+        summary: 'Get aggregate proofs trend across in-scope agents (Admin)',
+        description: 'Per-date POST/BOOKING proof totals across the office’s agents.',
+    },
     // -------------------------------------------------------------------------
     // SECOND AGENT (SA) WIDGETS
     // -------------------------------------------------------------------------
@@ -461,6 +797,18 @@ exports.dashboardWidgetsContract = c.router({
     // -------------------------------------------------------------------------
     // ADMIN WIDGETS
     // -------------------------------------------------------------------------
+    getAccessibleOffices: {
+        method: 'GET',
+        path: '/widgets/admin/accessible-offices',
+        responses: {
+            200: zod_1.z.array(zod_1.z.object({
+                id: zod_1.z.string().uuid(),
+                name: zod_1.z.string(),
+            })),
+        },
+        summary: 'Get offices accessible for dashboard filtering',
+        description: 'Returns offices the current user can view stats for. Admins see all offices; office managers see only their managed offices.',
+    },
     getAdminAgentStats: {
         method: 'GET',
         path: '/widgets/admin/agent-stats',
@@ -469,6 +817,10 @@ exports.dashboardWidgetsContract = c.router({
             200: (0, pagination_schema_1.createPaginatedResponseSchema)(zod_1.z.object({
                 agentId: zod_1.z.string().uuid(),
                 agentName: zod_1.z.string(),
+                officeName: zod_1.z
+                    .string()
+                    .nullable()
+                    .describe('Agent office name, null if unassigned'),
                 // Actives (FA)
                 activesFaTotal: zod_1.z.number(),
                 activesFaByStatus: zod_1.z.record(actives_contract_1.ActiveStatusSchema, zod_1.z.number()),
@@ -525,6 +877,43 @@ exports.dashboardWidgetsContract = c.router({
                 workersAddedToday: zod_1.z
                     .number()
                     .describe('Workers added by this agent on the selected date'),
+                // Jobs
+                jobsCreatedOnDate: zod_1.z
+                    .number()
+                    .describe('Jobs created by this agent on the selected date'),
+                jobsTotalOpenPositions: zod_1.z
+                    .number()
+                    .describe('Positions available on the selected date'),
+                jobsFilledPositions: zod_1.z
+                    .number()
+                    .describe('Filled positions (current booking state)'),
+                jobsTransitionCounts: zod_1.z
+                    .record(zod_1.z.string(), zod_1.z.number())
+                    .describe('Job status transitions on this date'),
+                jobsFillRate: zod_1.z
+                    .number()
+                    .describe('Sourcing fill-rate for jobs closed on the date'),
+                jobsPositionsAdjusted: zod_1.z
+                    .number()
+                    .describe('Position-count changes on the date'),
+                jobsOverbooked: zod_1.z
+                    .number()
+                    .describe('Jobs closed overbooked on the date'),
+                // Proofs per platform (section-type), forUserId-attributed, proofDate-scoped
+                proofsPostByType: zod_1.z
+                    .record(proof_type_enum_1.PostTypeEnum, zod_1.z.number())
+                    .describe('Post-type section counts for the date'),
+                proofsBookingByType: zod_1.z
+                    .record(proof_type_enum_1.BookingTypeEnum, zod_1.z.number())
+                    .describe('Booking-type section counts for the date'),
+                // Consent queue activity (curated lead outcomes) + offers
+                consentLeadsActioned: zod_1.z.number(),
+                consentConsented: zod_1.z.number(),
+                consentDeclined: zod_1.z.number(),
+                consentWrongNumber: zod_1.z.number(),
+                consentSnoozed: zod_1.z.number(),
+                offersSent: zod_1.z.number(),
+                offersBooked: zod_1.z.number(),
             })),
         },
         summary: 'Get daily stats for all agents (Admin)',
@@ -556,7 +945,7 @@ exports.dashboardWidgetsContract = c.router({
     getActivesTrend: {
         method: 'GET',
         path: '/trends/actives',
-        query: exports.DateRangeQuerySchema,
+        query: exports.RoleScopedDateRangeQuerySchema,
         responses: {
             200: exports.ActivesTrendSchema,
         },
@@ -566,7 +955,7 @@ exports.dashboardWidgetsContract = c.router({
     getBookingsTrend: {
         method: 'GET',
         path: '/trends/bookings',
-        query: exports.DateRangeQuerySchema,
+        query: exports.RoleScopedDateRangeQuerySchema,
         responses: {
             200: exports.BookingsTrendSchema,
         },
@@ -603,4 +992,113 @@ exports.dashboardWidgetsContract = c.router({
         summary: 'Get collaborations historical trend (FA only)',
         description: 'Returns time-series data for collaborations over a date range',
     },
+    getJobsTrend: {
+        method: 'GET',
+        path: '/trends/jobs',
+        query: exports.DateRangeQuerySchema,
+        responses: {
+            200: exports.JobsTrendSchema,
+        },
+        summary: 'Get jobs historical trend (FA)',
+        description: 'Returns time-series data for job creation, fills and open positions over a date range',
+    },
+    getAdminBookingsTrend: {
+        method: 'GET',
+        path: '/trends/admin/bookings',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: {
+            200: exports.BookingsTrendSchema,
+        },
+        summary: 'Get admin aggregate bookings trend',
+        description: 'Bookings trend aggregated across the office first agents over a date range',
+    },
+    getAdminActivesTrend: {
+        method: 'GET',
+        path: '/trends/admin/actives',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: {
+            200: exports.ActivesTrendSchema,
+        },
+        summary: 'Get admin aggregate actives trend',
+        description: 'Actives trend aggregated across the office first agents',
+    },
+    getAdminCallPerformanceTrend: {
+        method: 'GET',
+        path: '/trends/admin/call-performance',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: {
+            200: exports.CallPerformanceTrendSchema,
+        },
+        summary: 'Get admin aggregate call performance trend',
+        description: 'Call performance trend aggregated across the office first agents',
+    },
+    getAdminJobsTrend: {
+        method: 'GET',
+        path: '/trends/admin/jobs',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: {
+            200: exports.JobsTrendSchema,
+        },
+        summary: 'Get admin aggregate jobs trend',
+        description: 'Jobs trend aggregated across the office first agents',
+    },
+    getAdminWorkersTrend: {
+        method: 'GET',
+        path: '/trends/admin/workers',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: {
+            200: exports.WorkersTrendSchema,
+        },
+        summary: 'Get admin aggregate workers trend',
+        description: 'Workers trend aggregated across the office second agents',
+    },
+    getLeadActivityTrend: {
+        method: 'GET',
+        path: '/trends/lead-activity',
+        query: zod_1.z.object({ startDate: zod_1.z.string(), endDate: zod_1.z.string() }),
+        responses: { 200: exports.LeadActivityTrendSchema },
+        summary: "Current user's curated lead activity trend",
+    },
+    getAdminLeadActivityTrend: {
+        method: 'GET',
+        path: '/trends/admin/lead-activity',
+        query: exports.DateRangeOfficeQuerySchema,
+        responses: { 200: exports.LeadActivityTrendSchema },
+        summary: 'Admin aggregate curated lead activity trend',
+    },
+    getAgentBookingsTrend: {
+        method: 'GET',
+        path: '/trends/agent/:agentId/bookings',
+        query: exports.AgentTrendQuerySchema,
+        responses: { 200: exports.BookingsTrendSchema },
+        summary: 'Per-agent bookings trend (admin)',
+    },
+    getAgentActivesTrend: {
+        method: 'GET',
+        path: '/trends/agent/:agentId/actives',
+        query: exports.AgentTrendQuerySchema,
+        responses: { 200: exports.ActivesTrendSchema },
+        summary: 'Per-agent actives trend (admin)',
+    },
+    getAgentCallPerformanceTrend: {
+        method: 'GET',
+        path: '/trends/agent/:agentId/call-performance',
+        query: exports.DateRangeQuerySchema,
+        responses: { 200: exports.CallPerformanceTrendSchema },
+        summary: 'Per-agent call performance trend (admin)',
+    },
+    getAgentJobsTrend: {
+        method: 'GET',
+        path: '/trends/agent/:agentId/jobs',
+        query: exports.DateRangeQuerySchema,
+        responses: { 200: exports.JobsTrendSchema },
+        summary: 'Per-agent jobs trend (admin)',
+    },
+    getAgentWorkersTrend: {
+        method: 'GET',
+        path: '/trends/agent/:agentId/workers',
+        query: exports.DateRangeQuerySchema,
+        responses: { 200: exports.WorkersTrendSchema },
+        summary: 'Per-agent workers trend (admin)',
+    },
 });