@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/agents.d.ts

@@ -0,0 +1,1622 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.agents` (Agents): 65 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"answer_agent_discovery_agent_onboarding_discovery_answer_post">;
+ *
+ * Reference with examples: agents.md
+ */
+/* eslint-disable */
+
+/** `g8.api.agents.<member>` -> the operationId it calls. */
+export interface AgentsMembers {
+  answerAgentDiscovery: "answer_agent_discovery_agent_onboarding_discovery_answer_post";
+  cancelAgentWorkItem: "cancel_agent_work_item_agent_work_items__work_item_id__cancel_post";
+  captureAgentEntryPoint: "capture_agent_entry_point_agent_onboarding_entry_point_post";
+  captureAgentSignupAttribution: "capture_agent_signup_attribution_agent_onboarding_attribution_post";
+  confirmAgentSessionCard: "confirm_agent_session_card_agent_sessions__session_id__cards__card_id__confirm_post";
+  createAgentSession: "create_agent_session_agent_sessions_post";
+  createAgentVoiceDraft: "create_agent_voice_draft_agent_sessions_voice_draft_post";
+  createAgentWorkItem: "create_agent_work_item_agent_work_items_post";
+  decideAgentOperatorApproval: "decide_agent_operator_approval_agent_operators__operator__approvals__task_id__decide_post";
+  deleteAgentSession: "delete_agent_session_agent_sessions__session_id__delete";
+  endAgentSessionVoice: "end_agent_session_voice_agent_sessions__session_id__voice__voice_id__delete";
+  getAgentDiscovery: "get_agent_discovery_agent_onboarding_discovery_get";
+  getAgentDiscoveryCampaignBrief: "get_agent_discovery_campaign_brief_agent_onboarding_discovery_campaign_brief_get";
+  getAgentDiscoveryReport: "get_agent_discovery_report_agent_onboarding_discovery_report_get";
+  getAgentMemory: "get_agent_memory_agent_memory_get";
+  getAgentOperatingModel: "get_agent_operating_model_agent_operators_operating_model_get";
+  getAgentOperatorCatalog: "get_agent_operator_catalog_agent_operators__operator__catalog_get";
+  getAgentOperatorFeedbackSummary: "get_agent_operator_feedback_summary_agent_operators__operator__feedback_summary_get";
+  getAgentOperatorForApprovalTask: "get_agent_operator_for_approval_task_agent_operators_approvals__task_id__operator_get";
+  getAgentOperatorHealth: "get_agent_operator_health_agent_operators__operator__health_get";
+  getAgentOperatorRecipient: "get_agent_operator_recipient_agent_operators__operator__recipient_get";
+  getAgentOperatorScorecard: "get_agent_operator_scorecard_agent_operators__operator__scorecard_get";
+  getAgentOperatorStatus: "get_agent_operator_status_agent_operators__operator__status_get";
+  getAgentOperatorsSummary: "get_agent_operators_summary_agent_operators_summary_get";
+  getAgentOversight: "get_agent_oversight_agent_oversight_get";
+  getAgentProactiveOpener: "get_agent_proactive_opener_agent_proactive_opener_get";
+  getAgentPushbackEvidence: "get_agent_pushback_evidence_agent_evidence_pushback_get";
+  getAgentSession: "get_agent_session_agent_sessions__session_id__get";
+  getAgentSessionState: "get_agent_session_state_agent_sessions__session_id__state_get";
+  getAgentSessionVoiceCapability: "get_agent_session_voice_capability_agent_sessions__session_id__voice_get";
+  getAgentVoiceCapability: "get_agent_voice_capability_agent_sessions_voice_capability_get";
+  listAgentOperatorActions: "list_agent_operator_actions_agent_operators__operator__actions_get";
+  listAgentOperatorActivity: "list_agent_operator_activity_agent_operators__operator__activity_get";
+  listAgentOperatorActivityRecords: "list_agent_operator_activity_records_agent_operators__operator__activity__task_id__records_get";
+  listAgentOperatorApprovalSources: "list_agent_operator_approval_sources_agent_operators_approvals_sources_get";
+  listAgentOperatorCollections: "list_agent_operator_collections_agent_operators__operator__collections_get";
+  listAgentOperatorFindings: "list_agent_operator_findings_agent_operators__operator__findings_get";
+  listAgentOperatorSkills: "list_agent_operator_skills_agent_operators__operator__skills_get";
+  listAgentOperators: "list_agent_operators_agent_operators_get";
+  listAgentSessions: "list_agent_sessions_agent_sessions_get";
+  listAgentSpecialists: "list_agent_specialists_agent_specialists_get";
+  listAgentWorkItems: "list_agent_work_items_agent_work_items_get";
+  loadCopilotIntentContext: "load_copilot_intent_context_copilot_context_load_post";
+  markAgentSessionRead: "mark_agent_session_read_agent_sessions__session_id__read_put";
+  openAgentDiscovery: "open_agent_discovery_agent_onboarding_discovery_open_post";
+  pinAgentSession: "pin_agent_session_agent_sessions__session_id__pin_post";
+  postAgentChat: "post_agent_chat_agent_chat_post";
+  postAgentOnboardingCatchup: "post_agent_onboarding_catchup_agent_onboarding_catchup_post";
+  postAgentSessionMessage: "post_agent_session_message_agent_sessions__session_id__messages_post";
+  projectAgentDiscovery: "project_agent_discovery_agent_onboarding_discovery_project_post";
+  putAgentOperatingModel: "put_agent_operating_model_agent_operators_operating_model_put";
+  quoteAgentSessionVoice: "quote_agent_session_voice_agent_sessions__session_id__voice_quote_post";
+  ratifyAgentDiscovery: "ratify_agent_discovery_agent_onboarding_discovery_ratify_post";
+  renameAgentSession: "rename_agent_session_agent_sessions__session_id__rename_post";
+  requestAgentApprovalChanges: "request_agent_approval_changes_agent_approvals__approval_id__request_changes_post";
+  searchAgentMentions: "search_agent_mentions_agent_mention_search_post";
+  setAgentOperatorEnabled: "set_agent_operator_enabled_agent_operators__operator__enabled_put";
+  setAgentOperatorRecipient: "set_agent_operator_recipient_agent_operators__operator__recipient_put";
+  setAgentOperatorTrustDial: "set_agent_operator_trust_dial_agent_operators__operator__skills__skill_key__put";
+  setupAgentDiscoverySignals: "setup_agent_discovery_signals_agent_onboarding_discovery_signals_post";
+  startAgentSessionVoice: "start_agent_session_voice_agent_sessions__session_id__voice_post";
+  steerAgentWorkItem: "steer_agent_work_item_agent_work_items__work_item_id__steer_post";
+  submitAgentDomainResponse: "submit_agent_domain_response_agent_onboarding_domain_response_post";
+  takeAgentDiscoveryTurn: "take_agent_discovery_turn_agent_onboarding_discovery_turn_post";
+  updateAgentSession: "update_agent_session_agent_sessions__session_id__patch";
+}
+
+/** Input and output of every `g8.api.agents` operation, keyed by operationId. */
+export interface AgentsOperations {
+  /**
+   * POST /agent/onboarding/discovery/answer
+   * Answer Agent Discovery
+   * tier: write · scope: workflows:write
+   */
+  answer_agent_discovery_agent_onboarding_discovery_answer_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DiscoveryAnswerRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/work-items/{work_item_id}/cancel
+   * Cancel Agent Work Item
+   * tier: destructive · scope: workflows:delete
+   */
+  cancel_agent_work_item_agent_work_items__work_item_id__cancel_post: {
+    input: {
+    path: {
+      /** Work item id (UUID). */
+      work_item_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /agent/onboarding/entry-point
+   * Capture Agent Entry Point
+   * tier: write · scope: workflows:write
+   */
+  capture_agent_entry_point_agent_onboarding_entry_point_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EntryPointCaptureRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/onboarding/attribution
+   * Capture Agent Signup Attribution
+   * tier: write · scope: workflows:write
+   */
+  capture_agent_signup_attribution_agent_onboarding_attribution_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SignupAttributionRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/cards/{card_id}/confirm
+   * Confirm Agent Session Card
+   * tier: write · scope: workflows:write
+   */
+  confirm_agent_session_card_agent_sessions__session_id__cards__card_id__confirm_post: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+      /** The card's id in the session. */
+      card_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentCardConfirmationRequest;
+  };
+    output: ApiResponse_AgentConversationPayload_;
+  };
+  /**
+   * POST /agent/sessions
+   * Create Agent Session
+   * tier: write · scope: workflows:write
+   */
+  create_agent_session_agent_sessions_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentSessionCreateRequest;
+  };
+    output: ApiResponse_AgentSession_;
+  };
+  /**
+   * POST /agent/sessions/voice/draft
+   * Create Agent Voice Draft
+   * tier: write · scope: workflows:write
+   */
+  create_agent_voice_draft_agent_sessions_voice_draft_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceDraftRequest;
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * POST /agent/work-items
+   * Create Agent Work Item
+   * tier: billable · scope: workflows:run
+   */
+  create_agent_work_item_agent_work_items_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentWorkItemCreateRequest;
+  };
+    output: ApiResponse_AgentWorkItem_;
+  };
+  /**
+   * POST /agent/operators/{operator}/approvals/{task_id}/decide
+   * Decide Agent Operator Approval
+   * tier: billable · scope: workflows:run
+   */
+  decide_agent_operator_approval_agent_operators__operator__approvals__task_id__decide_post: {
+    input: {
+    path: {
+      operator: string;
+      /** The approval task id. */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OperatorApprovalDecisionRequest;
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * DELETE /agent/sessions/{session_id}
+   * Delete Agent Session
+   * tier: destructive · scope: workflows:delete
+   */
+  delete_agent_session_agent_sessions__session_id__delete: {
+    input: {
+    path: {
+      /** Session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * DELETE /agent/sessions/{session_id}/voice/{voice_id}
+   * End Agent Session Voice
+   * tier: destructive · scope: workflows:delete
+   */
+  end_agent_session_voice_agent_sessions__session_id__voice__voice_id__delete: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+      /** Voice session id (UUID) from the start call. */
+      voice_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * GET /agent/onboarding/discovery
+   * Get Agent Discovery
+   * tier: read · scope: workflows:read
+   */
+  get_agent_discovery_agent_onboarding_discovery_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * GET /agent/onboarding/discovery/campaign-brief
+   * Get Agent Discovery Campaign Brief
+   * tier: read · scope: workflows:read
+   */
+  get_agent_discovery_campaign_brief_agent_onboarding_discovery_campaign_brief_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * GET /agent/onboarding/discovery/report
+   * Get Agent Discovery Report
+   * tier: read · scope: workflows:read
+   */
+  get_agent_discovery_report_agent_onboarding_discovery_report_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * GET /agent/memory
+   * Get Agent Memory
+   * tier: read · scope: workflows:read
+   */
+  get_agent_memory_agent_memory_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentPayload_;
+  };
+  /**
+   * GET /agent/operators/operating-model
+   * Get Agent Operating Model
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operating_model_agent_operators_operating_model_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/catalog
+   * Get Agent Operator Catalog
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_catalog_agent_operators__operator__catalog_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/feedback/summary
+   * Get Agent Operator Feedback Summary
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_feedback_summary_agent_operators__operator__feedback_summary_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/approvals/{task_id}/operator
+   * Get Agent Operator For Approval Task
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_for_approval_task_agent_operators_approvals__task_id__operator_get: {
+    input: {
+    path: {
+      /** Operator approval task id. */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/health
+   * Get Agent Operator Health
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_health_agent_operators__operator__health_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/recipient
+   * Get Agent Operator Recipient
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_recipient_agent_operators__operator__recipient_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/scorecard
+   * Get Agent Operator Scorecard
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_scorecard_agent_operators__operator__scorecard_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/status
+   * Get Agent Operator Status
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operator_status_agent_operators__operator__status_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/operators/summary
+   * Get Agent Operators Summary
+   * tier: read · scope: workflows:read
+   */
+  get_agent_operators_summary_agent_operators_summary_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * GET /agent/oversight
+   * Get Agent Oversight
+   * tier: read · scope: workflows:read
+   */
+  get_agent_oversight_agent_oversight_get: {
+    input: {
+    query?: {
+      /** Max rows PER GROUP. */
+      limit?: number;
+      /** How far back autonomous fixes are read. */
+      fix_window_hours?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentConversationPayload_;
+  };
+  /**
+   * GET /agent/proactive-opener
+   * Get Agent Proactive Opener
+   * tier: read · scope: workflows:read
+   */
+  get_agent_proactive_opener_agent_proactive_opener_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentPayload_;
+  };
+  /**
+   * GET /agent/evidence/pushback
+   * Get Agent Pushback Evidence
+   * tier: read · scope: workflows:read
+   */
+  get_agent_pushback_evidence_agent_evidence_pushback_get: {
+    input: {
+    query?: {
+      /** Lookback window in days. */
+      window_days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentPayload_;
+  };
+  /**
+   * GET /agent/sessions/{session_id}
+   * Get Agent Session
+   * tier: read · scope: workflows:read
+   */
+  get_agent_session_agent_sessions__session_id__get: {
+    input: {
+    path: {
+      /** Session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSession_;
+  };
+  /**
+   * GET /agent/sessions/{session_id}/state
+   * Get Agent Session State
+   * tier: read · scope: workflows:read
+   */
+  get_agent_session_state_agent_sessions__session_id__state_get: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * GET /agent/sessions/{session_id}/voice
+   * Get Agent Session Voice Capability
+   * tier: read · scope: workflows:read
+   */
+  get_agent_session_voice_capability_agent_sessions__session_id__voice_get: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * GET /agent/sessions/voice/capability
+   * Get Agent Voice Capability
+   * tier: read · scope: workflows:read
+   */
+  get_agent_voice_capability_agent_sessions_voice_capability_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/actions
+   * List Agent Operator Actions
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_actions_agent_operators__operator__actions_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/activity
+   * List Agent Operator Activity
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_activity_agent_operators__operator__activity_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    query?: {
+      /** How many history rows to return. The app's own default is 50 and it declares no ceiling; a bound is added here because an unbounded limit on a public contract is a denial-of-service parameter. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/activity/{task_id}/records
+   * List Agent Operator Activity Records
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_activity_records_agent_operators__operator__activity__task_id__records_get: {
+    input: {
+    path: {
+      operator: string;
+      /** Task id from the activity list. */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/approvals/sources
+   * List Agent Operator Approval Sources
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_approval_sources_agent_operators_approvals_sources_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/collections
+   * List Agent Operator Collections
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_collections_agent_operators__operator__collections_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/findings
+   * List Agent Operator Findings
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_findings_agent_operators__operator__findings_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators/{operator}/skills
+   * List Agent Operator Skills
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operator_skills_agent_operators__operator__skills_get: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/operators
+   * List Agent Operators
+   * tier: read · scope: workflows:read
+   */
+  list_agent_operators_agent_operators_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OperatorListPayload_;
+  };
+  /**
+   * GET /agent/sessions
+   * List Agent Sessions
+   * tier: read · scope: workflows:read
+   */
+  list_agent_sessions_agent_sessions_get: {
+    input: {
+    query?: {
+      /** Filter to one session mode. */
+      mode?: string | null;
+      /** Page size (max 200). */
+      limit?: number;
+      /** Rows to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentSessionListResponse_;
+  };
+  /**
+   * GET /agent/specialists
+   * List Agent Specialists
+   * tier: read · scope: workflows:read
+   */
+  list_agent_specialists_agent_specialists_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentBenchListPayload_;
+  };
+  /**
+   * GET /agent/work-items
+   * List Agent Work Items
+   * tier: read · scope: workflows:read
+   */
+  list_agent_work_items_agent_work_items_get: {
+    input: {
+    query?: {
+      /** Status filter, REPEATABLE: `?statuses=running&statuses=queued`. Repeated rather than comma-joined, matching the app - a comma in a status would otherwise split it. */
+      statuses?: Array<string> | null;
+      /** Filter to one agent. */
+      agent_id?: string | null;
+      /** Include org-wide shared items as well as the caller's own. True by default, matching the app - set false to see only your own. */
+      include_shared?: boolean;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AgentWorkItemList_;
+  };
+  /**
+   * POST /copilot/context/load
+   * Load Copilot Intent Context
+   * tier: write · scope: workflows:write
+   */
+  load_copilot_intent_context_copilot_context_load_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CopilotContextLoadRequest;
+  };
+    output: ApiResponse_AgentConversationPayload_;
+  };
+  /**
+   * PUT /agent/sessions/{session_id}/read
+   * Mark Agent Session Read
+   * tier: write · scope: workflows:write
+   */
+  mark_agent_session_read_agent_sessions__session_id__read_put: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SessionReadRequest;
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * POST /agent/onboarding/discovery/open
+   * Open Agent Discovery
+   * tier: write · scope: workflows:write
+   */
+  open_agent_discovery_agent_onboarding_discovery_open_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/pin
+   * Pin Agent Session
+   * tier: write · scope: workflows:write
+   */
+  pin_agent_session_agent_sessions__session_id__pin_post: {
+    input: {
+    path: {
+      /** Session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentSessionPinRequest;
+  };
+    output: ApiResponse_AgentSession_;
+  };
+  /**
+   * POST /agent/chat
+   * Post Agent Chat
+   * tier: billable · scope: workflows:run
+   */
+  post_agent_chat_agent_chat_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentChatRequest;
+  };
+    output: ApiResponse_AgentConversationPayload_;
+  };
+  /**
+   * POST /agent/onboarding/catchup
+   * Post Agent Onboarding Catchup
+   * tier: write · scope: workflows:write
+   */
+  post_agent_onboarding_catchup_agent_onboarding_catchup_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OnboardingCatchupRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/messages
+   * Post Agent Session Message
+   * tier: write · scope: workflows:write
+   */
+  post_agent_session_message_agent_sessions__session_id__messages_post: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentSessionMessageRequest;
+  };
+    output: ApiResponse_AgentConversationPayload_;
+  };
+  /**
+   * POST /agent/onboarding/discovery/project
+   * Project Agent Discovery
+   * tier: write · scope: workflows:write
+   */
+  project_agent_discovery_agent_onboarding_discovery_project_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * PUT /agent/operators/operating-model
+   * Put Agent Operating Model
+   * tier: write · scope: workflows:write
+   */
+  put_agent_operating_model_agent_operators_operating_model_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OperatingModelRequest;
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/voice/quote
+   * Quote Agent Session Voice
+   * tier: read · scope: workflows:read
+   */
+  quote_agent_session_voice_agent_sessions__session_id__voice_quote_post: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceQuoteRequest;
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * POST /agent/onboarding/discovery/ratify
+   * Ratify Agent Discovery
+   * tier: write · scope: workflows:write
+   */
+  ratify_agent_discovery_agent_onboarding_discovery_ratify_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DiscoveryRatifyRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/rename
+   * Rename Agent Session
+   * tier: write · scope: workflows:write
+   */
+  rename_agent_session_agent_sessions__session_id__rename_post: {
+    input: {
+    path: {
+      /** Session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentSessionRenameRequest;
+  };
+    output: ApiResponse_AgentSession_;
+  };
+  /**
+   * POST /agent/approvals/{approval_id}/request-changes
+   * Request Agent Approval Changes
+   * tier: write · scope: workflows:write
+   */
+  request_agent_approval_changes_agent_approvals__approval_id__request_changes_post: {
+    input: {
+    path: {
+      /** Approval id (UUID). */
+      approval_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ApprovalChangeRequest;
+  };
+    output: ApiResponse_AgentBenchPayload_;
+  };
+  /**
+   * POST /agent/mention-search
+   * Search Agent Mentions
+   * tier: read · scope: workflows:read
+   */
+  search_agent_mentions_agent_mention_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MentionSearchRequest;
+  };
+    output: ApiResponse_AgentBenchListPayload_;
+  };
+  /**
+   * PUT /agent/operators/{operator}/enabled
+   * Set Agent Operator Enabled
+   * tier: billable · scope: workflows:run
+   */
+  set_agent_operator_enabled_agent_operators__operator__enabled_put: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OperatorEnabledRequest;
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * PUT /agent/operators/{operator}/recipient
+   * Set Agent Operator Recipient
+   * tier: write · scope: workflows:write
+   */
+  set_agent_operator_recipient_agent_operators__operator__recipient_put: {
+    input: {
+    path: {
+      operator: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OperatorRecipientRequest;
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * PUT /agent/operators/{operator}/skills/{skill_key}
+   * Set Agent Operator Trust Dial
+   * tier: billable · scope: workflows:run
+   */
+  set_agent_operator_trust_dial_agent_operators__operator__skills__skill_key__put: {
+    input: {
+    path: {
+      operator: string;
+      /** Skill key from `GET /agent/operators/{operator}/skills`. */
+      skill_key: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: OperatorTrustDialRequest;
+  };
+    output: ApiResponse_OperatorPayload_;
+  };
+  /**
+   * POST /agent/onboarding/discovery/signals
+   * Setup Agent Discovery Signals
+   * tier: write · scope: workflows:write
+   */
+  setup_agent_discovery_signals_agent_onboarding_discovery_signals_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/sessions/{session_id}/voice
+   * Start Agent Session Voice
+   * tier: billable · scope: workflows:run
+   */
+  start_agent_session_voice_agent_sessions__session_id__voice_post: {
+    input: {
+    path: {
+      /** Session id (UUID). */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceSessionRequest;
+  };
+    output: ApiResponse_AgentSessionStatePayload_;
+  };
+  /**
+   * POST /agent/work-items/{work_item_id}/steer
+   * Steer Agent Work Item
+   * tier: write · scope: workflows:write
+   */
+  steer_agent_work_item_agent_work_items__work_item_id__steer_post: {
+    input: {
+    path: {
+      /** Work item id (UUID). */
+      work_item_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentWorkItemSteerRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /agent/onboarding/domain-response
+   * Submit Agent Domain Response
+   * tier: write · scope: workflows:write
+   */
+  submit_agent_domain_response_agent_onboarding_domain_response_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DomainConfirmationRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * POST /agent/onboarding/discovery/turn
+   * Take Agent Discovery Turn
+   * tier: billable · scope: workflows:run
+   */
+  take_agent_discovery_turn_agent_onboarding_discovery_turn_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DiscoveryTurnRequest;
+  };
+    output: ApiResponse_OnboardingPayload_;
+  };
+  /**
+   * PATCH /agent/sessions/{session_id}
+   * Update Agent Session
+   * tier: write · scope: workflows:write
+   */
+  update_agent_session_agent_sessions__session_id__patch: {
+    input: {
+    path: {
+      /** Session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentSessionUpdateRequest;
+  };
+    output: ApiResponse_AgentSession_;
+  };
+}
+
+// 54 schemas referenced above (the same as G8Contract.<Name>).
+
+/** An open envelope for a LIST answer, so a bare list keeps its shape. */
+export interface AgentBenchListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for one approval answer.
+ *
+ * Open because an approval carries the plan digest it is bound to, its expiry
+ * and its provenance receipts, and that set has grown twice already. On a
+ * human-in-the-loop surface a dropped field is a guarantee the caller does not
+ * know they lost.
+ */
+export type AgentBenchPayload = Record<string, unknown>;
+
+/** Mirror of `wow_confirm_router.WowConfirmRequest`. */
+export interface AgentCardConfirmationRequest {
+  /** Per-field overrides for an `edited` card. The shape is the card's own and varies by card kind. */
+  edits?: Record<string, unknown> | null;
+  /** Why, in your words. */
+  note?: string | null;
+  /** `approved` accepts the card as proposed, `edited` accepts it with your `edits`, `rejected` sends it back. Re-sending the same state is a no-op; a different state overwrites. */
+  state: "approved" | "edited" | "rejected";
+}
+
+/** Mirror of `agent_runtime.interfaces.routers.chat_router.ChatRequest`. */
+export interface AgentChatRequest {
+  /** Uploaded file ids to attach, each at most once. */
+  attachment_ids?: Array<string>;
+  /** Your own id for this turn, so a retry is recognised as the same turn rather than said twice. Needs an existing `session_id`. */
+  client_turn_id?: string | null;
+  /** @-mentions from `POST /agent/mention-search`, passed through as returned (`id`, `category`, `display_name`, ...). */
+  mentions?: Array<Record<string, unknown>> | null;
+  /** What you say to the agent. Required unless you attach a file. */
+  message?: string;
+  /** Bias the agent: `web_search`, `deep_thinking` or `research`. Left open, as the app leaves it: an unknown mode is ignored rather than refused. */
+  mode?: string | null;
+  /** Where the user is in your product, so 'this' and 'here' resolve. */
+  page?: string | null;
+  /** Continue this session. Omit to start a new one; the answer carries its `session_id`. */
+  session_id?: string | null;
+  /** Bind a NEW session to this account. Ignored for an existing one. */
+  subject_account_id?: string | null;
+  /** Bind a NEW session to this campaign. Ignored for an existing one. */
+  subject_campaign_id?: string | null;
+}
+
+/**
+ * An open envelope for the app's answer.
+ *
+ * Open because the chat answer (`kind`, `message`, `chips`, `sources`,
+ * `work_item_id`, ...) and the oversight feed (`approvals`, `blockers`,
+ * `autonomous_fixes`, `states`, `bounds`) are both still growing, and a
+ * dropped field on an agent surface is one the caller does not know they
+ * lost.
+ */
+export type AgentConversationPayload = Record<string, unknown>;
+
+/**
+ * An open envelope for memory, evidence and the proactive opener.
+ *
+ * Each carries planner or analysis state that changes as the agent platform
+ * does. On an oversight surface a dropped field reads as an agent doing less
+ * than it did, so nothing here is pinned.
+ */
+export type AgentPayload = Record<string, unknown>;
+
+/** One agent chat session. */
+export interface AgentSession {
+  created_at?: string | null;
+  id?: string | null;
+  is_pinned?: boolean | null;
+  /** Session mode, e.g. `general`. */
+  mode?: string | null;
+  title?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+}
+
+export interface AgentSessionCreateRequest {
+  /** Optional seed messages to open the session with. */
+  messages?: Array<Record<string, unknown>> | null;
+  /** Session mode. */
+  mode?: string;
+  /** Optional title; the app derives one when omitted. */
+  title?: string | null;
+}
+
+/** Sessions owned by, or shared with, the principal behind the key. */
+export interface AgentSessionListResponse {
+  sessions?: Array<AgentSession>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+/** Mirror of `messages_router.PostMessageRequest`. */
+export interface AgentSessionMessageRequest {
+  /** The message text. */
+  content: string;
+}
+
+export interface AgentSessionPinRequest {
+  /** True to pin, false to unpin. */
+  is_pinned: boolean;
+}
+
+export interface AgentSessionRenameRequest {
+  /** New title. */
+  title: string;
+}
+
+/**
+ * An open envelope for a hydration or voice answer.
+ *
+ * Open because session hydration returns the agent's STEPS as well as its
+ * messages, and a step's `detail` is whatever the tool that produced it
+ * reported. That set grows with every tool the platform gains, and a pinned
+ * mirror would drop the detail of exactly the newest ones - which on a
+ * transcript surface reads as the agent having done less than it did.
+ */
+export type AgentSessionStatePayload = Record<string, unknown>;
+
+/** Both fields are optional; omit one to leave it untouched. */
+export interface AgentSessionUpdateRequest {
+  messages?: Array<Record<string, unknown>> | null;
+  title?: string | null;
+}
+
+/** One unit of autonomous work. */
+export interface AgentWorkItem {
+  agent_id?: string | null;
+  created_at?: string | null;
+  goal?: string | null;
+  id?: string | null;
+  session_id?: string | null;
+  status?: string | null;
+  title?: string | null;
+  updated_at?: string | null;
+  visibility?: string | null;
+  work_item_id?: string | null;
+  [key: string]: unknown;
+}
+
+/** Start a unit of autonomous work. */
+export interface AgentWorkItemCreateRequest {
+  /** Which agent owns it. A known id the planner has a template for - `onboarding`, `dialer_setup`, `sequencer_setup`, `campaign_run`, `voice_setup`, `marketplace`, `dev_setup` - or a free-form value, for which the planner falls back to its `full` template. Left as an open string for that reason: an enum here would reject the ad-hoc case the planner explicitly supports. */
+  agent_id: string;
+  /** Per-session override. Unset, the planner reads the org's own signup entry point as the long-term truth - so omitting this is usually right. */
+  entry_point?: string | null;
+  /** What the agent should achieve. */
+  goal: string;
+  page?: string | null;
+  platform?: ("whatsapp" | "slack" | "roam" | "imessage") | null;
+  /** First user message, so the session opens on the real request. */
+  seed_message?: string | null;
+  /** Sidebar title. Defaults to `title`. */
+  session_title?: string | null;
+  /** `web_search`, `deep_thinking` or `research`. Biases the planner prompt and model tier. Unknown values are IGNORED by the planner rather than rejected, which is why this is not an enum. */
+  skill_mode?: string | null;
+  source?: ("canvas" | "bridge") | null;
+  /** Bind the session to a company. */
+  subject_account_id?: string | null;
+  /** Bind the session to a campaign. */
+  subject_campaign_id?: string | null;
+  title: string;
+  /** Whose work item this is. Defaults to the identity the key was minted under. */
+  user_email?: string | null;
+  /** `private` (default) or `shared` org-wide. The default is the safe one: work started through an API key is not visible to the whole org unless asked for. */
+  visibility?: "shared" | "private";
+}
+
+export interface AgentWorkItemList {
+  total?: number;
+  work_items?: Array<AgentWorkItem>;
+  [key: string]: unknown;
+}
+
+/**
+ * Redirect a RUNNING work item at its next safe step boundary.
+ *
+ * `extra="forbid"` mirrors the app: an unknown key here is a typo in an
+ * instruction payload, and dropping it silently would let a caller believe
+ * they had steered when they had not.
+ */
+export interface AgentWorkItemSteerRequest {
+  /** Caller-generated idempotency key. REQUIRED, and the reason steering is safe to retry: the same id twice comes back `duplicate` rather than queueing a second instruction into a running agent. */
+  client_turn_id: string;
+  /** What to do differently. Applied at the next safe step boundary, not mid-step. */
+  instruction: string;
+}
+
+export interface ApiResponse_AgentBenchListPayload_ {
+  data: AgentBenchListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentBenchPayload_ {
+  data: AgentBenchPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentConversationPayload_ {
+  data: AgentConversationPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentPayload_ {
+  data: AgentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentSessionListResponse_ {
+  data: AgentSessionListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentSessionStatePayload_ {
+  data: AgentSessionStatePayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentSession_ {
+  data: AgentSession;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentWorkItemList_ {
+  data: AgentWorkItemList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AgentWorkItem_ {
+  data: AgentWorkItem;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_OnboardingPayload_ {
+  data: OnboardingPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_OperatorListPayload_ {
+  data: OperatorListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_OperatorPayload_ {
+  data: OperatorPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+/** Mirror of `RequestChangesBody`. */
+export interface ApprovalChangeRequest {
+  /** Why the proposal is wrong, and what to do instead. REQUIRED and not decoration: it is stored on the rejection and is what the next plan is built from, so an empty-handed rejection produces the same plan again. */
+  feedback: string;
+}
+
+/** Mirror of `load_intent_context.router.LoadIntentContextRequest`. */
+export interface CopilotContextLoadRequest {
+  /** Narrow the context to one company. */
+  company_id?: number | null;
+  /** Narrow the context to one contact. */
+  contact_id?: number | null;
+  /** The buyer-intent keyword to open a conversation about. */
+  keyword_id: string;
+}
+
+/**
+ * Mirror of `DiscoveryAnswerRequest`.
+ *
+ * `grade` is the customer's own confidence in the answer and it is REQUIRED
+ * on the app model - it has no default there, so omitting it would raise
+ * inside the proxy rather than 422 here.
+ */
+export interface DiscoveryAnswerRequest {
+  /** Which discovery field this answers. */
+  field_key: string;
+  /** Confidence in the answer: `green` (certain), `amber` (a working assumption) or `red` (a guess). Amber and red answers come back in `coverage.amber_fields` so they can be revisited. */
+  grade: string;
+  /** Interview move this answers. */
+  move_number?: number | null;
+  /** Canvas session to report into. */
+  session_id?: string | null;
+  /** Who supplied it. Defaults to `user`. */
+  source?: string;
+  /** The answer. Shape depends on the field. */
+  value?: unknown;
+}
+
+/**
+ * Mirror of `DiscoveryRatifyRequest`.
+ *
+ * Both collections default to empty, matching the app: ratifying nothing is a
+ * legal no-op rather than a 422, which is what makes the call safe to retry.
+ */
+export interface DiscoveryRatifyRequest {
+  /** Field keys the customer accepts as the agent inferred them. */
+  confirmed?: Array<string>;
+  /** Field key -> corrected value, for answers the agent got wrong. */
+  edits?: Record<string, unknown>;
+  /** Canvas session to report the ratification into. */
+  session_id?: string | null;
+}
+
+/**
+ * Mirror of `DiscoveryTurnRequest`.
+ *
+ * There is deliberately NO `history` field, and that is load-bearing rather
+ * than an omission. The app removed one: the panel used to keep the
+ * transcript in browser state and ship it back on every turn, so a reload
+ * destroyed the customer's whole kickoff. The server re-grounds from the
+ * durable record instead. A caller-supplied transcript is not something the
+ * server can verify, and accepting one here would re-open exactly that hole.
+ */
+export interface DiscoveryTurnRequest {
+  message: string;
+  /** Canvas session to report into. */
+  session_id?: string | null;
+}
+
+/** Mirror of `DomainResponseRequest`. */
+export interface DomainConfirmationRequest {
+  /** The `domain_confirmation` card id. */
+  card_id: string;
+  /** True = the pre-filled domain is correct as it stands. */
+  confirmed: boolean;
+  /** The corrected company domain. REQUIRED when `confirmed` is false; ignored when it is true. */
+  domain?: string | null;
+  /** The proactive-setup canvas session id. */
+  session_id: string;
+}
+
+/** Mirror of `CaptureEntryPointRequest`. */
+export interface EntryPointCaptureRequest {
+  /** The signup entry point. Maps 1:1 to a plan template, so this chooses what the agent will propose doing first. FIRST WRITER WINS: if the org already has one captured, this call reports the existing value and changes nothing. */
+  entry_point: "dialer" | "sequencer" | "marketplace" | "dev" | "calendar" | "email_inbox" | "full";
+}
+
+/** Mirror of `MentionSearchRequest`. */
+export interface MentionSearchRequest {
+  /** Bias results toward one campaign's people and documents. */
+  campaign_id?: string | null;
+  /** Which mention vocabulary to search. Left open rather than closed to a Literal: the app treats an unrecognised mode as 'no filter' instead of an error, so closing it here would turn a working call into a 422. */
+  mode?: string | null;
+  /** Substring to match. Empty - the default - returns the default suggestions rather than nothing, matching the app's own composer. */
+  query?: string;
+}
+
+/** Mirror of `OnboardingCatchupRequest`. */
+export interface OnboardingCatchupRequest {
+  /** The proactive-setup canvas session id. */
+  session_id: string;
+}
+
+/**
+ * An open envelope for an onboarding or discovery result.
+ *
+ * Open on purpose. Discovery state carries a per-field coverage matrix whose
+ * field set is the product's own onboarding questionnaire - it changes as the
+ * questionnaire does, and a pinned mirror would silently DROP a field the
+ * customer had answered. On a surface whose whole job is "what do we still
+ * not know about you", a dropped field reads as an answered question.
+ */
+export type OnboardingPayload = Record<string, unknown>;
+
+/**
+ * Mirror of `OperatingModelUpdate`.
+ *
+ * `override` is an open object and stays that way. It is the organisation's
+ * operating-model document - which motions it runs, what it calls them - and
+ * it is validated by the service against the live model definition rather
+ * than by a shape frozen into this contract. Pinning it would refuse a key a
+ * newer platform version understands.
+ */
+export interface OperatingModelRequest {
+  /** The organisation's operating-model override, REPLACED WHOLE. This is a PUT: keys absent from the body are removed, not left alone. Read `GET /agent/operators/operating-model` first and send it back modified. */
+  override: Record<string, unknown>;
+}
+
+/**
+ * Mirror of `ApprovalDecision`.
+ *
+ * `resolution` is closed to the two values the app accepts. The app answers
+ * anything else with a 400 after lower-casing it; closing it here makes a bad
+ * value a 422 that names the valid ones.
+ */
+export interface OperatorApprovalDecisionRequest {
+  /** Values a fix needs that the operator could not decide for you, e.g. `{"target_user": "<user id>"}`. Omit for a fully-specified fix. A value the fix refuses is a 400 naming the field, and the task stays open. */
+  params?: Record<string, string> | null;
+  /** `approved` EXECUTES the finding's proposed fix against your data; `rejected` records the decision and executes nothing. */
+  resolution: "approved" | "rejected";
+}
+
+/** Mirror of `EnabledUpdate`. */
+export interface OperatorEnabledRequest {
+  /** Whether this operator runs for the organisation. TURNING IT ON STARTS UNATTENDED WORK: the operator's monitors run on their own schedule from then on, without a person asking. Explicit rather than a toggle, so a retried request is idempotent instead of flipping the state back. */
+  enabled: boolean;
+}
+
+/** An open envelope for a LIST answer, so a bare list keeps its shape. */
+export interface OperatorListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for one operator answer.
+ *
+ * Open because an operator's health snapshot, scorecard and catalog are
+ * per-operator documents whose shape follows what that operator monitors -
+ * the revenue operator reports different checks from the deliverability one,
+ * and both grow. On an OVERSIGHT surface a dropped field reads as "nothing to
+ * worry about" rather than "we did not tell you", which is the failure mode
+ * worth designing against.
+ */
+export type OperatorPayload = Record<string, unknown>;
+
+/** Mirror of `RecipientUpdate`. */
+export interface OperatorRecipientRequest {
+  /** The person who receives this operator's alerts and owns its approval tasks. One recipient per operator: setting it REPLACES whoever was there. */
+  user_id: string;
+}
+
+/** Mirror of `TrustDialUpdate`, with `autonomy` closed to the shipped set. */
+export interface OperatorTrustDialRequest {
+  /** How far this skill may go on its own. `OFF` - do not run it. `DETECT` - look, and record what it finds. `PROPOSE` - look, and raise an approval task a person decides. `AUTO` - act and log, with no human in the loop. THIS IS A REQUEST, NOT A GUARANTEE: the effective level is the MINIMUM of this dial, the skill's own graph8-managed risk cap and the platform ceiling, so a skill capped at `PROPOSE` stays at `PROPOSE` however this is set. Read the response, and `GET /agent/operators/{operator}/skills`, for what the dial actually resolved to. */
+  autonomy: "OFF" | "DETECT" | "PROPOSE" | "AUTO";
+}
+
+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;
+}
+
+/** Mirror of `SessionReadRequest`. */
+export interface SessionReadRequest {
+  /** How many messages the caller has actually seen. NOT a flag: the server refuses a count higher than the session holds with a 409, because a client claiming to have read messages that do not exist yet is a stale client, and silently accepting it would mark a later real message read before anyone saw it. */
+  message_count: number;
+}
+
+/**
+ * Mirror of `CaptureAttributionRequest`.
+ *
+ * Every field is optional and every length cap is the app's, so a value this
+ * contract accepts is one the handler accepts too.
+ */
+export interface SignupAttributionRequest {
+  /** Signup entry-point slug. */
+  entry_point?: string | null;
+  fbclid?: string | null;
+  gbraid?: string | null;
+  gclid?: string | null;
+  landing_at?: string | null;
+  landing_page_url?: string | null;
+  signup_referrer?: string | null;
+  utm_campaign?: string | null;
+  utm_content?: string | null;
+  utm_id?: string | null;
+  utm_medium?: string | null;
+  utm_source?: string | null;
+  utm_term?: string | null;
+  wbraid?: string | null;
+}
+
+/** Mirror of `VoiceDraftRequest`. */
+export interface VoiceDraftRequest {
+  /** The id the new session will have - CALLER-GENERATED, not server-assigned. That is what lets a client open the socket and create the row without a round trip between them. Reusing an id does not create a second session. */
+  session_id: string;
+}
+
+/** Mirror of `VoiceQuoteRequest`, including its `extra="forbid"`. */
+export interface VoiceQuoteRequest {
+  /** Ceiling on spoken input to price for. */
+  max_input_seconds?: number;
+  /** Ceiling on synthesised output to price for. */
+  max_output_characters?: number;
+  /** Which voice to price. */
+  voice_id: string;
+}
+
+/** Mirror of `VoiceSessionRequest`, including its `extra="forbid"`. */
+export interface VoiceSessionRequest {
+  /** HARD CEILING on what this session may spend. Required, with no default: an uncapped voice session is an open-ended charge, and a contract that defaults it would be choosing a spending limit on the customer's behalf. */
+  max_credits: number;
+  /** The rate version the quote was issued against, from `POST /agent/sessions/{session_id}/voice/quote`. The server refuses a stale one rather than charging today's price for yesterday's quote. */
+  rate_version: string;
+  /** Which voice to speak with. */
+  voice_id: string;
+}