revert: restore original title and description frontmatter across 602 docs pages

src/pages/docs/admin-settings.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Admin Settings: API Keys Setup"
-description: "Access and manage your Future AGI API keys and secret keys from the developer dashboard for SDK and API authentication."
+title: "Admin Settings"
+description: "Learn how to access and manage your Future AGI API keys and secret keys from the developer dashboard for authentication."
 ---
 
 ## Accessing API Keys

src/pages/docs/admin-settings/ai-providers.mdx

@@ -1,6 +1,6 @@
 ---
-title: "AI Providers: Connect LLM Services"
-description: "Connect OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, and custom model endpoints to Future AGI for evaluations and optimization."
+title: "AI Providers"
+description: "Configure LLM providers and custom models for evaluations, optimization, and other platform features."
 ---
 
 ## About

src/pages/docs/admin-settings/api-keys.mdx

@@ -1,6 +1,6 @@
 ---
-title: "API Keys: Create & Manage Credentials"
-description: "Create, copy, and rotate FI_API_KEY and FI_SECRET_KEY credentials for authenticating with Future AGI Python and TypeScript SDKs."
+title: "API Keys"
+description: "Create and manage API keys for authenticating with Future AGI SDKs and APIs."
 ---
 
 ## About

src/pages/docs/admin-settings/billing-pricing.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Billing & Pricing: Plans and Wallet"
-description: "Manage your Future AGI subscription plan, add wallet funds, configure auto-reload, update billing info, and view invoice history."
+title: "Billing & Pricing"
+description: "Manage your subscription, add funds, configure auto-reload, and view invoices."
 ---
 
 ## About

src/pages/docs/admin-settings/index.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Admin & Settings: Full Reference"
-description: "Manage your Future AGI account: profile, organization, team members, workspaces, API keys, AI providers, integrations, usage, and billing."
+title: "Admin & Settings"
+description: "Manage your account, organization, workspaces, API keys, integrations, billing, and team."
 ---
 
 ## About

src/pages/docs/admin-settings/integrations.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Integrations: Datadog, PostHog & More"
-description: "Connect Future AGI to Datadog, PostHog, PagerDuty, Langfuse, S3, and other platforms for observability, alerting, and log archival."
+title: "Integrations"
+description: "Connect Future AGI to external tools for observability, alerting, analytics, and log archival."
 ---
 
 ## About

src/pages/docs/admin-settings/organization-settings.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Organization Settings: Name & 2FA Policy"
-description: "Configure your organization's display name and enforce mandatory two-factor authentication for all members in Future AGI."
+title: "Organization Settings"
+description: "Configure your organization name and security policies."
 ---
 
 ## About

src/pages/docs/admin-settings/profile-security.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Profile & Security: 2FA and Passkeys"
-description: "Update your name, reset your password, enable TOTP two-factor authentication, register passkeys, and manage recovery codes in Future AGI."
+title: "Profile & Security"
+description: "Manage your profile information, password, two-factor authentication, and passkeys."
 ---
 
 ## About

src/pages/docs/admin-settings/usage-summary.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Usage Summary: Tokens & API Metrics"
-description: "Monitor API call counts, input/output token usage, and evaluation runs broken down by month and workspace in Future AGI."
+title: "Usage Summary"
+description: "Track API calls, token usage, and evaluation runs across your organization and workspaces."
 ---
 
 ## About

src/pages/docs/admin-settings/user-management.mdx

@@ -1,6 +1,6 @@
 ---
-title: "User Management: Invite & Assign Roles"
-description: "Invite team members, assign Owner, Admin, Member, or Viewer roles, manage workspace access, and deactivate users in Future AGI."
+title: "User Management"
+description: "Invite users, assign roles, and manage team members across your organization."
 ---
 
 ## About

src/pages/docs/admin-settings/workspace-management.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Workspace Management: Projects & Teams"
-description: "Create workspaces to isolate environments and teams, manage workspace members, AI providers, integrations, and usage per workspace."
+title: "Workspace Management"
+description: "Create and configure workspaces to organize projects, teams, and resources."
 ---
 
 ## About

