Production-ready animations, transitions, backgrounds, and scenes for Remotion
TypeScript ai-agentsclaude-codedemo-videomcpmcp-servermodel-context-protocolmotion-designproduct-demoreactremotionshadcnvideo
/**
* What the search analytics may say about a query without quoting it, and who
* is asking. Pure and shared: the docs search dialog (client) and the MCP and
* API handlers (server) describe a search with the same fields, so one chart
* can split any of them by `actor`.
*/
export type SearchActor = "human" | "agent";
/** Where the search came from: the ⌘K dialog, an MCP tool call, or a direct call to `/api/search`. */
export type SearchSurface = "docs_dialog" | "mcp" | "api";
export type QueryScript = "latin" | "cyrillic" | "cjk" | "other" | "mixed";
/** Longest query text an event carries; the rest of a pasted paragraph is noise. */
export const MAX_LOGGED_QUERY = 200;
export interface QueryShape {
query_words: number;
query_chars: number;
/** Writing system, as a stand-in for language: tells how much non-English search there is. */
query_script: QueryScript;
}
const SCRIPTS: [QueryScript, RegExp][] = [
["latin", /\p{Script=Latin}/u],
["cyrillic", /\p{Script=Cyrillic}/u],
[
"cjk",
/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u,
],
];
export function describeQuery(query: string): QueryShape {
const text = query.trim();
const found = SCRIPTS.filter(([, pattern]) => pattern.test(text)).map(
([script]) => script,
);
return {
query_words: text ? text.split(/\s+/).length : 0,
query_chars: text.length,
query_script: found.length > 1 ? "mixed" : (found[0] ?? "other"),
};
}
export function loggedQuery(query: string): string {
return query.trim().slice(0, MAX_LOGGED_QUERY);
}
/**
* Which program is calling, from its User-Agent. A best guess for grouping:
* clients name themselves freely and most MCP hosts send whatever their HTTP
* library sends, so `script` and `other` are large buckets by nature.
*/
const AGENT_CLIENTS: [string, RegExp][] = [
["codex", /codex/i],
["claude", /claude|anthropic/i],
["chatgpt", /chatgpt|openai|oai-/i],
["cursor", /cursor/i],
["vscode", /vscode|visual studio code|copilot/i],
["windsurf", /windsurf|codeium/i],
["gemini", /gemini|google/i],
["perplexity", /perplexity/i],
["mistral", /mistral/i],
[
"script",
/node|undici|bun\/|deno|python|httpx|aiohttp|go-http|curl|wget|axios|okhttp/i,
],
["browser", /mozilla/i],
];
export function classifyAgentClient(userAgent: string): string {
if (!userAgent.trim()) return "unknown";
return (
AGENT_CLIENTS.find(([, pattern]) => pattern.test(userAgent))?.[0] ?? "other"
);
}
/**
* Browsers an agent drives report themselves in one of two ways: the
* automation flag (`navigator.webdriver`) or a product token in the
* User-Agent. An agent that drives an ordinary browser with an ordinary
* User-Agent leaves neither and is counted as a human.
*/
const AGENT_BROWSER = /Claude-Agent|Google-Agent|ChatGPT-Agent|HeadlessChrome/i;
export function browserActor(
userAgent: string,
webdriver: boolean,
): SearchActor {
return webdriver || AGENT_BROWSER.test(userAgent) ? "agent" : "human";
}