@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/copilot.d.ts

@@ -0,0 +1,1017 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.copilot` (Copilot): 39 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"append_copilot_memory_document_copilot_memory_documents_append_post">;
+ *
+ * Reference with examples: copilot.md
+ */
+/* eslint-disable */
+
+/** `g8.api.copilot.<member>` -> the operationId it calls. */
+export interface CopilotMembers {
+  appendCopilotMemoryDocument: "append_copilot_memory_document_copilot_memory_documents_append_post";
+  browseCopilotPersonalWikiDrive: "browse_copilot_personal_wiki_drive_copilot_personal_wiki_drive_get";
+  captureCopilotSoul: "capture_copilot_soul_copilot_memory_soul_capture_post";
+  chatWithCopilot: "chat_with_copilot_copilot_chat_post";
+  chooseCopilotContactMatch: "choose_copilot_contact_match_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_post";
+  confirmCopilotPersonalWikiFact: "confirm_copilot_personal_wiki_fact_copilot_personal_wiki_confirm_post";
+  correctCopilotContactIdentity: "correct_copilot_contact_identity_copilot_personal_wiki_relationships_identity_post";
+  correctCopilotPersonalWikiFact: "correct_copilot_personal_wiki_fact_copilot_personal_wiki_correct_post";
+  createCopilotMemory: "create_copilot_memory_copilot_memory_post";
+  deleteCopilotMemory: "delete_copilot_memory_copilot_memory__memory_id__delete";
+  editCopilotPersonalWikiItem: "edit_copilot_personal_wiki_item_copilot_personal_wiki_items__item_id__put";
+  forgetCopilotPersonalWikiFact: "forget_copilot_personal_wiki_fact_copilot_personal_wiki_forget_post";
+  getCopilotContactSharing: "get_copilot_contact_sharing_copilot_personal_wiki_contact_sharing_get";
+  getCopilotLinkedinConnections: "get_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_get";
+  getCopilotMemoryContext: "get_copilot_memory_context_copilot_memory_context_get";
+  getCopilotMemoryDocuments: "get_copilot_memory_documents_copilot_memory_documents_get";
+  getCopilotPersonalWiki: "get_copilot_personal_wiki_copilot_personal_wiki_get";
+  getCopilotPersonalWikiDocument: "get_copilot_personal_wiki_document_copilot_personal_wiki_documents__section__get";
+  getCopilotPersonalWikiRelationship: "get_copilot_personal_wiki_relationship_copilot_personal_wiki_relationships__contact_id__get";
+  getCopilotPersonalWikiSources: "get_copilot_personal_wiki_sources_copilot_personal_wiki_sources_get";
+  listCopilotContactContributions: "list_copilot_contact_contributions_copilot_personal_wiki_contact_sharing_contributions_get";
+  listCopilotContactMatches: "list_copilot_contact_matches_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_get";
+  listCopilotMemories: "list_copilot_memories_copilot_memory_get";
+  listCopilotPersonalWikiRelationships: "list_copilot_personal_wiki_relationships_copilot_personal_wiki_relationships_get";
+  listCopilotTools: "list_copilot_tools_copilot_tools_get";
+  previewCopilotPersonalWikiDriveSelection: "preview_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_preview_post";
+  promoteCopilotMemory: "promote_copilot_memory_copilot_memory_promote_post";
+  resolveCopilotContactContribution: "resolve_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__resolve_post";
+  runCopilotLandingPageAction: "run_copilot_landing_page_action_copilot_landing_page_action_post";
+  saveCopilotPersonalWikiDriveSelection: "save_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_put";
+  searchCopilotContactIdentities: "search_copilot_contact_identities_copilot_personal_wiki_contact_identities_get";
+  searchCopilotMentions: "search_copilot_mentions_copilot_mention_search_post";
+  updateCopilotContactContribution: "update_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__put";
+  updateCopilotContactPeopleChoice: "update_copilot_contact_people_choice_copilot_personal_wiki_contact_sharing_people_choice_put";
+  updateCopilotContactSharing: "update_copilot_contact_sharing_copilot_personal_wiki_contact_sharing__mailbox_id__put";
+  updateCopilotLinkedinConnections: "update_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_put";
+  updateCopilotPersonalWiki: "update_copilot_personal_wiki_copilot_personal_wiki_put";
+  updateCopilotPersonalWikiSources: "update_copilot_personal_wiki_sources_copilot_personal_wiki_sources_put";
+  upsertCopilotMemoryDocument: "upsert_copilot_memory_document_copilot_memory_documents_put";
+}
+
+/** Input and output of every `g8.api.copilot` operation, keyed by operationId. */
+export interface CopilotOperations {
+  /**
+   * POST /copilot/memory/documents/append
+   * Append Copilot Memory Document
+   * tier: write · scope: knowledge:write
+   */
+  append_copilot_memory_document_copilot_memory_documents_append_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MemoryDocumentAppendRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/drive
+   * Browse Copilot Personal Wiki Drive
+   * tier: read · scope: knowledge:read
+   */
+  browse_copilot_personal_wiki_drive_copilot_personal_wiki_drive_get: {
+    input: {
+    query: {
+      /** Integer `mailboxes.id` of the connected Google account. */
+      mailbox_id: number;
+      /** Folder to list. `root` is the top of My Drive. */
+      parent_id?: string;
+      /** From the previous page. */
+      page_token?: string | null;
+      /** Search by name instead of listing a folder. */
+      search?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/memory/soul-capture
+   * Capture Copilot Soul
+   * tier: write · scope: knowledge:write
+   */
+  capture_copilot_soul_copilot_memory_soul_capture_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SoulCaptureRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/chat
+   * Chat With Copilot
+   * tier: billable · scope: knowledge:run
+   */
+  chat_with_copilot_copilot_chat_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CopilotChatRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches
+   * Choose Copilot Contact Match
+   * tier: write · scope: knowledge:write
+   */
+  choose_copilot_contact_match_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_post: {
+    input: {
+    path: {
+      /** Contribution id (UUID). */
+      contribution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactMatchRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/confirm
+   * Confirm Copilot Personal Wiki Fact
+   * tier: write · scope: knowledge:write
+   */
+  confirm_copilot_personal_wiki_fact_copilot_personal_wiki_confirm_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiFactActionRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/relationships/identity
+   * Correct Copilot Contact Identity
+   * tier: write · scope: knowledge:write
+   */
+  correct_copilot_contact_identity_copilot_personal_wiki_relationships_identity_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactIdentityRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/correct
+   * Correct Copilot Personal Wiki Fact
+   * tier: write · scope: knowledge:write
+   */
+  correct_copilot_personal_wiki_fact_copilot_personal_wiki_correct_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiFactCorrectionRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/memory
+   * Create Copilot Memory
+   * tier: write · scope: knowledge:write
+   */
+  create_copilot_memory_copilot_memory_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MemoryCreateRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * DELETE /copilot/memory/{memory_id}
+   * Delete Copilot Memory
+   * tier: destructive · scope: knowledge:delete
+   */
+  delete_copilot_memory_copilot_memory__memory_id__delete: {
+    input: {
+    path: {
+      /** Memory id. */
+      memory_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/items/{item_id}
+   * Edit Copilot Personal Wiki Item
+   * tier: write · scope: knowledge:write
+   */
+  edit_copilot_personal_wiki_item_copilot_personal_wiki_items__item_id__put: {
+    input: {
+    path: {
+      /** Wiki item id. */
+      item_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiItemEditRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/forget
+   * Forget Copilot Personal Wiki Fact
+   * tier: write · scope: knowledge:write
+   */
+  forget_copilot_personal_wiki_fact_copilot_personal_wiki_forget_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiFactActionRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/contact-sharing
+   * Get Copilot Contact Sharing
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_contact_sharing_copilot_personal_wiki_contact_sharing_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/linkedin-connections
+   * Get Copilot Linkedin Connections
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/memory/context
+   * Get Copilot Memory Context
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_memory_context_copilot_memory_context_get: {
+    input: {
+    query?: {
+      /** Narrow to one campaign. */
+      campaign_id?: string | null;
+      /** Narrow to one company. */
+      company_id?: string | null;
+      /** Narrow to one contact. */
+      contact_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/memory/documents
+   * Get Copilot Memory Documents
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_memory_documents_copilot_memory_documents_get: {
+    input: {
+    query: {
+      /** organization | user | campaign | company | contact. */
+      subject_type: string;
+      /** Which one. */
+      subject_id: string;
+      /** `soul`, `memory` or `daily`. Omit for all three - they are different documents, not versions of one. */
+      file_kind?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki
+   * Get Copilot Personal Wiki
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_personal_wiki_copilot_personal_wiki_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/documents/{section}
+   * Get Copilot Personal Wiki Document
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_personal_wiki_document_copilot_personal_wiki_documents__section__get: {
+    input: {
+    path: {
+      /** Wiki section. */
+      section: string;
+    };
+    query: {
+      /** Which source document. */
+      document_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/relationships/{contact_id}
+   * Get Copilot Personal Wiki Relationship
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_personal_wiki_relationship_copilot_personal_wiki_relationships__contact_id__get: {
+    input: {
+    path: {
+      /** CRM contact id (integer). */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/sources
+   * Get Copilot Personal Wiki Sources
+   * tier: read · scope: knowledge:read
+   */
+  get_copilot_personal_wiki_sources_copilot_personal_wiki_sources_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/contact-sharing/contributions
+   * List Copilot Contact Contributions
+   * tier: read · scope: knowledge:read
+   */
+  list_copilot_contact_contributions_copilot_personal_wiki_contact_sharing_contributions_get: {
+    input: {
+    query?: {
+      offset?: number;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches
+   * List Copilot Contact Matches
+   * tier: read · scope: knowledge:read
+   */
+  list_copilot_contact_matches_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_get: {
+    input: {
+    path: {
+      /** Contribution id (UUID). */
+      contribution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * GET /copilot/memory
+   * List Copilot Memories
+   * tier: read · scope: knowledge:read
+   */
+  list_copilot_memories_copilot_memory_get: {
+    input: {
+    query?: {
+      /** Filter to one memory scope. */
+      scope?: string | null;
+      /** Page size. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/relationships
+   * List Copilot Personal Wiki Relationships
+   * tier: read · scope: knowledge:read
+   */
+  list_copilot_personal_wiki_relationships_copilot_personal_wiki_relationships_get: {
+    input: {
+    query?: {
+      item_id?: string | null;
+      /** Substring match on the person. */
+      query?: string;
+      /** `recent`, `name` or `email`. */
+      sort?: "recent" | "name" | "email";
+      offset?: number;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * GET /copilot/tools
+   * List Copilot Tools
+   * tier: read · scope: knowledge:read
+   */
+  list_copilot_tools_copilot_tools_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/drive-selection/preview
+   * Preview Copilot Personal Wiki Drive Selection
+   * tier: read · scope: knowledge:read
+   */
+  preview_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_preview_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalDriveSelectionRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/memory/promote
+   * Promote Copilot Memory
+   * tier: billable · scope: knowledge:run
+   */
+  promote_copilot_memory_copilot_memory_promote_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PromoteMemoryRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/resolve
+   * Resolve Copilot Contact Contribution
+   * tier: write · scope: knowledge:write
+   */
+  resolve_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__resolve_post: {
+    input: {
+    path: {
+      /** Contribution id (UUID). */
+      contribution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactReviewRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * POST /copilot/landing-page-action
+   * Run Copilot Landing Page Action
+   * tier: billable · scope: knowledge:run
+   */
+  run_copilot_landing_page_action_copilot_landing_page_action_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CopilotLandingPageActionRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/drive-selection
+   * Save Copilot Personal Wiki Drive Selection
+   * tier: write · scope: knowledge:write
+   */
+  save_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalDriveSelectionRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * GET /copilot/personal-wiki/contact-identities
+   * Search Copilot Contact Identities
+   * tier: read · scope: knowledge:read
+   */
+  search_copilot_contact_identities_copilot_personal_wiki_contact_identities_get: {
+    input: {
+    query: {
+      /** At least two characters. */
+      query: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CopilotMemoryListPayload_;
+  };
+  /**
+   * POST /copilot/mention-search
+   * Search Copilot Mentions
+   * tier: read · scope: knowledge:read
+   */
+  search_copilot_mentions_copilot_mention_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CopilotMentionSearchRequest;
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/contact-sharing/contributions/{contribution_id}
+   * Update Copilot Contact Contribution
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__put: {
+    input: {
+    path: {
+      /** Contribution id (UUID). */
+      contribution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactSharingRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/contact-sharing/people/choice
+   * Update Copilot Contact People Choice
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_contact_people_choice_copilot_personal_wiki_contact_sharing_people_choice_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactChoiceRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/contact-sharing/{mailbox_id}
+   * Update Copilot Contact Sharing
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_contact_sharing_copilot_personal_wiki_contact_sharing__mailbox_id__put: {
+    input: {
+    path: {
+      /** Integer `mailboxes.id` - the database primary key, not the cron-job string id. */
+      mailbox_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalContactSharingRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/linkedin-connections
+   * Update Copilot Linkedin Connections
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalLinkedInImportRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki
+   * Update Copilot Personal Wiki
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_personal_wiki_copilot_personal_wiki_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiUpdateRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/personal-wiki/sources
+   * Update Copilot Personal Wiki Sources
+   * tier: write · scope: knowledge:write
+   */
+  update_copilot_personal_wiki_sources_copilot_personal_wiki_sources_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonalWikiSourcesUpdateRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+  /**
+   * PUT /copilot/memory/documents
+   * Upsert Copilot Memory Document
+   * tier: write · scope: knowledge:write
+   */
+  upsert_copilot_memory_document_copilot_memory_documents_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MemoryDocumentRequest;
+  };
+    output: ApiResponse_CopilotMemoryPayload_;
+  };
+}
+
+// 32 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_CopilotMemoryListPayload_ {
+  data: CopilotMemoryListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CopilotMemoryPayload_ {
+  data: CopilotMemoryPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioContentListPayload_ {
+  data: StudioContentListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioContentPayload_ {
+  data: StudioContentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+/** What the copilot is looking at: a document, a selection, a campaign or account. */
+export interface CopilotCanvasContext {
+  accountId?: string | null;
+  /** {path, content, type, status}. */
+  activeDocument?: Record<string, unknown> | null;
+  campaignId?: string | null;
+  /** {line, column}. */
+  cursor?: Record<string, number> | null;
+  mode?: "global" | "campaign" | "account";
+  /** {text, start_line, end_line}. */
+  selection?: Record<string, unknown> | null;
+}
+
+/** One earlier turn of the conversation. */
+export interface CopilotChatMessage {
+  content: string;
+  role: "user" | "assistant" | "system" | "tool";
+  tool_name?: string | null;
+  tool_result?: Record<string, unknown> | null;
+}
+
+/** One message to the Studio copilot. SPENDS CREDIT. The answer is returned whole. */
+export interface CopilotChatRequest {
+  canvas_context?: CopilotCanvasContext | null;
+  conversation_history?: Array<CopilotChatMessage> | null;
+  /** Results from `POST /copilot/mention-search`. */
+  mentions?: Array<Record<string, unknown>> | null;
+  message: string;
+  /** Multi-step deep research. The most expensive option. */
+  research?: boolean;
+  session_id?: string | null;
+  /** Extended thinking. */
+  thinking?: boolean;
+  /** Search the web before answering. */
+  web_search?: boolean;
+}
+
+/** A section-level change to a landing page. `edit_section` SPENDS CREDIT. */
+export interface CopilotLandingPageActionRequest {
+  action_type: "edit_section" | "add_section" | "remove_section" | "reorder_sections";
+  /** For edit_section. */
+  instruction?: string | null;
+  landing_page_id: string;
+  /** For reorder_sections: the new index order. */
+  new_order?: Array<number> | null;
+  /** For add_section. */
+  new_section_type?: string | null;
+  /** For edit_section and remove_section. */
+  section_idx?: number | null;
+  selected_text?: string | null;
+}
+
+/** An open envelope for a LIST answer, so a bare list keeps its shape. */
+export interface CopilotMemoryListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for one memory, wiki or sharing answer.
+ *
+ * Open because the personal wiki is a DOCUMENT whose sections follow what has
+ * been learned about a person, and because each fact carries provenance -
+ * which mailbox or meeting it came from - that grows as new sources are
+ * connected. Pinning the shape would silently drop the provenance on the
+ * newest source, and on a "what do you know about me" surface a fact with no
+ * visible origin is worse than no fact.
+ */
+export type CopilotMemoryPayload = Record<string, unknown>;
+
+/** Find documents, personas, ICPs, campaigns and teammates to @mention. */
+export interface CopilotMentionSearchRequest {
+  campaign_id?: string | null;
+  mode?: ("global" | "campaign" | "account") | null;
+  query?: string;
+}
+
+/** A BODY for what the app takes as query scalars. See the module docstring. */
+export interface MemoryCreateRequest {
+  /** What to remember, in the caller's own words. */
+  content: string;
+  /** Who the memory belongs to. `user` - only this person's Copilot recalls it. Left an open string rather than a Literal because the handler treats an unknown scope as a label rather than an error, so closing it here would refuse a call the app accepts. */
+  scope?: string;
+}
+
+/** A BODY for what the app takes as query scalars. See the module docstring. */
+export interface MemoryDocumentAppendRequest {
+  /** The text to append. */
+  content: string;
+  /** Which document to append to. `daily` is the rolling journal and is the default; `memory` and `soul` are the durable ones and are normally written through `PUT /copilot/memory/documents` instead. */
+  file_kind?: string;
+  /** Which one. */
+  subject_id: string;
+  /** What the document is about: organization, user, campaign, company or contact. */
+  subject_type: string;
+}
+
+/** Mirror of `MemoryDocumentRequest`. */
+export interface MemoryDocumentRequest {
+  /** The WHOLE document. This is an upsert, not an append: it replaces what is there. Use `POST /copilot/memory/documents/append` to add without replacing. */
+  content: string;
+  /** `soul` - who the subject is. `memory` - durable facts. `daily` - the rolling journal. */
+  file_kind: string;
+  /** Which one. */
+  subject_id: string;
+  /** organization | user | campaign | company | contact. */
+  subject_type: string;
+  /** Display title. */
+  title?: string | null;
+  /** `shared` - the whole org's Copilot may draw on it. Defaults to shared, matching the app, so a document written without thinking about this is visible org-wide. */
+  visibility?: string;
+}
+
+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 `PersonalContactChoiceRequest`. */
+export interface PersonalContactChoiceRequest {
+  /** Per-connection revision tokens, keyed by connection id (UUID). */
+  connection_revisions?: Record<string, number>;
+  /** Concurrency token from the sharing GET. */
+  expected_revision: number;
+  /** The people (wiki facts) this choice applies to. */
+  fact_ids?: Array<string>;
+  /** `private` keeps these people to yourself, `shared` offers them to the org's CRM, `default` follows the mailbox-level setting. */
+  mode: "default" | "private" | "shared";
+}
+
+/** Mirror of `PersonalContactIdentityRequest`. */
+export interface PersonalContactIdentityRequest {
+  /** Who they are really about. NULL DETACHES them from whoever they are attributed to now, rather than being ignored - it is how you say 'this is not about anyone in the CRM'. */
+  contact_id?: number | null;
+  /** Optimistic-concurrency token for the relationship record. */
+  expected_version: number;
+  /** The facts being re-attributed, all to the same person. */
+  fact_ids: Array<string>;
+}
+
+/** Mirror of `PersonalContactMatchRequest`. */
+export interface PersonalContactMatchRequest {
+  /** The CRM contact this contribution is actually about. */
+  contact_id: number;
+  expected_canonical_revision: string;
+  expected_revision: number;
+}
+
+/** Mirror of `PersonalContactReviewRequest`. */
+export interface PersonalContactReviewRequest {
+  /** `keep_current` - the CRM record wins. `use_proposed` - the contributed value wins and overwrites it. */
+  choice: "keep_current" | "use_proposed";
+  /** Digest of the CANONICAL contact record as you read it. Two tokens are required because two records are in play: the contribution and the contact it would change. Either moving means the decision was made against something that no longer holds. */
+  expected_canonical_revision: string;
+  /** The contribution's revision. */
+  expected_revision: number;
+  /** Which field is being decided. */
+  field: "CONTACT_FIRST_NAME" | "CONTACT_LAST_NAME" | "CONTACT_JOB_TITLE";
+}
+
+/** Mirror of `PersonalContactSharingRequest`. */
+export interface PersonalContactSharingRequest {
+  /** Whether what this mailbox knows about a contact is contributed to the organisation's shared CRM record. Explicit rather than a toggle, so a retry is idempotent instead of switching it back. */
+  enabled: boolean;
+  /** REQUIRED optimistic-concurrency token. Sharing settings decide whether one person's private contact knowledge becomes org-wide, so there is no unconditional write: a blind one could re-enable sharing somebody had just turned off. */
+  expected_revision: number;
+}
+
+/** Mirror of `PersonalDriveFolderChoice`. */
+export interface PersonalDriveFolderChoice {
+  /** Keep reading new documents added to this folder later, not just today's. */
+  auto_sync?: boolean;
+  /** Drive folder id, as returned by `GET /copilot/personal-wiki/drive`. */
+  id: string;
+}
+
+/** Mirror of `PersonalDriveSelectionRequest`. */
+export interface PersonalDriveSelectionRequest {
+  /** Individual Drive documents to read. */
+  document_ids?: Array<string>;
+  /** Whole folders to read. */
+  folders?: Array<PersonalDriveFolderChoice>;
+  /** Integer `mailboxes.id` of the connected Google account. */
+  mailbox_id: number;
+  /** The `fingerprint` from the preview call. When sent, the save is refused (409) if the selection no longer resolves to what you previewed. */
+  preview_fingerprint?: string | null;
+  /** The sources' `updated_at` from `GET /copilot/personal-wiki/sources`. A mismatch is a 409: someone else changed the selection since you read it. */
+  revision?: string | null;
+}
+
+/** Mirror of `PersonalLinkedInImportRequest`. */
+export interface PersonalLinkedInImportRequest {
+  /** The `revision` from the GET. A stale value is a 409. */
+  expected_revision: number;
+  /** Re-import the connection list on a schedule. */
+  keep_updated?: boolean;
+  /** Offer what is learned from these connections to the shared CRM (reviewed first). */
+  share?: boolean;
+  /** Start an import now, rather than only saving the settings. */
+  start?: boolean;
+}
+
+/** Mirror of `PersonalWikiFactActionRequest` - used by confirm and forget. */
+export interface PersonalWikiFactActionRequest {
+  /** The fact. */
+  fact_id: string;
+  /** Why. Optional, and worth sending on a forget: it is the only record of why something was removed from what the Copilot knows. */
+  reason?: string | null;
+}
+
+/**
+ * Mirror of `PersonalWikiFactCorrectionRequest`.
+ *
+ * The app declares it as a SUBCLASS of the action request and restates the
+ * inherited fields. Flattened here because a generated SDK renders
+ * inheritance as a separate schema for no benefit, and the parity test
+ * compares the RESOLVED field set, which is identical.
+ */
+export interface PersonalWikiFactCorrectionRequest {
+  /** For a fact the Copilot is tracking as a TO-DO rather than as a statement, move it to this state at the same time. Omit it for an ordinary correction. */
+  action_state?: ("open" | "in_progress" | "blocked" | "completed" | "cancelled" | "informational") | null;
+  fact_id: string;
+  reason?: string | null;
+  /** What is actually true. Replaces the fact's text. */
+  text: string;
+}
+
+/** Mirror of `PersonalWikiItemEditRequest`. */
+export interface PersonalWikiItemEditRequest {
+  document_id: string;
+  /** REQUIRED optimistic-concurrency token - a 64-character digest of the document you read. There is no unconditional write here, on purpose: the wiki is edited by the Copilot as well as by people, so a blind write would silently discard something it had just learned. */
+  expected_revision: string;
+  /** Field-by-field replacement for this item. Open-shaped because the item schema is per-section and defined by the wiki template. */
+  values: Record<string, unknown>;
+}
+
+/**
+ * Mirror of `PersonalWikiSourcesUpdateRequest`.
+ *
+ * PARTIAL: the handler applies `exclude_unset`, so an omitted field is left
+ * alone and an explicit value changes it. Sending `email_enabled: false` is
+ * not the same instruction as omitting it.
+ */
+export interface PersonalWikiSourcesUpdateRequest {
+  /** Further mailboxes to read. */
+  additional_mailbox_ids?: Array<number> | null;
+  /** Read your calendar. */
+  calendar_enabled?: boolean | null;
+  /** Read the named documents. */
+  docs_enabled?: boolean | null;
+  /** Which documents, when `docs_enabled`. */
+  document_ids?: Array<string> | null;
+  /** Whether the Copilot reads your email to build the wiki. Turning this off stops new facts arriving from email; it does not remove what it already learned - use `POST /copilot/personal-wiki/forget` for that. */
+  email_enabled?: boolean | null;
+  /** The mailbox the wiki draws its email signal from. */
+  primary_mailbox_id?: number | null;
+  /** Read your Work activity. */
+  work_enabled?: boolean | null;
+}
+
+/** Mirror of `PersonalWikiUpdateRequest`. */
+export interface PersonalWikiUpdateRequest {
+  /** The WHOLE wiki document. Replaces what is there. */
+  content: string;
+  title?: string | null;
+}
+
+/** Mirror of `PromoteRequest`. */
+export interface PromoteMemoryRequest {
+  /** How far back through the daily journal to look for things worth keeping. Promotion is what stops the journal growing forever and the durable memory staying empty. */
+  days_back?: number;
+  /** Which one. */
+  subject_id: string;
+  /** organization | user | campaign | company | contact. */
+  subject_type: string;
+}
+
+/**
+ * Mirror of `SoulCaptureRequest`.
+ *
+ * Every field optional: this is used to fill in whichever of the three
+ * documents the caller has, and sending one does not clear the others.
+ */
+export interface SoulCaptureRequest {
+  /** Durable org-level facts. */
+  org_memory?: string | null;
+  /** Who the organisation is. */
+  org_soul?: string | null;
+  /** Durable facts about this person. */
+  user_memory?: string | null;
+}
+
+/**
+ * A LIST result, open-shaped, with `items` always present.
+ *
+ * The app returns a bare list from some routes and a named key from others
+ * (`pages`, `grids`, `images`, `creatives`, `reports`, `items`). Both are
+ * published: the original key is preserved AND mirrored onto `items`, so a
+ * client can page any Studio collection the same way without a per-route
+ * lookup table.
+ */
+export interface StudioContentListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** One Studio object, open-shaped. See the module docstring. */
+export type StudioContentPayload = Record<string, unknown>;