@graph8/sdk 0.245.0 → 0.260.0

package/docs/api/socialPublishing.d.ts

@@ -0,0 +1,824 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.socialPublishing` (Social Publishing): 22 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"add_social_engagers_to_audience_social_posts__post_id__engagers_add_to_audience_post">;
+ *
+ * Reference with examples: socialPublishing.md
+ */
+/* eslint-disable */
+
+/** `g8.api.socialPublishing.<member>` -> the operationId it calls. */
+export interface SocialPublishingMembers {
+  addSocialEngagersToAudience: "add_social_engagers_to_audience_social_posts__post_id__engagers_add_to_audience_post";
+  cancelSocialPost: "cancel_social_post_social_posts__post_id__cancel_post";
+  createSocialPost: "create_social_post_social_posts_post";
+  deleteSocialPost: "delete_social_post_social_posts__post_id__delete";
+  disconnectSocialAccount: "disconnect_social_account_social_accounts__account_id__delete";
+  enrollSocialEngagers: "enroll_social_engagers_social_posts__post_id__engagers_enroll_post";
+  generateSocialPost: "generate_social_post_social_posts_generate_post";
+  getSocialAnalytics: "get_social_analytics_social_analytics_get";
+  getSocialAutopilot: "get_social_autopilot_social_autopilot__account_id__get";
+  getSocialGenerationContext: "get_social_generation_context_social_generate_context_get";
+  getSocialPost: "get_social_post_social_posts__post_id__get";
+  getSocialPostMetrics: "get_social_post_metrics_social_posts__post_id__metrics_get";
+  listSocialAccounts: "list_social_accounts_social_accounts_get";
+  listSocialIdeas: "list_social_ideas_social_ideas_get";
+  listSocialPostEngagers: "list_social_post_engagers_social_posts__post_id__engagers_get";
+  listSocialPosts: "list_social_posts_social_posts_get";
+  listSocialProviders: "list_social_providers_social_providers_get";
+  pauseSocialAutopilot: "pause_social_autopilot_social_autopilot__account_id__pause_post";
+  publishSocialPost: "publish_social_post_social_posts__post_id__publish_post";
+  saveSocialAutopilot: "save_social_autopilot_social_autopilot__account_id__put";
+  scheduleSocialPost: "schedule_social_post_social_posts__post_id__schedule_post";
+  updateSocialPost: "update_social_post_social_posts__post_id__patch";
+}
+
+/** Input and output of every `g8.api.socialPublishing` operation, keyed by operationId. */
+export interface SocialPublishingOperations {
+  /**
+   * POST /social/posts/{post_id}/engagers/add-to-audience
+   * Add Social Engagers To Audience
+   * tier: external · scope: campaigns:run
+   */
+  add_social_engagers_to_audience_social_posts__post_id__engagers_add_to_audience_post: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialAudienceFromEngagersRequest;
+  };
+    output: ApiResponse_SocialAudienceFromEngagers_;
+  };
+  /**
+   * POST /social/posts/{post_id}/cancel
+   * Cancel Social Post
+   * tier: destructive · scope: campaigns:delete
+   */
+  cancel_social_post_social_posts__post_id__cancel_post: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPost_;
+  };
+  /**
+   * POST /social/posts
+   * Create Social Post
+   * tier: write · scope: campaigns:write
+   */
+  create_social_post_social_posts_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialPostCreateRequest;
+  };
+    output: ApiResponse_SocialPost_;
+  };
+  /**
+   * DELETE /social/posts/{post_id}
+   * Delete Social Post
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_social_post_social_posts__post_id__delete: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialDeleted_;
+  };
+  /**
+   * DELETE /social/accounts/{account_id}
+   * Disconnect Social Account
+   * tier: destructive · scope: campaigns:delete
+   */
+  disconnect_social_account_social_accounts__account_id__delete: {
+    input: {
+    path: {
+      /** An `id` from `GET /social/accounts`. */
+      account_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialDeleted_;
+  };
+  /**
+   * POST /social/posts/{post_id}/engagers/enroll
+   * Enroll Social Engagers
+   * tier: external · scope: campaigns:run
+   */
+  enroll_social_engagers_social_posts__post_id__engagers_enroll_post: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialEnrollEngagersRequest;
+  };
+    output: ApiResponse_SocialEnrollResult_;
+  };
+  /**
+   * POST /social/posts/generate
+   * Generate Social Post
+   * tier: billable · scope: campaigns:run
+   */
+  generate_social_post_social_posts_generate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialPostGenerateRequest;
+  };
+    output: ApiResponse_SocialGenerated_;
+  };
+  /**
+   * GET /social/analytics
+   * Get Social Analytics
+   * tier: read · scope: campaigns:read
+   */
+  get_social_analytics_social_analytics_get: {
+    input: {
+    query?: {
+      /** Window, in days back from today. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialAnalytics_;
+  };
+  /**
+   * GET /social/autopilot/{account_id}
+   * Get Social Autopilot
+   * tier: read · scope: campaigns:read
+   */
+  get_social_autopilot_social_autopilot__account_id__get: {
+    input: {
+    path: {
+      /** An `id` from `GET /social/accounts`. */
+      account_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialAutopilot_;
+  };
+  /**
+   * GET /social/generate/context
+   * Get Social Generation Context
+   * tier: read · scope: campaigns:read
+   */
+  get_social_generation_context_social_generate_context_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialGenerationContext_;
+  };
+  /**
+   * GET /social/posts/{post_id}
+   * Get Social Post
+   * tier: read · scope: campaigns:read
+   */
+  get_social_post_social_posts__post_id__get: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPost_;
+  };
+  /**
+   * GET /social/posts/{post_id}/metrics
+   * Get Social Post Metrics
+   * tier: read · scope: campaigns:read
+   */
+  get_social_post_metrics_social_posts__post_id__metrics_get: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPostMetrics_;
+  };
+  /**
+   * GET /social/accounts
+   * List Social Accounts
+   * tier: read · scope: campaigns:read
+   */
+  list_social_accounts_social_accounts_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialAccountList_;
+  };
+  /**
+   * GET /social/ideas
+   * List Social Ideas
+   * tier: read · scope: campaigns:read
+   */
+  list_social_ideas_social_ideas_get: {
+    input: {
+    query?: {
+      /** Only ideas from this source. */
+      source?: ("signal_mining" | "linkedin_trending" | "proof_freshness" | "repurpose" | "ai") | null;
+      /** Mine fresh ideas before answering. */
+      refresh?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialIdeas_;
+  };
+  /**
+   * GET /social/posts/{post_id}/engagers
+   * List Social Post Engagers
+   * tier: read · scope: campaigns:read
+   */
+  list_social_post_engagers_social_posts__post_id__engagers_get: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    query?: {
+      /** Fetch fresh from the network instead of the stored copy. */
+      refresh?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialEngagers_;
+  };
+  /**
+   * GET /social/posts
+   * List Social Posts
+   * tier: read · scope: campaigns:read
+   */
+  list_social_posts_social_posts_get: {
+    input: {
+    query?: {
+      /** Only posts in this state. */
+      status?: ("draft" | "ready" | "scheduled" | "publishing" | "live" | "failed" | "cancelled") | null;
+      page?: number;
+      page_size?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPostPage_;
+  };
+  /**
+   * GET /social/providers
+   * List Social Providers
+   * tier: read · scope: campaigns:read
+   */
+  list_social_providers_social_providers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialProviderList_;
+  };
+  /**
+   * POST /social/autopilot/{account_id}/pause
+   * Pause Social Autopilot
+   * tier: write · scope: campaigns:write
+   */
+  pause_social_autopilot_social_autopilot__account_id__pause_post: {
+    input: {
+    path: {
+      /** An `id` from `GET /social/accounts`. */
+      account_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialAutopilot_;
+  };
+  /**
+   * POST /social/posts/{post_id}/publish
+   * Publish Social Post
+   * tier: external · scope: campaigns:run
+   */
+  publish_social_post_social_posts__post_id__publish_post: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPublishAccepted_;
+  };
+  /**
+   * PUT /social/autopilot/{account_id}
+   * Save Social Autopilot
+   * tier: external · scope: campaigns:run
+   */
+  save_social_autopilot_social_autopilot__account_id__put: {
+    input: {
+    path: {
+      /** An `id` from `GET /social/accounts`. */
+      account_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialAutopilotSaveRequest;
+  };
+    output: ApiResponse_SocialAutopilot_;
+  };
+  /**
+   * POST /social/posts/{post_id}/schedule
+   * Schedule Social Post
+   * tier: external · scope: campaigns:run
+   */
+  schedule_social_post_social_posts__post_id__schedule_post: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialPostScheduleRequest;
+  };
+    output: ApiResponse_SocialPost_;
+  };
+  /**
+   * PATCH /social/posts/{post_id}
+   * Update Social Post
+   * tier: write · scope: campaigns:write
+   */
+  update_social_post_social_posts__post_id__patch: {
+    input: {
+    path: {
+      /** The post's id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SocialPostUpdateRequest;
+  };
+    output: ApiResponse_SocialPost_;
+  };
+}
+
+// 50 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_SocialAccountList_ {
+  data: SocialAccountList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialAnalytics_ {
+  data: SocialAnalytics;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialAudienceFromEngagers_ {
+  data: SocialAudienceFromEngagers;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialAutopilot_ {
+  data: SocialAutopilot;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialDeleted_ {
+  data: SocialDeleted;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialEngagers_ {
+  data: SocialEngagers;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialEnrollResult_ {
+  data: SocialEnrollResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialGenerated_ {
+  data: SocialGenerated;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialGenerationContext_ {
+  data: SocialGenerationContext;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialIdeas_ {
+  data: SocialIdeas;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialPostMetrics_ {
+  data: SocialPostMetrics;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialPostPage_ {
+  data: SocialPostPage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialPost_ {
+  data: SocialPost;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialProviderList_ {
+  data: SocialProviderList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialPublishAccepted_ {
+  data: SocialPublishAccepted;
+  pagination?: PaginationMeta | null;
+}
+
+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;
+}
+
+/** A connected social account. `id` is what `account_ref` takes everywhere else. */
+export interface SocialAccount {
+  capabilities: SocialCapabilities;
+  capacity: SocialAccountCapacity;
+  display_name?: string | null;
+  id: string;
+  profile_url?: string | null;
+  provider: string;
+  status?: string | null;
+}
+
+export interface SocialAccountCapacity {
+  publish_limit: number;
+  publish_used: number;
+}
+
+export interface SocialAccountList {
+  items: Array<SocialAccount>;
+}
+
+/** Totals and a per-day series over the requested window. */
+export interface SocialAnalytics {
+  per_day: Array<Record<string, unknown>>;
+  totals: Record<string, number>;
+}
+
+/** The audience built from a post's engagers. */
+export interface SocialAudienceFromEngagers {
+  added: number;
+  audience_id: number;
+  audience_name: string;
+  created: number;
+  matched: number;
+  skipped_no_identity: number;
+  truncated?: boolean;
+}
+
+/** Build an audience from the people who engaged with a post. */
+export interface SocialAudienceFromEngagersRequest {
+  audience_name?: string | null;
+}
+
+/** Autopilot configuration and state for one account. */
+export interface SocialAutopilot {
+  account_ref: string;
+  auto_publish_confirmed?: boolean;
+  available: boolean;
+  configured?: boolean;
+  direction?: string;
+  enabled?: boolean;
+  estimated_generation_credits?: number;
+  id?: string | null;
+  last_blocking_error?: string | null;
+  last_planned_at?: string | null;
+  next_slots?: Array<string>;
+  prompt_version?: number;
+  scheduled_count?: number;
+  timezone?: string;
+  unscheduled_posts?: number;
+  weekly_queue_slots?: Array<SocialQueueSlot>;
+}
+
+/** Configure autopilot for one account. */
+export interface SocialAutopilotSaveRequest {
+  /** True lets autopilot PUBLISH what it writes without a human approving each post. */
+  auto_publish_confirmed?: boolean;
+  /** What autopilot should post about. */
+  direction: string;
+  enabled?: boolean;
+  /** IANA timezone. */
+  timezone: string;
+  weekly_queue_slots: Array<SocialQueueSlot>;
+}
+
+/** What an account's connection can do. */
+export interface SocialCapabilities {
+  analytics: boolean;
+  leads: boolean;
+  media: boolean;
+  publish_company: boolean;
+  publish_personal: boolean;
+}
+
+/** The resource is gone. */
+export interface SocialDeleted {
+  deleted?: boolean;
+}
+
+/** One person who engaged with a post. */
+export interface SocialEngager {
+  action: string;
+  contact_id?: number | null;
+  headline?: string;
+  linkedin_url?: string | null;
+  name: string;
+  resolution: string;
+}
+
+/** Engagers of a post. `truncated: true` means this is a PARTIAL list. */
+export interface SocialEngagers {
+  items: Array<SocialEngager>;
+  supported?: boolean;
+  total: number;
+  truncated?: boolean;
+}
+
+/** Enroll chosen engagers of a post into a sequence. */
+export interface SocialEnrollEngagersRequest {
+  /** `contact_id`s from the post's engagers. */
+  contact_ids: Array<number>;
+  sequence_id: string;
+}
+
+/** Engagers enrolled into a sequence. */
+export interface SocialEnrollResult {
+  audience_id: number;
+  enrolled: number;
+  sequence_status?: string | null;
+}
+
+/** Generated drafts. Nothing has been saved. */
+export interface SocialGenerated {
+  credits_used: number;
+  provenance: Array<string>;
+  variants: Array<SocialVariant>;
+}
+
+/** Which grounding sources have data to draw on. */
+export interface SocialGenerationContext {
+  brand_voice: boolean;
+  campaign_brief: boolean;
+  inbox_insights: number;
+  proof_points: number;
+  recent_content: number;
+  top_posts: number;
+}
+
+/** One post idea. */
+export interface SocialIdea {
+  concept?: string;
+  created_at?: string | null;
+  drafted_count?: number;
+  favorited?: boolean;
+  fit: SocialIdeaFit;
+  id: string;
+  primary_hook?: string | null;
+  proof_points?: string | null;
+  receipts?: Array<SocialIdeaReceipt>;
+  secondary_hooks?: Array<string>;
+  source: string;
+  title: string;
+  why?: string;
+}
+
+export interface SocialIdeaFit {
+  grade?: string | null;
+  reason?: string | null;
+}
+
+export interface SocialIdeaReceipt {
+  count: number;
+  kind: string;
+}
+
+/** Post ideas, plus how many came from each source. */
+export interface SocialIdeas {
+  items: Array<SocialIdea>;
+  sources: Record<string, number>;
+}
+
+/** One image (or other asset) attached to a post. */
+export interface SocialMediaItem {
+  /** Alt text. `alt_text` is accepted as a synonym. */
+  alt?: string;
+  /** Asset-library id, when the asset came from there. */
+  id?: string | null;
+  /** Asset kind. `image` for a picture. */
+  kind?: string;
+  /** Publicly fetchable URL of the asset. */
+  url: string;
+}
+
+/** One post. */
+export interface SocialPost {
+  account_ref?: string | null;
+  autopilot_config_id?: string | null;
+  autopilot_version?: number | null;
+  body: string;
+  campaign_id?: string | null;
+  created_at?: string | null;
+  created_by: string;
+  external_post_id?: string | null;
+  external_post_url?: string | null;
+  failure_reason?: string | null;
+  generation_metadata?: Record<string, unknown> | null;
+  generation_sources?: Array<string> | null;
+  id: string;
+  idea_id?: string | null;
+  media?: Array<Record<string, unknown>> | null;
+  post_type: string;
+  provider?: string | null;
+  published_at?: string | null;
+  scheduled_at?: string | null;
+  status: string;
+  updated_at?: string | null;
+}
+
+/** A new post. Created as a DRAFT - nothing is published until you schedule or publish it. */
+export interface SocialPostCreateRequest {
+  /** The account it will publish from - an `id` from `GET /social/accounts`. Optional: a draft can be written before any account is connected, but one is required to schedule or publish. */
+  account_ref?: string | null;
+  /** The post text. */
+  body: string;
+  /** Campaign to attribute the post to. */
+  campaign_id?: string | null;
+  generation_sources?: Array<string> | null;
+  /** The idea from `GET /social/ideas` this came from. */
+  idea_id?: string | null;
+  /** Repeat a create with the same key to get the original post back instead of a duplicate. */
+  idempotency_key?: string | null;
+  media?: Array<SocialMediaItem> | null;
+  post_type?: "text" | "image" | "video" | "document";
+}
+
+/**
+ * Ask the AI studio for draft variants. SPENDS CREDITS; saves nothing.
+ *
+ * The variants come back in the response - create a post from the one you
+ * want with `POST /social/posts`.
+ */
+export interface SocialPostGenerateRequest {
+  campaign_id?: string | null;
+  /** Older synonym of `instructions`. */
+  context?: string | null;
+  frame?: string | null;
+  hashtags_max?: number;
+  idea_id?: string | null;
+  instructions?: string | null;
+  /** Someone else's post, used as a structural template only. */
+  reference_post?: string | null;
+  refine?: SocialRefineSpec | null;
+  /** Grounding sources. Omit for the default set (brand_voice, campaign_brief, proof_catalog, inbox_insights). `GET /social/generate/context` says which have data. */
+  sources?: Array<string> | null;
+  tone?: string | null;
+  variants?: number;
+}
+
+/** Engagement on a published post. `supported: false` means the zeros are placeholders, not measurements. */
+export interface SocialPostMetrics {
+  comments?: number;
+  fetched_at?: string | null;
+  impressions?: number;
+  reactions?: number;
+  shares?: number;
+  supported?: boolean;
+}
+
+/** A page of posts plus the org-wide count per status. */
+export interface SocialPostPage {
+  counts: Record<string, number>;
+  items: Array<SocialPost>;
+  total: number;
+}
+
+/** When to publish. */
+export interface SocialPostScheduleRequest {
+  /** ISO 8601. Include a timezone offset. */
+  scheduled_at: string;
+}
+
+/**
+ * Edit a post. Only the fields you send change.
+ *
+ * `account_ref: null` sent EXPLICITLY detaches the draft from its account;
+ * omitting the field leaves the account alone.
+ */
+export interface SocialPostUpdateRequest {
+  account_ref?: string | null;
+  body?: string | null;
+  media?: Array<SocialMediaItem> | null;
+  post_type?: ("text" | "image" | "video" | "document") | null;
+}
+
+/** A way of connecting an account. */
+export interface SocialProvider {
+  available: boolean;
+  capabilities: SocialCapabilities;
+  connect_method: string;
+  description: string;
+  key: string;
+  label: string;
+}
+
+export interface SocialProviderList {
+  items: Array<SocialProvider>;
+}
+
+/** Publishing was queued. `status` is the post's state right now - `scheduled` until the publisher claims it. */
+export interface SocialPublishAccepted {
+  post: SocialPost;
+  status: string;
+}
+
+/** A weekly publishing slot. */
+export interface SocialQueueSlot {
+  /** 0 = Monday ... 6 = Sunday. */
+  day: number;
+  /** HH:MM in the autopilot's timezone. */
+  time: string;
+}
+
+/** Rewrite an existing draft instead of generating from scratch. */
+export interface SocialRefineSpec {
+  body: string;
+  instruction: string;
+}
+
+/** One generated draft. */
+export interface SocialVariant {
+  body: string;
+  frame: string;
+}