src/pages/docs/agent-playground/concepts/understanding-agent-playground.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Agent Playground: Core Concepts"
-description: "Learn the core building blocks of Agent Playground: graphs, LLM nodes, subgraph nodes, ports, edges, and node templates."
+title: "Understanding Agent Playground"
+description: "Learn the core building blocks of Agent Playground: graphs, nodes, ports, edges, and node templates."
 ---
 
 ## About

src/pages/docs/agent-playground/concepts/versions-and-execution.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Agent Workflow Versions & Execution"
-description: "Understand Agent Playground's draft/non-draft version lifecycle, topological execution model, node states, and data routing between nodes."
+title: "Versions & Execution"
+description: "Understand the version lifecycle, execution model, data routing, and batch execution in Agent Playground."
 ---
 
 ## About

src/pages/docs/agent-playground/features/build-workflow.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Build an AI Agent Workflow"
-description: "Add LLM Prompt and Agent nodes to the canvas, configure models and parameters, draw edges, and set global variables in Agent Playground."
+title: "Build a Workflow"
+description: "Add nodes, configure them, and connect them into an AI agent pipeline using the visual graph editor."
 ---
 
 ## About

src/pages/docs/agent-playground/features/create-graph.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Create an Agent Graph & Manage Versions"
-description: "Create a new agent graph in Agent Playground, set metadata, manage draft and saved versions, and roll back to previous workflow snapshots."
+title: "Create a Graph"
+description: "Create your first agent graph, manage metadata, and work with versions in Agent Playground."
 ---
 
 ## About

src/pages/docs/agent-playground/features/run-and-monitor.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Run & Monitor Agent Workflows"
-description: "Execute AI agent workflows, watch per-node status in real time, inspect input/output data for each step, and browse full execution history."
+title: "Run & Monitor"
+description: "Execute agent workflows, view real-time results per node, and inspect execution history."
 ---
 
 ## About

src/pages/docs/agent-playground/index.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Agent Playground: Visual Workflow Builder"
-description: "Design and run multi-step AI agent workflows on a drag-and-drop canvas. Chain LLM calls, embed sub-agents, version changes, and trace every execution."
+title: "Overview"
+description: "Build, test, and run multi-step AI workflows visually, no code required. Connect prompts, models, and agents on a drag-and-drop canvas."
 ---
 
 ## About

src/pages/docs/annotations/concepts/scores.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Scores: Unified Data Model"
-description: "Understand the Score model — the unified annotation primitive storing label values, annotator, source type, and queue context across all entity types."
+title: "Scores"
+description: "Understand the Score model -- the unified annotation primitive that stores labels, values, and metadata across all source types."
 ---
 
 ## About

src/pages/docs/annotations/features/add-items.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Add Items to Annotation Queues"
-description: "Add traces, spans, sessions, dataset rows, prototype runs, and simulation calls to annotation queues for structured human review in Future AGI."
+title: "Add Items to Queues"
+description: "Learn how to add traces, spans, sessions, dataset rows, prototypes, and simulation calls to annotation queues."
 ---
 
 ## About

src/pages/docs/annotations/features/analytics.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Analytics & IAA Metrics"
-description: "Track queue progress, annotator throughput, label distribution, and inter-annotator agreement using Cohen's and Fleiss' Kappa metrics."
+title: "Analytics & Agreement"
+description: "Track annotation progress, annotator performance, label distribution, and inter-annotator agreement metrics."
 ---
 
 ## About

src/pages/docs/annotations/features/annotate.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotate Items in the Workspace"
-description: "Use the annotation workspace to label traces, sessions, and datasets with categorical, numeric, star, and thumbs inputs plus keyboard shortcuts."
+title: "Annotate Items"
+description: "Complete guide to the annotation workspace -- label inputs, keyboard shortcuts, navigation, instructions, and completion workflow."
 ---
 
 ## About

