APEX
GASupervisor copilot. 21 specialist agents. ~165 graph-grounded tools. MCP-native.
What it is
APEX for Product Graph is Pyramyd's product-wide AI assistant. It is built on CopilotKit v2 in the browser (chat shell, frontend tools, suggestions, generative UI, suspendable HITL, agent state) and Mastra on the server (supervisor agent, 21 specialist agents, ~165 tools, workflows, scorers, observability, inline vector store, GraphRAG, working memory). Every Studio tab and every Product Graph page mounts a per-surface `CopilotBridge` that registers the tools the AI can execute on the current screen, and a safe-context store routes every tool registration through telemetry and a tool-discoverability popover (`ApexToolsPopover`, ⌘/Ctrl+K). The supervisor delegates to specialists via `delegate_to_*` tools; AG-UI `STATE_SNAPSHOT` events stream working memory back into the chat surface (plans, focus, active workflow) so the user can watch the agent think. APEX uses inline embeddings (HNSW on source rows) for RAG, GraphRAG for relationship-aware retrieval, and supports headless invocation via `APEX_HEADLESS_PROMPT_EVENT` so any UI button can drop a pre-filled prompt into the chat.
Top 5 capabilities
Each capability is the parent of dozens of typed features in the production taxonomy. Hover any feature in Studio to drill into the underlying nodes.
80 features
Domain Mastra for Product Graph covers domain tools that live in `platform/apex/mastra/tools/*-tools.ts` and cover CRUD and analytics for Segments, ICPs, Portfolio items, ML Models, Onboarding flows, Stored Prompts, Connected Integrations, Platform Issues, and Product Graph Knowledge Base content. Grouped here rather than in a separate capability per domain because they share the same shape: list/get/create/update/delete + a few domain-specific verbs.
26 features
Product Graph Page Bridges for Product Graph covers outside of Studio, every Product Graph page (Alerts, Competition, Customer, Ecosystem, Investors, Market, Portfolio, Product, Projects, Reports, Reviews, Roadmaps, RFX, Segments, Settings, Team, Integrations, AI Interview, etc.) mounts its own `*CopilotBridge` to register navigation, CRUD, and selection tools. Each bridge is paired with a host page via plain props and an `onSelect*` callback wired into `router.push`.
21 features
Frontend Action Hooks for Product Graph covers global action hooks (`useBattlecardActions`, `usePortfolioActions`, `useCanvasActions`, `useDocumentActions`, `useGraphActions`, etc.) live in `platform/apex/chatbot/actions/` and `products/2.0-graph/*/use*Actions.ts`. Each hook bundles a set of related frontend tools (create/update/delete/navigate) and is mounted once in `CopilotCanvas` so the supervisor agent can invoke them from anywhere in the app, not just when the user is on the matching page.
20 features
Headless API and Embeds for Product Graph covers beyond the chat shell, APEX exposes several non-UI entry points: a headless client (`headless/client.ts`) for invoking the agent from non-chat code; an `APEX_HEADLESS_PROMPT_EVENT` event channel so any button can prefill a chat; an MCP apps registry (`mcp-apps/registry`) connecting external MCP servers; the Usertour-driven onboarding registry; the NLU model for intent classification; a tool-guard safety layer; diagnostics capture; and the CopilotKit runtime route (`api/copilotkit/api.ts`).
20 features
Specialist Agents for Product Graph covers each specialist is a `new Agent({ … })` with a domain-specific system prompt, a curated tool subset, and (for some) attached scorers. The supervisor decides when to delegate. Specialists return structured output the supervisor can fold into its own response. Defined in `platform/apex/mastra/agents/`.
30-minute walkthrough. We'll filter the workspace to your category and walk through the top capabilities live.
