@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/desk.d.ts

@@ -0,0 +1,1765 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.desk` (Desk): 71 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"apply_account_plan_desk_accounts__account_id__plan_apply_post">;
+ *
+ * Reference with examples: desk.md
+ */
+/* eslint-disable */
+
+/** `g8.api.desk.<member>` -> the operationId it calls. */
+export interface DeskMembers {
+  applyAccountPlan: "apply_account_plan_desk_accounts__account_id__plan_apply_post";
+  askDesk: "ask_desk_desk_ask_post";
+  checkCommitteePlay: "check_committee_play_desk_accounts__account_id__committee_plays__action_id__check_get";
+  checkDeskPlanStageSweep: "check_desk_plan_stage_sweep_desk_org_settings_plan_stages_check_get";
+  createOrReplanAccountPlan: "create_or_replan_account_plan_desk_accounts__account_id__plan_post";
+  decideDeskPlayApproval: "decide_desk_play_approval_desk_plays_approvals__execution_id__decide_post";
+  draftAccountPlan: "draft_account_plan_desk_accounts__account_id__plan_draft_post";
+  editAccountCommittee: "edit_account_committee_desk_accounts__account_id__committee_post";
+  findCommitteeMemberLinkedin: "find_committee_member_linkedin_desk_accounts__account_id__committee__contact_id__find_linkedin_post";
+  getAccountContext: "get_account_context_desk_accounts__account_id__context_get";
+  getAccountPlan: "get_account_plan_desk_accounts__account_id__plan_get";
+  getAccountPlanHistory: "get_account_plan_history_desk_accounts__account_id__plan_history_get";
+  getDeskAutonomy: "get_desk_autonomy_desk_autonomy_get";
+  getDeskBatch: "get_desk_batch_desk_batch_get";
+  getDeskBlockQueue: "get_desk_block_queue_desk_blocks__list_id__queue_get";
+  getDeskCallTarget: "get_desk_call_target_desk_decisions__decision_id__call_target_post";
+  getDeskCommitteeHeat: "get_desk_committee_heat_desk_committee_heat_get";
+  getDeskCommitteeTargets: "get_desk_committee_targets_desk_committee_targets_get";
+  getDeskComplianceSummary: "get_desk_compliance_summary_desk_compliance_summary_get";
+  getDeskContactCallTarget: "get_desk_contact_call_target_desk_contacts__contact_id__call_target_post";
+  getDeskCoverage: "get_desk_coverage_desk_coverage_get";
+  getDeskDecisionBrief: "get_desk_decision_brief_desk_decisions__decision_id__brief_get";
+  getDeskDecisionCardContext: "get_desk_decision_card_context_desk_decisions__decision_id__card_context_get";
+  getDeskDecisionConversation: "get_desk_decision_conversation_desk_decisions__decision_id__conversation_get";
+  getDeskHomeSummary: "get_desk_home_summary_desk_home_summary_get";
+  getDeskKickoff: "get_desk_kickoff_desk_kickoff_get";
+  getDeskKickoffAudio: "get_desk_kickoff_audio_desk_kickoff_audio_get";
+  getDeskLinkedinSender: "get_desk_linkedin_sender_desk_linkedin_sender_get";
+  getDeskListGoals: "get_desk_list_goals_desk_list_goals_get";
+  getDeskListGroupOverride: "get_desk_list_group_override_desk_list_group_override_get";
+  getDeskListPriority: "get_desk_list_priority_desk_list_priority_get";
+  getDeskNextBest: "get_desk_next_best_desk_next_best_get";
+  getDeskOrgSettings: "get_desk_org_settings_desk_org_settings_get";
+  getDeskPlayExecution: "get_desk_play_execution_desk_plays_executions__execution_id__get";
+  getDeskPulse: "get_desk_pulse_desk_pulse_get";
+  getDeskReplyTarget: "get_desk_reply_target_desk_decisions__decision_id__reply_target_post";
+  getDeskSmsTarget: "get_desk_sms_target_desk_decisions__decision_id__sms_target_post";
+  getDeskWrapped: "get_desk_wrapped_desk_wrapped_get";
+  improveDeskEmail: "improve_desk_email_desk_email_improve_post";
+  listAccountPlans: "list_account_plans_desk_accounts_plans_get";
+  listCommitteePlays: "list_committee_plays_desk_accounts__account_id__committee_plays_get";
+  listCompletedDeskDecisions: "list_completed_desk_decisions_desk_decisions_completed_get";
+  listDeskBlocks: "list_desk_blocks_desk_blocks_get";
+  listDeskCardPlays: "list_desk_card_plays_desk_decisions__decision_id__plays_get";
+  listDeskDecisions: "list_desk_decisions_desk_decisions_get";
+  listDeskPlayApprovals: "list_desk_play_approvals_desk_plays_approvals_get";
+  listDeskUpcoming: "list_desk_upcoming_desk_upcoming_get";
+  markDeskKickoffPlayed: "mark_desk_kickoff_played_desk_kickoff_played_post";
+  postDeskVoiceMemo: "post_desk_voice_memo_desk_voice_memo_post";
+  previewAccountPlan: "preview_account_plan_desk_accounts__account_id__plan_preview_post";
+  pullDeskBatch: "pull_desk_batch_desk_batch_pull_post";
+  replanDeskDecision: "replan_desk_decision_desk_decisions__decision_id__replan_post";
+  resolveDeskDecision: "resolve_desk_decision_desk_decisions__decision_id__resolve_post";
+  reviveDeskListGoal: "revive_desk_list_goal_desk_list_goals__list_id__revive_post";
+  runCommitteePlay: "run_committee_play_desk_accounts__account_id__committee_plays__action_id__run_post";
+  runDeskCardPlay: "run_desk_card_play_desk_decisions__decision_id__plays__action_id__run_post";
+  runDeskPlanStageSweep: "run_desk_plan_stage_sweep_desk_org_settings_plan_stages_run_post";
+  scoreDeskEmail: "score_desk_email_desk_email_score_post";
+  sendCommitteeLinkedinInvite: "send_committee_linkedin_invite_desk_accounts__account_id__committee__contact_id__linkedin_invite_post";
+  sendDeskReply: "send_desk_reply_desk_decisions__decision_id__send_reply_post";
+  sendDeskSms: "send_desk_sms_desk_decisions__decision_id__send_sms_post";
+  startDeskBatch: "start_desk_batch_desk_batch_start_post";
+  undoDeskDecision: "undo_desk_decision_desk_decisions__decision_id__undo_post";
+  unsnoozeDeskDecision: "unsnooze_desk_decision_desk_decisions__decision_id__unsnooze_post";
+  updateAccountPlanStep: "update_account_plan_step_desk_accounts__account_id__plan_steps__step_id__put";
+  updateDeskAutonomy: "update_desk_autonomy_desk_autonomy_put";
+  updateDeskLinkedinSender: "update_desk_linkedin_sender_desk_linkedin_sender_put";
+  updateDeskListGoal: "update_desk_list_goal_desk_list_goals_put";
+  updateDeskListGroupOverride: "update_desk_list_group_override_desk_list_group_override_put";
+  updateDeskListPriority: "update_desk_list_priority_desk_list_priority_put";
+  updateDeskOrgSettings: "update_desk_org_settings_desk_org_settings_put";
+}
+
+/** Input and output of every `g8.api.desk` operation, keyed by operationId. */
+export interface DeskOperations {
+  /**
+   * POST /desk/accounts/{account_id}/plan/apply
+   * Apply Account Plan
+   * tier: write · scope: deals:write
+   */
+  apply_account_plan_desk_accounts__account_id__plan_apply_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AccountPlanApplyRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/ask
+   * Ask Desk
+   * tier: billable · scope: deals:run
+   */
+  ask_desk_desk_ask_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskAskRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/accounts/{account_id}/committee/plays/{action_id}/check
+   * Check Committee Play
+   * tier: read · scope: deals:read
+   */
+  check_committee_play_desk_accounts__account_id__committee_plays__action_id__check_get: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+      /** Play id, from `.../committee/plays`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * GET /desk/org-settings/plan-stages/check
+   * Check Desk Plan Stage Sweep
+   * tier: read · scope: deals:read
+   */
+  check_desk_plan_stage_sweep_desk_org_settings_plan_stages_check_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/plan
+   * Create Or Replan Account Plan
+   * tier: write · scope: deals:write
+   */
+  create_or_replan_account_plan_desk_accounts__account_id__plan_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AccountPlanUpsertRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/plays/approvals/{execution_id}/decide
+   * Decide Desk Play Approval
+   * tier: external · scope: deals:run
+   */
+  decide_desk_play_approval_desk_plays_approvals__execution_id__decide_post: {
+    input: {
+    path: {
+      /** Paused workflow execution id. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskApprovalDecisionRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/plan/draft
+   * Draft Account Plan
+   * tier: billable · scope: deals:run
+   */
+  draft_account_plan_desk_accounts__account_id__plan_draft_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/committee
+   * Edit Account Committee
+   * tier: write · scope: deals:write
+   */
+  edit_account_committee_desk_accounts__account_id__committee_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CommitteeEditRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/committee/{contact_id}/find-linkedin
+   * Find Committee Member Linkedin
+   * tier: billable · scope: deals:run
+   */
+  find_committee_member_linkedin_desk_accounts__account_id__committee__contact_id__find_linkedin_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+      /** The committee member to look up. */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * GET /desk/accounts/{account_id}/context
+   * Get Account Context
+   * tier: read · scope: deals:read
+   */
+  get_account_context_desk_accounts__account_id__context_get: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    query?: {
+      activity_limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * GET /desk/accounts/{account_id}/plan
+   * Get Account Plan
+   * tier: read · scope: deals:read
+   */
+  get_account_plan_desk_accounts__account_id__plan_get: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * GET /desk/accounts/{account_id}/plan/history
+   * Get Account Plan History
+   * tier: read · scope: deals:read
+   */
+  get_account_plan_history_desk_accounts__account_id__plan_history_get: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    query?: {
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanListPayload_;
+  };
+  /**
+   * GET /desk/autonomy
+   * Get Desk Autonomy
+   * tier: read · scope: deals:read
+   */
+  get_desk_autonomy_desk_autonomy_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/batch
+   * Get Desk Batch
+   * tier: read · scope: deals:read
+   */
+  get_desk_batch_desk_batch_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). A batch is scoped to the rep's local day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_Union_DeskBatch__NoneType__;
+  };
+  /**
+   * GET /desk/blocks/{list_id}/queue
+   * Get Desk Block Queue
+   * tier: read · scope: deals:read
+   */
+  get_desk_block_queue_desk_blocks__list_id__queue_get: {
+    input: {
+    path: {
+      /** Dial list (audience) id. */
+      list_id: number;
+    };
+    query?: {
+      /** Only the contacts whose redial day is up, never the not-yet-called half. */
+      redial_only?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskListPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/call-target
+   * Get Desk Call Target
+   * tier: read · scope: deals:read
+   */
+  get_desk_call_target_desk_decisions__decision_id__call_target_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/committee-heat
+   * Get Desk Committee Heat
+   * tier: read · scope: deals:read
+   */
+  get_desk_committee_heat_desk_committee_heat_get: {
+    input: {
+    query: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/committee-targets
+   * Get Desk Committee Targets
+   * tier: read · scope: deals:read
+   */
+  get_desk_committee_targets_desk_committee_targets_get: {
+    input: {
+    query: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/compliance-summary
+   * Get Desk Compliance Summary
+   * tier: read · scope: deals:read
+   */
+  get_desk_compliance_summary_desk_compliance_summary_get: {
+    input: {
+    query?: {
+      /** Open deals to aggregate over. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/contacts/{contact_id}/call-target
+   * Get Desk Contact Call Target
+   * tier: read · scope: deals:read
+   */
+  get_desk_contact_call_target_desk_contacts__contact_id__call_target_post: {
+    input: {
+    path: {
+      /** Contact id. */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/coverage
+   * Get Desk Coverage
+   * tier: read · scope: deals:read
+   */
+  get_desk_coverage_desk_coverage_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/decisions/{decision_id}/brief
+   * Get Desk Decision Brief
+   * tier: read · scope: deals:read
+   */
+  get_desk_decision_brief_desk_decisions__decision_id__brief_get: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /desk/decisions/{decision_id}/card-context
+   * Get Desk Decision Card Context
+   * tier: read · scope: deals:read
+   */
+  get_desk_decision_card_context_desk_decisions__decision_id__card_context_get: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /desk/decisions/{decision_id}/conversation
+   * Get Desk Decision Conversation
+   * tier: read · scope: deals:read
+   */
+  get_desk_decision_conversation_desk_decisions__decision_id__conversation_get: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /desk/home-summary
+   * Get Desk Home Summary
+   * tier: read · scope: deals:read
+   */
+  get_desk_home_summary_desk_home_summary_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/kickoff
+   * Get Desk Kickoff
+   * tier: billable · scope: deals:run
+   */
+  get_desk_kickoff_desk_kickoff_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/kickoff/audio
+   * Get Desk Kickoff Audio
+   * tier: billable · scope: deals:run
+   */
+  get_desk_kickoff_audio_desk_kickoff_audio_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * GET /desk/linkedin-sender
+   * Get Desk Linkedin Sender
+   * tier: read · scope: deals:read
+   */
+  get_desk_linkedin_sender_desk_linkedin_sender_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/list-goals
+   * Get Desk List Goals
+   * tier: read · scope: deals:read
+   */
+  get_desk_list_goals_desk_list_goals_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/list-group-override
+   * Get Desk List Group Override
+   * tier: read · scope: deals:read
+   */
+  get_desk_list_group_override_desk_list_group_override_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/list-priority
+   * Get Desk List Priority
+   * tier: read · scope: deals:read
+   */
+  get_desk_list_priority_desk_list_priority_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/next-best
+   * Get Desk Next Best
+   * tier: read · scope: deals:read
+   */
+  get_desk_next_best_desk_next_best_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/org-settings
+   * Get Desk Org Settings
+   * tier: read · scope: deals:read
+   */
+  get_desk_org_settings_desk_org_settings_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/plays/executions/{execution_id}
+   * Get Desk Play Execution
+   * tier: read · scope: deals:read
+   */
+  get_desk_play_execution_desk_plays_executions__execution_id__get: {
+    input: {
+    path: {
+      /** Workflow execution id. */
+      execution_id: string;
+    };
+    query?: {
+      /** Card this run belongs to. When given, a TERMINAL status is persisted onto the card - so this read has a write side, and omitting it keeps the read pure. */
+      decision_id?: string | null;
+      /** Play this run belongs to. */
+      action_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/pulse
+   * Get Desk Pulse
+   * tier: read · scope: deals:read
+   */
+  get_desk_pulse_desk_pulse_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/reply-target
+   * Get Desk Reply Target
+   * tier: read · scope: deals:read
+   */
+  get_desk_reply_target_desk_decisions__decision_id__reply_target_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/sms-target
+   * Get Desk Sms Target
+   * tier: read · scope: deals:read
+   */
+  get_desk_sms_target_desk_decisions__decision_id__sms_target_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/wrapped
+   * Get Desk Wrapped
+   * tier: read · scope: deals:read
+   */
+  get_desk_wrapped_desk_wrapped_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/email-improve
+   * Improve Desk Email
+   * tier: billable · scope: deals:run
+   */
+  improve_desk_email_desk_email_improve_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskEmailImproveRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * GET /desk/accounts/plans
+   * List Account Plans
+   * tier: read · scope: deals:read
+   */
+  list_account_plans_desk_accounts_plans_get: {
+    input: {
+    query?: {
+      /** Only plans in this status. */
+      status?: ("draft" | "active" | "paused" | "archived") | null;
+      /** Which board: `deals` (accounts with an open deal), `campaign` (requires `campaign_id`), or `all`. Omitted means all. */
+      source?: ("all" | "deals" | "campaign") | null;
+      /** REQUIRED when `source=campaign`. */
+      campaign_id?: string | null;
+      /** Only accounts this caller owns. Ownership is resolved BEFORE paging, so this changes the total rather than filtering a page. */
+      mine?: boolean;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanListPayload_;
+  };
+  /**
+   * GET /desk/accounts/{account_id}/committee/plays
+   * List Committee Plays
+   * tier: read · scope: deals:read
+   */
+  list_committee_plays_desk_accounts__account_id__committee_plays_get: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanListPayload_;
+  };
+  /**
+   * GET /desk/decisions/completed
+   * List Completed Desk Decisions
+   * tier: read · scope: deals:read
+   */
+  list_completed_desk_decisions_desk_decisions_completed_get: {
+    input: {
+    query?: {
+      limit?: number;
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). A batch is scoped to the rep's local day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskDecisionListResponse_;
+  };
+  /**
+   * GET /desk/blocks
+   * List Desk Blocks
+   * tier: read · scope: deals:read
+   */
+  list_desk_blocks_desk_blocks_get: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskListPayload_;
+  };
+  /**
+   * GET /desk/decisions/{decision_id}/plays
+   * List Desk Card Plays
+   * tier: read · scope: deals:read
+   */
+  list_desk_card_plays_desk_decisions__decision_id__plays_get: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskListPayload_;
+  };
+  /**
+   * GET /desk/decisions
+   * List Desk Decisions
+   * tier: read · scope: deals:read
+   */
+  list_desk_decisions_desk_decisions_get: {
+    input: {
+    query?: {
+      /** Filter by decision type. */
+      decision_type?: string | null;
+      /** Filter by signal FAMILY, e.g. "forms" or "website". */
+      source_group?: string | null;
+      /** Filter by EXACT signal id, e.g. "form_submitted". */
+      source?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskDecisionListResponse_;
+  };
+  /**
+   * GET /desk/plays/approvals
+   * List Desk Play Approvals
+   * tier: read · scope: deals:read
+   */
+  list_desk_play_approvals_desk_plays_approvals_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskListPayload_;
+  };
+  /**
+   * GET /desk/upcoming
+   * List Desk Upcoming
+   * tier: read · scope: deals:read
+   */
+  list_desk_upcoming_desk_upcoming_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskListPayload_;
+  };
+  /**
+   * POST /desk/kickoff/played
+   * Mark Desk Kickoff Played
+   * tier: write · scope: deals:write
+   */
+  mark_desk_kickoff_played_desk_kickoff_played_post: {
+    input: {
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/voice-memo
+   * Post Desk Voice Memo
+   * tier: billable · scope: deals:run
+   */
+  post_desk_voice_memo_desk_voice_memo_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/plan/preview
+   * Preview Account Plan
+   * tier: read · scope: deals:read
+   */
+  preview_account_plan_desk_accounts__account_id__plan_preview_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AccountPlanPreviewRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/batch/pull
+   * Pull Desk Batch
+   * tier: write · scope: deals:write
+   */
+  pull_desk_batch_desk_batch_pull_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskBatchPullRequest;
+  };
+    output: ApiResponse_DeskBatch_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/replan
+   * Replan Desk Decision
+   * tier: billable · scope: deals:run
+   */
+  replan_desk_decision_desk_decisions__decision_id__replan_post: {
+    input: {
+    path: {
+      /** Plan-review decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/resolve
+   * Resolve Desk Decision
+   * tier: write · scope: deals:write
+   */
+  resolve_desk_decision_desk_decisions__decision_id__resolve_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskResolveRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /desk/list-goals/{list_id}/revive
+   * Revive Desk List Goal
+   * tier: write · scope: deals:write
+   */
+  revive_desk_list_goal_desk_list_goals__list_id__revive_post: {
+    input: {
+    path: {
+      /** Dial list (audience) id. */
+      list_id: number;
+    };
+    query?: {
+      /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). The desk day is the rep's LOCAL day; a wrong offset silently returns the wrong day rather than erroring. */
+      tz_offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/committee/plays/{action_id}/run
+   * Run Committee Play
+   * tier: external · scope: deals:run
+   */
+  run_committee_play_desk_accounts__account_id__committee_plays__action_id__run_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+      /** Play id, from `.../committee/plays`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/plays/{action_id}/run
+   * Run Desk Card Play
+   * tier: external · scope: deals:run
+   */
+  run_desk_card_play_desk_decisions__decision_id__plays__action_id__run_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+      /** Play id, from `/desk/decisions/{id}/plays`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/org-settings/plan-stages/run
+   * Run Desk Plan Stage Sweep
+   * tier: billable · scope: deals:run
+   */
+  run_desk_plan_stage_sweep_desk_org_settings_plan_stages_run_post: {
+    input: {
+    query?: {
+      /** Plan at most this many deals in this press. Omitted means up to the daily cap. */
+      limit?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/email-score
+   * Score Desk Email
+   * tier: billable · scope: deals:run
+   */
+  score_desk_email_desk_email_score_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskEmailScoreRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/accounts/{account_id}/committee/{contact_id}/linkedin-invite
+   * Send Committee Linkedin Invite
+   * tier: external · scope: deals:run
+   */
+  send_committee_linkedin_invite_desk_accounts__account_id__committee__contact_id__linkedin_invite_post: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+      /** The committee member to invite. */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CommitteeLinkedInInviteRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/send-reply
+   * Send Desk Reply
+   * tier: external · scope: deals:run
+   */
+  send_desk_reply_desk_decisions__decision_id__send_reply_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskSendReplyRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/send-sms
+   * Send Desk Sms
+   * tier: external · scope: deals:run
+   */
+  send_desk_sms_desk_decisions__decision_id__send_sms_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskSendSmsRequest;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * POST /desk/batch/start
+   * Start Desk Batch
+   * tier: write · scope: deals:write
+   */
+  start_desk_batch_desk_batch_start_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskBatchStartRequest;
+  };
+    output: ApiResponse_DeskBatch_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/undo
+   * Undo Desk Decision
+   * tier: write · scope: deals:write
+   */
+  undo_desk_decision_desk_decisions__decision_id__undo_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /desk/decisions/{decision_id}/unsnooze
+   * Unsnooze Desk Decision
+   * tier: write · scope: deals:write
+   */
+  unsnooze_desk_decision_desk_decisions__decision_id__unsnooze_post: {
+    input: {
+    path: {
+      /** Decision id (UUID). */
+      decision_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PUT /desk/accounts/{account_id}/plan/steps/{step_id}
+   * Update Account Plan Step
+   * tier: write · scope: deals:write
+   */
+  update_account_plan_step_desk_accounts__account_id__plan_steps__step_id__put: {
+    input: {
+    path: {
+      /** The account's mashup company id (`cb_account_plans.account_id`). */
+      account_id: number;
+      /** Step id, as carried on the plan. */
+      step_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AccountPlanStepUpdateRequest;
+  };
+    output: ApiResponse_AccountPlanPayload_;
+  };
+  /**
+   * PUT /desk/autonomy
+   * Update Desk Autonomy
+   * tier: external · scope: deals:run
+   */
+  update_desk_autonomy_desk_autonomy_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskAutonomyUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * PUT /desk/linkedin-sender
+   * Update Desk Linkedin Sender
+   * tier: write · scope: deals:write
+   */
+  update_desk_linkedin_sender_desk_linkedin_sender_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskLinkedInSenderUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * PUT /desk/list-goals
+   * Update Desk List Goal
+   * tier: write · scope: deals:write
+   */
+  update_desk_list_goal_desk_list_goals_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskListGoalUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * PUT /desk/list-group-override
+   * Update Desk List Group Override
+   * tier: write · scope: deals:write
+   */
+  update_desk_list_group_override_desk_list_group_override_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskListGroupOverrideUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * PUT /desk/list-priority
+   * Update Desk List Priority
+   * tier: write · scope: deals:write
+   */
+  update_desk_list_priority_desk_list_priority_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskListPriorityUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+  /**
+   * PUT /desk/org-settings
+   * Update Desk Org Settings
+   * tier: external · scope: deals:run
+   */
+  update_desk_org_settings_desk_org_settings_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskOrgSettingsUpdate;
+  };
+    output: ApiResponse_DeskPayload_;
+  };
+}
+
+// 40 schemas referenced above (the same as G8Contract.<Name>).
+
+/**
+ * Persist the approved steps as a NEW plan version.
+ *
+ * `proposed_plan` must be non-empty: apply REPLACES the account's steps, so
+ * an empty proposal would blank the plan. The app answers 400 rather than
+ * doing it, and this surface forwards that rather than second-guessing it.
+ */
+export interface AccountPlanApplyRequest {
+  instruction?: string | null;
+  proposed_plan?: Array<AccountPlanStep>;
+  rationale?: string | null;
+  /** draft | active | paused | archived. */
+  status?: string | null;
+  /** What caused this (re)plan. */
+  trigger?: string;
+}
+
+/** An open envelope for a LIST result, so a bare list keeps its shape. */
+export interface AccountPlanListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** An open envelope for a plan, a context read or a committee result. */
+export type AccountPlanPayload = Record<string, unknown>;
+
+/**
+ * Diff a proposed plan against the current version. Persists NOTHING.
+ *
+ * It also does not consume the signal-replanner cooldown, so a caller can
+ * preview as often as it likes before committing with `/plan/apply`.
+ */
+export interface AccountPlanPreviewRequest {
+  /** Free-text note echoed back with the diff. */
+  instruction?: string | null;
+  proposed_plan?: Array<AccountPlanStep>;
+}
+
+/**
+ * One step in a plan: who to reach, on what channel, when, and why now.
+ *
+ * `extra="allow"` mirrors the app's own model, which is also open - the step
+ * shape carries per-channel extras the desk adds as it learns new channels,
+ * and a closed mirror would DROP them on the way in rather than pass them
+ * through.
+ *
+ * `approval_status` is closed because it reaches a real `Literal` inside the
+ * handler: a free value would raise there and escape as a 500 instead of a
+ * 422 naming the four states.
+ */
+export interface AccountPlanStep {
+  approval_status?: "pending" | "approved" | "rejected" | "edited";
+  channel?: string | null;
+  /** Committee member this step is aimed at. */
+  contact_id?: unknown | null;
+  draft_content?: string | null;
+  scheduled_at?: string | null;
+  status?: string | null;
+  /** Caller-assigned id, stable across versions. */
+  step_id: string;
+  why_now?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * Approve, reject or edit ONE step on the latest plan version.
+ *
+ * `action` is closed - it reaches a real `Literal` inside the handler.
+ * `draft_content` is what `edit` edits; sending it with `approve` or
+ * `reject` is accepted and ignored, exactly as the app treats it.
+ */
+export interface AccountPlanStepUpdateRequest {
+  action: "approve" | "reject" | "edit";
+  draft_content?: string | null;
+  scheduled_at?: string | null;
+}
+
+/**
+ * Create the account's plan, or REPLAN it.
+ *
+ * There is no update: a replan inserts a new version and bumps
+ * `plan_version`. Prior versions stay readable through
+ * `/desk/accounts/{account_id}/plan/history`.
+ */
+export interface AccountPlanUpsertRequest {
+  buying_committee_id?: string | null;
+  buying_committee_members?: Array<Record<string, unknown>> | null;
+  current_plan?: Array<AccountPlanStep>;
+  deep_research_summary?: string | null;
+  goal?: string | null;
+  /** Optional why-now, recorded in the trigger history. */
+  rationale?: string | null;
+  /** draft | active | paused | archived. */
+  status?: string | null;
+  /** What caused this (re)plan. */
+  trigger?: string;
+}
+
+export interface ApiResponse_AccountPlanListPayload_ {
+  data: AccountPlanListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AccountPlanPayload_ {
+  data: AccountPlanPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DeskBatch_ {
+  data: DeskBatch;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DeskDecisionListResponse_ {
+  data: DeskDecisionListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DeskListPayload_ {
+  data: DeskListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DeskPayload_ {
+  data: DeskPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_Union_DeskBatch__NoneType__ {
+  data: DeskBatch | null;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+/**
+ * Add and remove buying-committee members in one call.
+ *
+ * A committee edit rides plan versioning like everything else: it persists a
+ * NEW plan version, preserving the existing steps. Both lists are applied in
+ * the same version, so adding and removing in one request cannot leave the
+ * committee half-changed.
+ */
+export interface CommitteeEditRequest {
+  add?: Array<CommitteeMemberInput>;
+  /** Contact ids to take off the committee. */
+  remove?: Array<number>;
+}
+
+/**
+ * The optional note on a LinkedIn connection request.
+ *
+ * 300 characters is LinkedIn's own cap, not a display limit.
+ */
+export interface CommitteeLinkedInInviteRequest {
+  /** Optional invite note. Capped by LinkedIn at 300 characters. */
+  note?: string | null;
+}
+
+/** A contact to put on the buying committee. */
+export interface CommitteeMemberInput {
+  contact_id: number;
+  /** Their part in the decision, e.g. "champion". */
+  role?: string | null;
+}
+
+/**
+ * Approve or reject one paused workflow run.
+ *
+ * `decision` is CLOSED to the two values the engine accepts. A free string
+ * would reach the engine and come back as a 502, which reads like an outage
+ * rather than a typo.
+ */
+export interface DeskApprovalDecisionRequest {
+  decision: "approve" | "reject";
+  /** Optional note. The engine records it as `notes` on an approval and `reason` on a rejection. */
+  note?: string | null;
+}
+
+/**
+ * A grounded question about a card or a deal.
+ *
+ * Give it something to ground on: with neither `decision_id` nor `deal_id`
+ * the answer has no record to read and comes back generic.
+ */
+export interface DeskAskRequest {
+  /** Ground the answer in this deal. */
+  deal_id?: string | null;
+  /** Ground the answer in this decision card. */
+  decision_id?: string | null;
+  question: string;
+}
+
+/**
+ * Which decisions the desk may act on WITHOUT asking the rep first.
+ *
+ * A lane of `autopilot` means the desk executes that decision type on the
+ * rep's behalf - including the ones that send. `approve` asks first, `off`
+ * stops the type being raised at all. The app validates both maps against its
+ * own `DecisionType` / `AutonomyLane` / lane-family vocabularies and answers
+ * 400 on anything it could not act on, so this surface forwards them as open
+ * maps rather than freezing a copy of three enums that move with the product.
+ *
+ * An omitted `autonomy_families` means "I did not touch the family
+ * questions", so a partial save cannot wipe them. An explicit `{}` clears
+ * them and hands every type back to its own lane - the only way back once a
+ * family has been answered.
+ */
+export interface DeskAutonomyUpdate {
+  /** Map of lane family -> lane (plan_work/outreach/hygiene_and_alerts). Omit to leave family answers untouched; send `{}` to clear them. */
+  autonomy_families?: Record<string, string> | null;
+  /** Map of decision_type -> lane (autopilot/approve/off). */
+  lanes: Record<string, string>;
+}
+
+/**
+ * Today's frozen batch.
+ *
+ * A batch is FINITE by design: the rep freezes a ranked slice of the queue so
+ * the day has an end. `None` from the app means no batch has been started
+ * today, which is different from a batch with no items left - the response
+ * keeps that distinction rather than flattening both to an empty batch.
+ */
+export interface DeskBatch {
+  completed?: number | null;
+  completed_at?: string | null;
+  id?: string | null;
+  item_ids?: Array<string>;
+  remaining?: number | null;
+  started_at?: string | null;
+  status?: string | null;
+  total?: number | null;
+  [key: string]: unknown;
+}
+
+/** Append newly selected cards to today's existing batch. */
+export interface DeskBatchPullRequest {
+  /** Decision ids to append. 1-40 - a smaller cap than start, by design. */
+  item_ids: Array<string>;
+  /** The rep's UTC offset in minutes. */
+  tz_offset?: number;
+}
+
+/**
+ * Freeze today's ranked queue into a finite batch.
+ *
+ * `item_ids` is typed `list[UUID]`, not `list[str]`, so a malformed id is a
+ * request-validation 422 that NAMES the offending element. Typed as strings,
+ * the app's own `list[UUID]` model raises a pydantic `ValidationError` from
+ * inside the handler body instead - the same class of bare-500 the path
+ * guard exists to prevent, one layer in.
+ */
+export interface DeskBatchStartRequest {
+  /** Decision ids to freeze into the batch. 1-80 - the cap is the app's. */
+  item_ids: Array<string>;
+  /** The rep's UTC offset in MINUTES (local = UTC + tz_offset). A batch is scoped to the rep's local day, so a wrong offset returns yesterday's batch or starts a second one. */
+  tz_offset?: number;
+}
+
+/** One card in the queue: something the desk thinks a rep should do next. */
+export interface DeskDecision {
+  created_at?: string | null;
+  /** What kind of action this card is asking for. */
+  decision_type?: string | null;
+  entity_id?: string | null;
+  entity_type?: string | null;
+  id?: string | null;
+  priority?: number | null;
+  resolved_at?: string | null;
+  snoozed_until?: string | null;
+  /** Exact signal id, e.g. "form_submitted". */
+  source?: string | null;
+  /** Signal family, e.g. "forms". */
+  source_group?: string | null;
+  /** pending, approved, edited, skipped, deferred, snoozed, done_already. */
+  status?: string | null;
+  summary?: string | null;
+  title?: string | null;
+  [key: string]: unknown;
+}
+
+/** A page of decision cards. */
+export interface DeskDecisionListResponse {
+  decisions?: Array<DeskDecision>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+/** A draft to rewrite. The rewrite targets its FAILING subscores. */
+export interface DeskEmailImproveRequest {
+  body: string;
+  subject?: string;
+}
+
+/** A draft to score 0-100. Heuristics plus an AI read. */
+export interface DeskEmailScoreRequest {
+  body: string;
+  /** Recipient name, used for the personalisation subscore. */
+  contact_name?: string | null;
+  subject?: string;
+}
+
+/**
+ * Claim a LinkedIn account for this rep, or give the claim up.
+ *
+ * NULL is the release, not a no-op. The claim is exclusive: two unique
+ * constraints on the underlying table are what stop a rep taking a
+ * colleague's account, so a claim on a held account is refused with a 409
+ * rather than silently reassigned.
+ */
+export interface DeskLinkedInSenderUpdate {
+  /** The LinkedIn account to claim. NULL releases the current claim. */
+  provider_member_id?: string | null;
+}
+
+/** Set or clear one list's daily dial target. */
+export interface DeskListGoalUpdate {
+  /** The dial list this target belongs to. */
+  audience_id: number;
+  /** Dials per day. NULL CLEARS the target rather than setting zero. */
+  target?: number | null;
+}
+
+/**
+ * The rep's own moves of dial lists into a band. THE WHOLE MAP.
+ *
+ * Keyed by dial-list (audience) id. A PUT REPLACES what is stored rather
+ * than merging one entry into it, so a list left out goes back to the band
+ * the desk would have put it in, and `{}` clears every move.
+ */
+export interface DeskListGroupOverrideUpdate {
+  /** Dial-list id -> band (`form`, `warm` or `cold`). REPLACES every stored move. */
+  overrides?: Record<string, "form" | "warm" | "cold">;
+}
+
+/** An open envelope for a LIST result, so a bare list keeps its shape. */
+export interface DeskListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * The rep's dial-list order. THE WHOLE ORDER, most important first.
+ *
+ * Not a partial edit and not an append: the app replaces the stored order
+ * with exactly this list, so a caller that sends one id has pinned one list
+ * and UNPINNED every other. Said here because the field name alone reads like
+ * "add these".
+ */
+export interface DeskListPriorityUpdate {
+  /** Dial-list (audience) ids, most important first. REPLACES the whole order - an empty list clears every pin. */
+  audience_ids?: Array<number>;
+}
+
+/**
+ * Org-level desk settings. PARTIAL - an unset field is left untouched.
+ *
+ * Mirrors `desk.interfaces.fastapi.dtos.DeskOrgSettingsUpdate` field for
+ * field, pinned by test, because it is constructed inside the proxy.
+ *
+ * THREE KINDS OF FIELD LIVE HERE AND THEY ARE NOT EQUALLY QUIET
+ * ---------------------------------------------------------------
+ * Most are thresholds and ids. But `max_auto_account_plans_per_day`,
+ * `max_account_replans_per_day` and `max_skill_plans_per_day` are the org's
+ * DAILY SPEND CAPS on charged model calls, and `desk_acts_on_signals`,
+ * `desk_drafts_with_ai`, `desk_writes_deal_plans`, `reps_may_fire_workflows`
+ * and `stalled_deal_send_email` are the switches that let the desk act - and
+ * email - on its own. That is why this operation is not tiered a plain
+ * `write`; see the router docstring.
+ *
+ * Every value is validated by the app's own `validated_payload()` and
+ * `save_desk_org_settings`, which answer 400 with the reason. This surface
+ * does not second-guess either.
+ */
+export interface DeskOrgSettingsUpdate {
+  contact_update_planned_deals_only?: boolean | null;
+  daily_action_target?: number | null;
+  desk_acts_on_signals?: boolean | null;
+  desk_drafts_with_ai?: boolean | null;
+  desk_escalates_to_managers?: boolean | null;
+  desk_keeps_crm_tidy?: boolean | null;
+  desk_writes_deal_plans?: boolean | null;
+  enrichment_win_fields?: Array<string> | null;
+  fallback_owner_emails?: Array<string> | null;
+  lead_sla_minutes?: number | null;
+  /** DAILY CAP on charged account re-plans. */
+  max_account_replans_per_day?: number | null;
+  /** DAILY CAP on charged auto account plans. */
+  max_auto_account_plans_per_day?: number | null;
+  max_cards_per_generator_per_day?: number | null;
+  /** DAILY CAP on charged skill plans. */
+  max_skill_plans_per_day?: number | null;
+  no_reply_channels?: Array<string> | null;
+  no_reply_threshold_days?: number | null;
+  overdue_self_task_enabled?: boolean | null;
+  overdue_task_max_age_days?: number | null;
+  pipeline_target_quarterly?: number | null;
+  plan_required_stage_ids?: Array<string> | null;
+  reps_may_fire_workflows?: boolean | null;
+  signal_policies?: Record<string, DeskSignalPolicy> | null;
+  /** Per-signal kill switches. `ai_briefs` is the desk-wide LLM-spend gate and `morning_kickoff` gates the daily briefing. */
+  signals_enabled?: Record<string, boolean> | null;
+  stalled_deal_approve_after_days?: number | null;
+  stalled_deal_enabled?: boolean | null;
+  stalled_deal_fallback_manager_user_id?: string | null;
+  stalled_deal_manager_user_id?: string | null;
+  stalled_deal_min_amount?: number | null;
+  stalled_deal_min_deal_age_days?: number | null;
+  stalled_deal_reassign_to_user_id?: string | null;
+  stalled_deal_reminder_after_hours?: number | null;
+  stalled_deal_require_activity_evidence?: boolean | null;
+  /** Let the stalled-deal escalation EMAIL the manager. */
+  stalled_deal_send_email?: boolean | null;
+  stalled_deal_skip_crm_synced_transfer?: boolean | null;
+  stalled_deal_stage_ids?: Array<string> | null;
+  stalled_deal_undo_window_minutes?: number | null;
+  stalled_deal_warn_after_days?: number | null;
+}
+
+/**
+ * An open envelope for one desk object.
+ *
+ * Open on purpose - see the module docstring. A rebuilder gets every field
+ * the desk returns, including ones added after this contract version.
+ */
+export type DeskPayload = Record<string, unknown>;
+
+/** Resolve a pending decision. */
+export interface DeskResolveRequest {
+  /** Action payload, e.g. the edited email body. */
+  action_taken?: Record<string, unknown> | null;
+  /** REQUIRED when status=snoozed. Wake time, UTC. */
+  snoozed_until?: string | null;
+  /** approved, edited, skipped, deferred, snoozed or done_already. A status the app does not accept is a 400 rather than being silently dropped, which is why this is an open string and not an enum this surface would have to keep in lock-step. `done_already` resolves the card AND records the work on its entity. */
+  status: string;
+  /** Early-wake condition, valid only with status=snoozed: reply | site_visit | stage_change. `snoozed_until` stays required as the fallback timeout. `stage_change` is accepted but only wakes via that timeout today - no deal-stage-change event reaches the desk signal consumer yet. */
+  wake_condition?: string | null;
+}
+
+/**
+ * The rep's reply, as it will arrive in the prospect's inbox.
+ *
+ * An omitted `subject` keeps the thread's own. The opt-out check runs AGAIN
+ * on send - `reply-target` already asked, but that answer is as old as the
+ * editing session and a STOP arriving while the rep typed must not be sent
+ * through.
+ */
+export interface DeskSendReplyRequest {
+  /** The reply body. Reaches a real person. */
+  body: string;
+  subject?: string | null;
+}
+
+/**
+ * The rep's text, as it will arrive on the prospect's phone.
+ *
+ * 1600 characters is the app's ceiling, not a display limit - it is the
+ * concatenated-SMS cap, and a longer body is refused rather than truncated.
+ */
+export interface DeskSendSmsRequest {
+  /** The message. Reaches a real phone and costs carrier spend. */
+  body: string;
+}
+
+/**
+ * Per-signal policy override. Mirrors the app's `DeskSignalPolicyUpdate`.
+ *
+ * Open (`extra="allow"`) rather than pinned: this nests inside a JSONB
+ * settings blob the desk extends per signal family, and a closed mirror would
+ * reject a key the app has just learned to read.
+ */
+export type DeskSignalPolicy = Record<string, unknown>;
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}