src/pages/docs/annotations/features/automation.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Automation Rules"
-description: "Create condition-based rules to automatically add matching traces, spans, or sessions to annotation queues without manual curation."
+title: "Automation Rules"
+description: "Set up rules to automatically add items to queues or pre-fill annotations based on conditions."
 ---
 
 ## About

src/pages/docs/annotations/features/export.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Export Annotations to Dataset or File"
-description: "Export completed annotation queue results to a Future AGI dataset or download as JSON/CSV for fine-tuning, evaluation, and offline analysis."
+title: "Export Annotations"
+description: "Export completed annotations as datasets (JSON/CSV) for fine-tuning, evaluation, or analysis."
 ---
 
 ## About

src/pages/docs/annotations/features/inline.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Inline Annotations: Ad-Hoc Feedback"
-description: "Score traces, sessions, dataset rows, and prototype runs directly from their detail views without setting up an annotation queue."
+title: "Inline Annotations"
+description: "Annotate traces, spans, sessions, and prototypes directly from their detail views without using queues."
 ---
 
 ## About

src/pages/docs/annotations/features/labels.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Labels: 5 Types Explained"
-description: "Create and configure annotation labels: categorical, numeric, text, star rating, and thumbs up/down. Reusable across all queues in your organization."
+title: "Labels"
+description: "Create, configure, and manage annotation labels. Understand the five label types and when to use each."
 ---
 
 ## About

src/pages/docs/annotations/features/queues.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Queues: Setup & Management"
-description: "Create annotation queues with round-robin or load-balanced assignment, multi-annotator support, reservation timeouts, and review workflows."
+title: "Queues"
+description: "Create and manage annotation queues: assignment strategies, multi-annotator support, review workflows, and queue lifecycle."
 ---
 
 ## About

src/pages/docs/annotations/index.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotations: Human-in-the-Loop Feedback"
-description: "Capture human feedback on AI outputs using labels, queues, and scores across traces, spans, sessions, datasets, prototypes, and simulations."
+title: "Annotations"
+description: "Add human feedback to your AI outputs with annotation labels, queues, and scores across traces, datasets, prototypes, and simulations."
 ---
 
 ## About

src/pages/docs/annotations/quickstart.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotations Quickstart: Label & Queue"
-description: "Create an annotation label, set up a queue, add traces, and annotate your first item in 5 minutes with this Future AGI walkthrough."
+title: "Quickstart"
+description: "Get started with annotations in 5 minutes -- create a label, set up a queue, add items, and start annotating."
 ---
 
 ## What you will do

src/pages/docs/annotations/sdk/annotation-queue-using-sdk.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotation Queues via Python SDK"
-description: "Create queues, manage labels, add items, submit annotations, track progress, and export results programmatically with the Future AGI Python SDK."
+title: "Annotation Queue Using SDK"
+description: "Create and manage annotation queues programmatically using the Future AGI Python SDK."
 ---
 
 Annotation queues let you organize traces, sessions, datasets, and simulation outputs for structured human review. Using the SDK, you can:

src/pages/docs/annotations/sdk/javascript.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotations JavaScript & TypeScript SDK"
-description: "Log annotations, manage queues, submit scores, and export results using the FutureAGI JavaScript/TypeScript SDK's Annotation and AnnotationQueue classes."
+title: "JavaScript SDK"
+description: "Annotate traces and manage annotation queues programmatically using the FutureAGI JavaScript/TypeScript SDK."
 ---
 
 # JavaScript SDK

src/pages/docs/annotations/sdk/python.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Annotations Python SDK: Log & Manage"
-description: "Log annotations via DataFrame, retrieve labels, list projects, and submit human feedback to traces using the FutureAGI Python SDK."
+title: "Python SDK"
+description: "Annotate traces and manage annotation queues programmatically using the FutureAGI Python SDK."
 ---
 
 # Python SDK

