@shuffl/api-contracts 0.5.6 → 0.5.8

package/dist/management.generated.js

@@ -235,6 +235,21 @@ const credentials_api_createInput = z
         z.literal('knowledge.uploads.retry'),
         z.literal('manager.current'),
         z.literal('mcp.knowledge'),
+        z.literal('mentorship.checkIns.answer'),
+        z.literal('mentorship.goals.remove'),
+        z.literal('mentorship.goals.save'),
+        z.literal('mentorship.join'),
+        z.literal('mentorship.leave'),
+        z.literal('mentorship.members.setStatus'),
+        z.literal('mentorship.mine'),
+        z.literal('mentorship.pairs.decide'),
+        z.literal('mentorship.pairs.end'),
+        z.literal('mentorship.pairs.setMine'),
+        z.literal('mentorship.pairs.suggest'),
+        z.literal('mentorship.programs.get'),
+        z.literal('mentorship.programs.list'),
+        z.literal('mentorship.programs.save'),
+        z.literal('mentorship.programs.setStatus'),
         z.literal('network.claim'),
         z.literal('network.introductions'),
         z.literal('network.mine'),
@@ -2207,6 +2222,21 @@ const credentials_api_listOutput = z.strictObject({
             z.literal('knowledge.uploads.retry'),
             z.literal('manager.current'),
             z.literal('mcp.knowledge'),
+            z.literal('mentorship.checkIns.answer'),
+            z.literal('mentorship.goals.remove'),
+            z.literal('mentorship.goals.save'),
+            z.literal('mentorship.join'),
+            z.literal('mentorship.leave'),
+            z.literal('mentorship.members.setStatus'),
+            z.literal('mentorship.mine'),
+            z.literal('mentorship.pairs.decide'),
+            z.literal('mentorship.pairs.end'),
+            z.literal('mentorship.pairs.setMine'),
+            z.literal('mentorship.pairs.suggest'),
+            z.literal('mentorship.programs.get'),
+            z.literal('mentorship.programs.list'),
+            z.literal('mentorship.programs.save'),
+            z.literal('mentorship.programs.setStatus'),
             z.literal('network.claim'),
             z.literal('network.introductions'),
             z.literal('network.mine'),
@@ -2427,6 +2457,8 @@ const credentials_api_listOutput = z.strictObject({
             z.literal('knowledge:read'),
             z.literal('knowledge:write'),
             z.literal('manager:read'),
+            z.literal('mentorship:read'),
+            z.literal('mentorship:write'),
             z.literal('operations:read'),
             z.literal('operations:write'),
             z.literal('operator:read'),
@@ -2640,6 +2672,21 @@ const credentials_api_listOutput = z.strictObject({
             z.literal('knowledge.uploads.retry'),
             z.literal('manager.current'),
             z.literal('mcp.knowledge'),
+            z.literal('mentorship.checkIns.answer'),
+            z.literal('mentorship.goals.remove'),
+            z.literal('mentorship.goals.save'),
+            z.literal('mentorship.join'),
+            z.literal('mentorship.leave'),
+            z.literal('mentorship.members.setStatus'),
+            z.literal('mentorship.mine'),
+            z.literal('mentorship.pairs.decide'),
+            z.literal('mentorship.pairs.end'),
+            z.literal('mentorship.pairs.setMine'),
+            z.literal('mentorship.pairs.suggest'),
+            z.literal('mentorship.programs.get'),
+            z.literal('mentorship.programs.list'),
+            z.literal('mentorship.programs.save'),
+            z.literal('mentorship.programs.setStatus'),
             z.literal('network.claim'),
             z.literal('network.introductions'),
             z.literal('network.mine'),
@@ -2862,6 +2909,8 @@ const credentials_api_listOutput = z.strictObject({
             z.literal('knowledge:read'),
             z.literal('knowledge:write'),
             z.literal('manager:read'),
+            z.literal('mentorship:read'),
+            z.literal('mentorship:write'),
             z.literal('operations:read'),
             z.literal('operations:write'),
             z.literal('operator:read'),
@@ -5115,6 +5164,8 @@ const groups_allAutomationsOutput = z.strictObject({
             ])
                 .optional()
                 .optional(),
+            channelId: z.string().optional().optional(),
+            channelName: z.string().optional().optional(),
             communityId: z.string().optional().optional(),
             note: z.string().optional().optional(),
             personId: z.string().optional().optional(),
@@ -5142,6 +5193,8 @@ const groups_allAutomationsOutput = z.strictObject({
             z.literal('invite_community'),
             z.literal('remove_from_group'),
             z.literal('send_message'),
+            z.literal('slack_invite'),
+            z.literal('slack_post'),
             z.literal('start_playbook'),
             z.literal('tell_hr'),
             z.literal('tell_manager'),
@@ -5213,6 +5266,8 @@ const groups_allAutomationsOutput = z.strictObject({
             z.literal('invite_community'),
             z.literal('remove_from_group'),
             z.literal('send_message'),
+            z.literal('slack_invite'),
+            z.literal('slack_post'),
             z.literal('start_playbook'),
             z.literal('tell_hr'),
             z.literal('tell_manager'),
@@ -5260,6 +5315,8 @@ const groups_automationsOutput = z.strictObject({
             ])
                 .optional()
                 .optional(),
+            channelId: z.string().optional().optional(),
+            channelName: z.string().optional().optional(),
             communityId: z.string().optional().optional(),
             note: z.string().optional().optional(),
             personId: z.string().optional().optional(),
@@ -5281,6 +5338,8 @@ const groups_automationsOutput = z.strictObject({
             z.literal('invite_community'),
             z.literal('remove_from_group'),
             z.literal('send_message'),
+            z.literal('slack_invite'),
+            z.literal('slack_post'),
             z.literal('start_playbook'),
             z.literal('tell_hr'),
             z.literal('tell_manager'),
@@ -5316,6 +5375,8 @@ const groups_automationsOutput = z.strictObject({
             z.literal('invite_community'),
             z.literal('remove_from_group'),
             z.literal('send_message'),
+            z.literal('slack_invite'),
+            z.literal('slack_post'),
             z.literal('start_playbook'),
             z.literal('tell_hr'),
             z.literal('tell_manager'),
@@ -5366,6 +5427,7 @@ const groups_setAutomationInput = z
             ])
                 .optional()
                 .optional(),
+            channelId: z.string().optional().optional(),
             communityId: z.string().optional().optional(),
             note: z.string().optional().optional(),
             personId: z.string().optional().optional(),
@@ -5388,6 +5450,8 @@ const groups_setAutomationInput = z
         z.literal('invite_community'),
         z.literal('remove_from_group'),
         z.literal('send_message'),
+        z.literal('slack_invite'),
+        z.literal('slack_post'),
         z.literal('start_playbook'),
         z.literal('tell_hr'),
         z.literal('tell_manager'),
@@ -5422,6 +5486,8 @@ const groups_setAutomationOutput = z.object({
             ])
                 .optional()
                 .optional(),
+            channelId: z.string().optional().optional(),
+            channelName: z.string().optional().optional(),
             communityId: z.string().optional().optional(),
             note: z.string().optional().optional(),
             personId: z.string().optional().optional(),
@@ -5443,6 +5509,8 @@ const groups_setAutomationOutput = z.object({
             z.literal('invite_community'),
             z.literal('remove_from_group'),
             z.literal('send_message'),
+            z.literal('slack_invite'),
+            z.literal('slack_post'),
             z.literal('start_playbook'),
             z.literal('tell_hr'),
             z.literal('tell_manager'),
@@ -6098,6 +6166,7 @@ const home_placesOutput = z.strictObject({
             z.literal('communities'),
             z.literal('connections'),
             z.literal('knowledge'),
+            z.literal('mentorship'),
             z.literal('playbook'),
             z.literal('praise'),
             z.literal('pulse'),
@@ -11640,6 +11709,443 @@ const playbooks_askBuddyOutput = z.object({
     ])
         .nullable(),
 });
+const mentorship_programs_listInput = z.strictObject({});
+const mentorship_programs_listOutput = z.strictObject({
+    programs: z.array(z.strictObject({
+        activePairs: z.number(),
+        audience: z.union([z.null(), z.string()]),
+        checkInWeeks: z.number(),
+        createdAt: z.string(),
+        description: z.string(),
+        groupId: z.union([z.null(), z.string()]),
+        id: z.string(),
+        mentees: z.number(),
+        mentorCapacity: z.number(),
+        mentors: z.number(),
+        name: z.string(),
+        pairingWeeks: z.number(),
+        status: z.union([
+            z.literal('active'),
+            z.literal('archived'),
+            z.literal('paused'),
+        ]),
+        suggested: z.number(),
+        waiting: z.number(),
+    })),
+});
+const mentorship_programs_getInput = z.strictObject({ programId: z.string() });
+const mentorship_programs_getOutput = z.strictObject({
+    members: z.array(z.strictObject({
+        id: z.string(),
+        joinedAt: z.string(),
+        name: z.string(),
+        pairs: z.number(),
+        photoUrl: z.union([z.null(), z.string()]),
+        role: z.union([z.literal('mentee'), z.literal('mentor')]),
+        slackUserId: z.union([z.null(), z.string()]),
+        status: z.union([
+            z.literal('active'),
+            z.literal('left'),
+            z.literal('removed'),
+        ]),
+        title: z.union([z.null(), z.string()]),
+        topics: z.string(),
+        userId: z.union([z.null(), z.string()]),
+    })),
+    pairs: z.array(z.strictObject({
+        checkIns: z.strictObject({
+            answered: z.number(),
+            asked: z.number(),
+            met: z.number(),
+        }),
+        endedAt: z.union([z.null(), z.string()]),
+        endReason: z.union([
+            z.null(),
+            z.literal('completed'),
+            z.literal('hr'),
+            z.literal('mentee'),
+            z.literal('mentor'),
+        ]),
+        endsOn: z.union([z.null(), z.string()]),
+        final: z.strictObject({
+            mentee: z.union([
+                z.null(),
+                z.literal('helped'),
+                z.literal('met'),
+                z.literal('not_yet'),
+            ]),
+            mentor: z.union([
+                z.null(),
+                z.literal('helped'),
+                z.literal('met'),
+                z.literal('not_yet'),
+            ]),
+        }),
+        id: z.string(),
+        mentee: z.strictObject({
+            id: z.string(),
+            name: z.string(),
+            photoUrl: z.union([z.null(), z.string()]),
+            slackUserId: z.union([z.null(), z.string()]),
+            title: z.union([z.null(), z.string()]),
+            userId: z.union([z.null(), z.string()]),
+        }),
+        mentor: z.strictObject({
+            id: z.string(),
+            name: z.string(),
+            photoUrl: z.union([z.null(), z.string()]),
+            slackUserId: z.union([z.null(), z.string()]),
+            title: z.union([z.null(), z.string()]),
+            userId: z.union([z.null(), z.string()]),
+        }),
+        nextCheckInOn: z.union([z.null(), z.string()]),
+        reasons: z.array(z.string()),
+        startedAt: z.union([z.null(), z.string()]),
+        status: z.union([
+            z.literal('active'),
+            z.literal('ended'),
+            z.literal('paused'),
+            z.literal('skipped'),
+            z.literal('suggested'),
+        ]),
+        suggestedAt: z.string(),
+    })),
+    program: z.strictObject({
+        activePairs: z.number(),
+        audience: z.union([z.null(), z.string()]),
+        checkInWeeks: z.number(),
+        createdAt: z.string(),
+        description: z.string(),
+        groupId: z.union([z.null(), z.string()]),
+        id: z.string(),
+        mentees: z.number(),
+        mentorCapacity: z.number(),
+        mentors: z.number(),
+        name: z.string(),
+        pairingWeeks: z.number(),
+        status: z.union([
+            z.literal('active'),
+            z.literal('archived'),
+            z.literal('paused'),
+        ]),
+        suggested: z.number(),
+        waiting: z.number(),
+    }),
+});
+const mentorship_programs_saveInput = z
+    .strictObject({
+    checkInWeeks: z.number().optional().optional(),
+    description: z.string().optional().optional(),
+    groupId: z.union([z.null(), z.string()]).optional().optional(),
+    id: z.string().optional().optional(),
+    mentorCapacity: z.number().optional().optional(),
+    name: z.string(),
+    pairingWeeks: z.number().optional().optional(),
+})
+    .extend({
+    confirm: z.literal('mentorship.programs.save'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_programs_saveOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        created: z.boolean(),
+        grouped: z.boolean(),
+        id: z.string(),
+    })
+        .nullable(),
+});
+const mentorship_programs_setStatusInput = z
+    .strictObject({
+    programId: z.string(),
+    status: z.union([
+        z.literal('active'),
+        z.literal('archived'),
+        z.literal('paused'),
+    ]),
+})
+    .extend({
+    confirm: z.literal('mentorship.programs.setStatus'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_programs_setStatusOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        changed: z.boolean(),
+        status: z.union([
+            z.literal('active'),
+            z.literal('archived'),
+            z.literal('paused'),
+        ]),
+    })
+        .nullable(),
+});
+const mentorship_pairs_suggestInput = z
+    .strictObject({ programId: z.string() })
+    .extend({
+    confirm: z.literal('mentorship.pairs.suggest'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_pairs_suggestOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({ suggested: z.number(), waiting: z.number() })
+        .nullable(),
+});
+const mentorship_pairs_decideInput = z
+    .strictObject({
+    decision: z.union([z.literal('approve'), z.literal('skip')]),
+    pairId: z.string(),
+})
+    .extend({
+    confirm: z.literal('mentorship.pairs.decide'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_pairs_decideOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .union([
+        z.strictObject({
+            decision: z.literal('skip'),
+            endsOn: z.undefined().optional(),
+            reached: z.number(),
+            status: z.literal('skipped'),
+        }),
+        z.strictObject({
+            decision: z.literal('approve'),
+            endsOn: z.string(),
+            reached: z.number(),
+            status: z.literal('active'),
+        }),
+    ])
+        .nullable(),
+});
+const mentorship_pairs_endInput = z
+    .strictObject({ pairId: z.string() })
+    .extend({
+    confirm: z.literal('mentorship.pairs.end'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_pairs_endOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z.strictObject({ changed: z.boolean() }).nullable(),
+});
+const mentorship_members_setStatusInput = z
+    .strictObject({
+    personId: z.string(),
+    programId: z.string(),
+    role: z.union([z.literal('mentee'), z.literal('mentor')]),
+    status: z.union([z.literal('active'), z.literal('removed')]),
+})
+    .extend({
+    confirm: z.literal('mentorship.members.setStatus'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_members_setStatusOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z.strictObject({ changed: z.boolean() }).nullable(),
+});
+const mentorship_mineInput = z.strictObject({});
+const mentorship_mineOutput = z.strictObject({
+    pairs: z.array(z.strictObject({
+        checkIns: z.array(z.strictObject({
+            answer: z.union([
+                z.null(),
+                z.literal('helped'),
+                z.literal('met'),
+                z.literal('not_yet'),
+            ]),
+            dueOn: z.string(),
+            id: z.string(),
+            kind: z.union([z.literal('check_in'), z.literal('final')]),
+        })),
+        endedAt: z.union([z.null(), z.string()]),
+        endsOn: z.string(),
+        goals: z.array(z.strictObject({
+            done: z.boolean(),
+            id: z.string(),
+            title: z.string(),
+        })),
+        id: z.string(),
+        nextCheckInOn: z.union([z.null(), z.string()]),
+        other: z.strictObject({
+            id: z.string(),
+            name: z.string(),
+            photoUrl: z.union([z.null(), z.string()]),
+            slackUserId: z.union([z.null(), z.string()]),
+            title: z.union([z.null(), z.string()]),
+            userId: z.union([z.null(), z.string()]),
+        }),
+        otherTopics: z.string(),
+        program: z.string(),
+        role: z.union([z.literal('mentee'), z.literal('mentor')]),
+        startedAt: z.string(),
+        status: z.union([
+            z.literal('active'),
+            z.literal('ended'),
+            z.literal('paused'),
+        ]),
+    })),
+    programs: z.array(z.strictObject({
+        audience: z.union([z.null(), z.string()]),
+        description: z.string(),
+        id: z.string(),
+        mentee: z.union([
+            z.null(),
+            z.strictObject({
+                status: z.union([
+                    z.literal('active'),
+                    z.literal('left'),
+                    z.literal('removed'),
+                ]),
+                topics: z.string(),
+            }),
+        ]),
+        mentor: z.union([
+            z.null(),
+            z.strictObject({
+                status: z.union([
+                    z.literal('active'),
+                    z.literal('left'),
+                    z.literal('removed'),
+                ]),
+                topics: z.string(),
+            }),
+        ]),
+        name: z.string(),
+        terms: z.string(),
+        waiting: z.boolean(),
+    })),
+});
+const mentorship_joinInput = z
+    .strictObject({
+    programId: z.string(),
+    role: z.union([z.literal('mentee'), z.literal('mentor')]),
+    topics: z.string(),
+})
+    .extend({
+    confirm: z.literal('mentorship.join'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_joinOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        joined: z.boolean(),
+        role: z.union([z.literal('mentee'), z.literal('mentor')]),
+        topics: z.boolean(),
+    })
+        .nullable(),
+});
+const mentorship_leaveInput = z
+    .strictObject({
+    programId: z.string(),
+    role: z.union([z.literal('mentee'), z.literal('mentor')]),
+})
+    .extend({
+    confirm: z.literal('mentorship.leave'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_leaveOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        changed: z.boolean(),
+        role: z.union([z.literal('mentee'), z.literal('mentor')]),
+    })
+        .nullable(),
+});
+const mentorship_pairs_setMineInput = z
+    .strictObject({
+    pairId: z.string(),
+    status: z.union([
+        z.literal('active'),
+        z.literal('ended'),
+        z.literal('paused'),
+    ]),
+})
+    .extend({
+    confirm: z.literal('mentorship.pairs.setMine'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_pairs_setMineOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        changed: z.boolean(),
+        role: z.string(),
+        status: z.union([
+            z.literal('active'),
+            z.literal('ended'),
+            z.literal('paused'),
+        ]),
+    })
+        .nullable(),
+});
+const mentorship_goals_saveInput = z
+    .strictObject({
+    done: z
+        .union([z.literal(false), z.literal(true)])
+        .optional()
+        .optional(),
+    goalId: z.string().optional().optional(),
+    pairId: z.string(),
+    title: z.string().optional().optional(),
+})
+    .extend({
+    confirm: z.literal('mentorship.goals.save'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_goals_saveOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        added: z.boolean(),
+        done: z.boolean(),
+        goalId: z.union([z.null(), z.string()]),
+    })
+        .nullable(),
+});
+const mentorship_goals_removeInput = z
+    .strictObject({ goalId: z.string(), pairId: z.string() })
+    .extend({
+    confirm: z.literal('mentorship.goals.remove'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_goals_removeOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z.strictObject({ removed: z.boolean() }).nullable(),
+});
+const mentorship_checkIns_answerInput = z
+    .strictObject({
+    answer: z.union([
+        z.literal('helped'),
+        z.literal('met'),
+        z.literal('not_yet'),
+    ]),
+    checkInId: z.string(),
+})
+    .extend({
+    confirm: z.literal('mentorship.checkIns.answer'),
+    requestKey: z.string().min(1).max(128),
+});
+const mentorship_checkIns_answerOutput = z.object({
+    receipt: commandReceiptSchema,
+    result: z
+        .strictObject({
+        answer: z.union([
+            z.literal('helped'),
+            z.literal('met'),
+            z.literal('not_yet'),
+        ]),
+        changed: z.boolean(),
+        kind: z.union([z.literal('check_in'), z.literal('final')]),
+        role: z.union([z.literal('mentee'), z.literal('mentor')]),
+    })
+        .nullable(),
+});
 const celebrations_programInput = z.strictObject({});
 const celebrations_programOutput = z.strictObject({
     programs: z.array(z.strictObject({
@@ -12242,6 +12748,7 @@ const notifications_preferencesOutput = z.strictObject({
             z.literal('hr_reply'),
             z.literal('hr_request'),
             z.literal('legacy_upgrade'),
+            z.literal('mentorship'),
             z.literal('playbook'),
             z.literal('policy_acknowledgement'),
             z.literal('praise'),
@@ -12271,6 +12778,7 @@ const notifications_preferencesOutput = z.strictObject({
             z.literal('hr_reply'),
             z.literal('hr_request'),
             z.literal('legacy_upgrade'),
+            z.literal('mentorship'),
             z.literal('playbook'),
             z.literal('policy_acknowledgement'),
             z.literal('praise'),
@@ -12304,6 +12812,7 @@ const notifications_saveInput = z
         z.literal('hr_reply'),
         z.literal('hr_request'),
         z.literal('legacy_upgrade'),
+        z.literal('mentorship'),
         z.literal('playbook'),
         z.literal('policy_acknowledgement'),
         z.literal('praise'),
@@ -12336,6 +12845,7 @@ const notifications_saveOutput = z.object({
                 z.literal('hr_reply'),
                 z.literal('hr_request'),
                 z.literal('legacy_upgrade'),
+                z.literal('mentorship'),
                 z.literal('playbook'),
                 z.literal('policy_acknowledgement'),
                 z.literal('praise'),
@@ -12369,6 +12879,7 @@ const notifications_saveOutput = z.object({
                 z.literal('hr_reply'),
                 z.literal('hr_request'),
                 z.literal('legacy_upgrade'),
+                z.literal('mentorship'),
                 z.literal('playbook'),
                 z.literal('policy_acknowledgement'),
                 z.literal('praise'),
@@ -14036,6 +14547,8 @@ const users_activityOutput = z.strictObject({
                 z.literal('invite_community'),
                 z.literal('remove_from_group'),
                 z.literal('send_message'),
+                z.literal('slack_invite'),
+                z.literal('slack_post'),
                 z.literal('start_playbook'),
                 z.literal('tell_hr'),
                 z.literal('tell_manager'),
@@ -17784,7 +18297,7 @@ export const managementContract = {
             .route({
             method: 'POST',
             path: '/manage/groups/setAutomation',
-            summary: 'Add or change an automation on a group: send a message, ask a Pulse question, start a playbook, invite to a community, add to Connections, give a badge, add to or remove from another group, or tell HR, their manager or someone named, right away or days later; a new one starts paused',
+            summary: 'Add or change an automation on a group: send a message, ask a Pulse question, start a playbook, invite to a community, add to Connections, give a badge, add to or remove from another group, add to or post in a Slack channel (`config.channelId`, read back from Slack), or tell HR, their manager or someone named, right away or days later; a new one starts paused',
         })
             .input(groups_setAutomationInput)
             .output(groups_setAutomationOutput),
@@ -18433,6 +18946,153 @@ export const managementContract = {
                 .output(knowledge_uploads_retryOutput),
         },
     },
+    mentorship: {
+        checkIns: {
+            answer: base
+                .meta({ scope: 'self:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/checkIns/answer',
+                summary: 'Answer whether you met your mentor or mentee, and whether it helped',
+            })
+                .input(mentorship_checkIns_answerInput)
+                .output(mentorship_checkIns_answerOutput),
+        },
+        goals: {
+            remove: base
+                .meta({ scope: 'self:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/goals/remove',
+                summary: 'Remove a goal from your mentorship, as the mentee',
+            })
+                .input(mentorship_goals_removeInput)
+                .output(mentorship_goals_removeOutput),
+            save: base
+                .meta({ scope: 'self:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/goals/save',
+                summary: 'Add, rename or check off a goal in your mentorship, as the mentee',
+            })
+                .input(mentorship_goals_saveInput)
+                .output(mentorship_goals_saveOutput),
+        },
+        join: base
+            .meta({ scope: 'self:write' })
+            .route({
+            method: 'POST',
+            path: '/manage/mentorship/join',
+            summary: 'Join a mentorship program as a mentor or mentee, saying what you can help with or want to learn',
+        })
+            .input(mentorship_joinInput)
+            .output(mentorship_joinOutput),
+        leave: base
+            .meta({ scope: 'self:write' })
+            .route({
+            method: 'POST',
+            path: '/manage/mentorship/leave',
+            summary: 'Leave a mentorship program as a mentor or mentee',
+        })
+            .input(mentorship_leaveInput)
+            .output(mentorship_leaveOutput),
+        members: {
+            setStatus: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/members/setStatus',
+                summary: 'Take someone off a mentorship program, or put them back',
+            })
+                .input(mentorship_members_setStatusInput)
+                .output(mentorship_members_setStatusOutput),
+        },
+        mine: base
+            .meta({ scope: 'self:read' })
+            .route({
+            method: 'POST',
+            path: '/manage/mentorship/mine',
+            summary: 'Your mentorship programs and pairings, with goals and check-ins',
+        })
+            .input(mentorship_mineInput)
+            .output(mentorship_mineOutput),
+        pairs: {
+            decide: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/pairs/decide',
+                summary: 'Approve a suggested mentorship pair, which introduces them, or skip it',
+            })
+                .input(mentorship_pairs_decideInput)
+                .output(mentorship_pairs_decideOutput),
+            end: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/pairs/end',
+                summary: 'End a mentorship pairing early',
+            })
+                .input(mentorship_pairs_endInput)
+                .output(mentorship_pairs_endOutput),
+            setMine: base
+                .meta({ scope: 'self:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/pairs/setMine',
+                summary: 'Pause, resume or end your own mentorship pairing',
+            })
+                .input(mentorship_pairs_setMineInput)
+                .output(mentorship_pairs_setMineOutput),
+            suggest: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/pairs/suggest',
+                summary: 'Suggest a mentor outside their reporting line for every mentee still waiting',
+            })
+                .input(mentorship_pairs_suggestInput)
+                .output(mentorship_pairs_suggestOutput),
+        },
+        programs: {
+            get: base
+                .meta({ scope: 'mentorship:read' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/programs/get',
+                summary: 'One mentorship program: who joined, the suggested pairs and whether pairs are meeting',
+            })
+                .input(mentorship_programs_getInput)
+                .output(mentorship_programs_getOutput),
+            list: base
+                .meta({ scope: 'mentorship:read' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/programs/list',
+                summary: 'List mentorship programs, with how many mentors, mentees and pairs each has',
+            })
+                .input(mentorship_programs_listInput)
+                .output(mentorship_programs_listOutput),
+            save: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/programs/save',
+                summary: 'Create or change a mentorship program: who can join, how long pairings last and how often pairs check in',
+            })
+                .input(mentorship_programs_saveInput)
+                .output(mentorship_programs_saveOutput),
+            setStatus: base
+                .meta({ scope: 'mentorship:write' })
+                .route({
+                method: 'POST',
+                path: '/manage/mentorship/programs/setStatus',
+                summary: 'Turn mentorship programs on, pause one, or archive one and end its pairs',
+            })
+                .input(mentorship_programs_setStatusInput)
+                .output(mentorship_programs_setStatusOutput),
+        },
+    },
     network: {
         claim: base
             .meta({ scope: 'profile:write' })