src/pages/docs/api/agent-definitions/createagentdefinition.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Create Agent Definition"
-description: "Create a new agent definition and its initial version. Accepts agent type, name, provider, API key, and system prompt. Returns the created agent object."
+description: "Creates a new agent definition along with its first version."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-definitions/deleteagentdefinitions.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Delete Agent Definitions"
-description: "Bulk soft-delete one or more agent definitions and all associated versions. Accepts a list of agent UUIDs and returns a count of agents updated."
+description: "Bulk soft-deletes one or more agent definitions and their associated versions."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-definitions/fetchassistantfromprovider.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Fetch Assistant from Provider"
-description: "Fetch an assistant's name and system prompt from an external voice provider such as Vapi. Requires assistant ID, API key, and provider name."
+description: "Fetches assistant name and system prompt from an external voice provider."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-definitions/getagentdefinition.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Get Agent Definition"
-description: "Retrieve a specific agent definition by UUID, including its full version history, provider details, and configuration snapshot."
+description: "Retrieves a specific agent definition with all its versions."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-definitions/listagentdefinitions.mdx

@@ -1,6 +1,6 @@
 ---
 title: "List Agent Definitions"
-description: "Return a paginated list of agent definitions. Filter by agent type, search by name or assistant ID, and pin a specific agent to the top of results."
+description: "Returns a paginated list of agent definitions with optional search and filtering."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-versions/createagentversion.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Create Agent Version"
-description: "Create a new version of an agent definition. Accepts agent name, language, system prompt, commit message, and provider config. Returns the new version object."
+description: "Creates a new version of an agent definition."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-versions/getagentversion.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Get Agent Version"
-description: "Retrieve a specific agent version by agent UUID and version UUID, including its full configuration snapshot, prompt, and provider settings."
+description: "Retrieves a specific version of an agent definition with its configuration snapshot."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-versions/getversioncallexecutions.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Get Version Call Executions"
-description: "Retrieve paginated call executions and their evaluation results for a specific agent version. Supports limit and page query parameters."
+description: "Retrieves paginated call executions with evaluation results for an agent version."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-versions/getversionevalsummary.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Get Version Eval Summary"
-description: "Retrieve aggregated evaluation summary statistics for an agent version, including pass rate, fail count, and error count per eval metric."
+description: "Retrieves evaluation summary statistics for an agent version."
 ---
 
 <ApiPlayground

src/pages/docs/api/agent-versions/listagentversions.mdx

@@ -1,6 +1,6 @@
 ---
 title: "List Agent Versions"
-description: "Retrieve a paginated list of all versions for a given agent definition. Supports limit and page parameters. Returns version metadata and commit history."
+description: "Retrieves a paginated list of versions for an agent definition."
 ---
 
 <ApiPlayground

src/pages/docs/api/annotations/bulk/bulk-annotate-spans.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Bulk Annotate Spans"
-description: "Submit label scores and notes for multiple observation spans in one request. Accepts an array of span IDs with their annotation values and score sources."
+description: "Submit annotations and notes for multiple observation spans in a single request."
 ---
 
 <ApiPlayground

src/pages/docs/api/annotations/items/add-items.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Add Items to Annotation Queue"
-description: "Add one or more source items (traces, spans) to an annotation queue in bulk. Accepts queue UUID and an array of source type and source ID pairs."
+title: "Add Items to Queue"
+description: "Add source items to an annotation queue in bulk."
 ---
 
 <ApiPlayground

src/pages/docs/api/annotations/items/assign-items.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Assign Queue Items to Annotator"
-description: "Assign one or more annotation queue items to specific annotators. Accepts queue UUID, a list of item UUIDs, and a list of user UUIDs to assign."
+title: "Assign Items"
+description: "Assign queue items to a specific annotator."
 ---
 
 <ApiPlayground

src/pages/docs/api/annotations/items/bulk-remove-items.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Bulk Remove Queue Items"
-description: "Remove multiple items from an annotation queue in a single request. Accepts the queue UUID and an array of item UUIDs to delete from the queue."
+title: "Bulk Remove Items"
+description: "Remove multiple items from an annotation queue at once."
 ---
 
 <ApiPlayground