The Open Framework for Building Agents
feat(docs): add Mux video template and extension (#2688)
vercel-gh-bot-3[bot]9557caef94d8
diff --git a/apps/docs/app/[lang]/templates/integration-icons.tsx b/apps/docs/app/[lang]/templates/integration-icons.tsxindex fcdb3b609..d524c41fb 100644--- a/apps/docs/app/[lang]/templates/integration-icons.tsx+++ b/apps/docs/app/[lang]/templates/integration-icons.tsx@@ -4,6 +4,7 @@ import {datadogLogo,githubLogo,linearLogo,+ muxLogo,notionLogo,resendLogo,sanityLogo,@@ -22,6 +23,7 @@ export const integrationIcons: Record<TemplateIntegration, IconComponent> = {GitHub: githubLogo,"HTTP API": BracesIcon,Linear: linearLogo,+ Mux: muxLogo,Notion: notionLogo,Resend: resendLogo,Sanity: sanityLogo,diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex fb1a53843..6609ef902 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -1228,6 +1228,55 @@ The filename supplies the \`blitzreels\` namespace. The extension adds project,Source imports, clipping, generation, and exports call the configured BlitzReels API. Credit-spending, download, and render tools require eve approval by default, and durable retries reuse the original call receipt instead of spending twice. Override an individual tool from a directory mount when it needs stricter \`always()\` approval, or use \`disableTool()\` to remove it.See the [BlitzReels extension package](https://www.npmjs.com/package/@blitzreels/eve) for the complete tool list, configuration, approval defaults, error contract, and OAuth-backed MCP alternative.`,+ },+ "mux-video": {+ logo: "mux",+ docsHref: "https://github.com/muxinc/mux-video-agent/tree/main/packages/eve-video",+ keywords: [+ "video",+ "video assets",+ "clips",+ "captions",+ "subtitles",+ "Mux Robots",+ "summarization",+ "moderation",+ "translation",+ "chapters",+ ],+ install: `The Mux Video extension currently ships from source with the Mux Video Agent template. Clone the repository and install its workspace dependencies:++\`\`\`bash+git clone https://github.com/muxinc/mux-video-agent.git+cd mux-video-agent+pnpm install+\`\`\`++The extension requires Node.js 24 or later. The reusable package lives at \`packages/eve-video\` and is mounted by the root agent.`,+ quickStart: `Add your Mux access token to the template's environment:++\`\`\`bash title=".env.local"+MUX_TOKEN_ID=mux_token_id_here+MUX_TOKEN_SECRET=mux_token_secret_here+\`\`\`++The template mounts the extension under \`agent/extensions/\`:++\`\`\`ts title="agent/extensions/mux_video.ts"+import muxVideo from "@mux/eve-video";++export default muxVideo({+ tokenId: process.env.MUX_TOKEN_ID,+ tokenSecret: process.env.MUX_TOKEN_SECRET,+});+\`\`\`++The filename supplies the \`mux_video\` namespace. The extension adds tools such as \`mux_video__get_asset\`, \`mux_video__create_asset\`, \`mux_video__create_clip\`, \`mux_video__run_workflow\`, and \`mux_video__get_workflow_job\`.`,+ configure: `Use a Mux access token with Video access and access to the Mux Robots workflows you plan to run. Keep the token ID and secret in the environment rather than prompts, tool arguments, or source control.++Asset creation, clip creation, and Mux Robots workflow creation require explicit human approval by default. Robots jobs are asynchronous, so start a workflow with \`mux_video__run_workflow\`, retain the returned job ID, and check it with \`mux_video__get_workflow_job\`.++The extension supports creating and inspecting assets, exact-range clips, subtitles, captions, summaries, questions, chapters, scenes, key moments, thumbnails, moderation, and caption translation or editing. It intentionally excludes multimodal embeddings and semantic video search. See the [Mux Video Agent repository](https://github.com/muxinc/mux-video-agent) for the source, full capability list, deployment steps, and eval suite.`,},browserbase: {logo: "browserbase",diff --git a/apps/docs/lib/integrations/discovery.test.ts b/apps/docs/lib/integrations/discovery.test.tsindex b12ec2061..1da1032a3 100644--- a/apps/docs/lib/integrations/discovery.test.ts+++ b/apps/docs/lib/integrations/discovery.test.ts@@ -86,6 +86,19 @@ describe("integration discovery", () => {expect(integrationSearchText(blitzreels!)).toContain("video editing");});+ it("renders the Mux Video extension setup", () => {+ const muxVideo = getIntegration("mux-video");+ expect(muxVideo).toBeDefined();++ const markdown = integrationMarkdown(muxVideo!);+ expect(markdown).toContain("github.com/muxinc/mux-video-agent.git");+ expect(markdown).toContain('import muxVideo from "@mux/eve-video"');+ expect(markdown).toContain("MUX_TOKEN_ID");+ expect(markdown).toContain("mux_video__run_workflow");+ expect(markdown).toContain("require explicit human approval");+ expect(integrationSearchText(muxVideo!)).toContain("Mux Robots");+ });+it("renders the Jetty extension and eval reporter setup", () => {const jetty = getIntegration("jetty");expect(jetty).toBeDefined();diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsxindex dc369282b..6f6354217 100644--- a/apps/docs/lib/integrations/logos.tsx+++ b/apps/docs/lib/integrations/logos.tsx@@ -621,6 +621,15 @@ export const blitzreelsLogo = (props: LogoProps) => (</svg>);+export const muxLogo = (props: LogoProps) => (+ <svg fill="currentColor" viewBox="0 0 1600 500" xmlns="http://www.w3.org/2000/svg" {...props}>+ <path+ d="M994.287 93.486c-17.121 0-31-13.879-31-31 0-17.121 13.879-31 31-31 17.121 0 31 13.879 31 31 0 17.121-13.879 31-31 31m0-93.486c-34.509 0-62.484 27.976-62.484 62.486v187.511c0 68.943-56.09 125.033-125.032 125.033s-125.03-56.09-125.03-125.033V62.486C681.741 27.976 653.765 0 619.256 0s-62.484 27.976-62.484 62.486v187.511C556.772 387.85 668.921 500 806.771 500c137.851 0 250.001-112.15 250.001-250.003V62.486c0-34.51-27.976-62.486-62.485-62.486M1537.51 468.511c-17.121 0-31-13.879-31-31 0-17.121 13.879-31 31-31 17.121 0 31 13.879 31 31 0 17.121-13.879 31-31 31m-275.883-218.509-143.33 143.329c-24.402 24.402-24.402 63.966 0 88.368 24.402 24.402 63.967 24.402 88.369 0l143.33-143.329 143.328 143.329c24.402 24.4 63.967 24.402 88.369 0 24.403-24.402 24.403-63.966.001-88.368l-143.33-143.329.001-.004 143.329-143.329c24.402-24.402 24.402-63.965 0-88.367s-63.967-24.402-88.369 0L1349.996 161.63 1206.667 18.302c-24.402-24.401-63.967-24.402-88.369 0s-24.402 63.965 0 88.367l143.329 143.329v.004ZM437.511 468.521c-17.121 0-31-13.879-31-31 0-17.121 13.879-31 31-31 17.121 0 31 13.879 31 31 0 17.121-13.879 31-31 31M461.426 4.759C438.078-4.913 411.2.432 393.33 18.303L249.999 161.632 106.669 18.303C88.798.432 61.922-4.913 38.573 4.759 15.224 14.43-.001 37.214-.001 62.488v375.026c0 34.51 27.977 62.486 62.487 62.486 34.51 0 62.486-27.976 62.486-62.486V213.341l80.843 80.844c24.404 24.402 63.965 24.402 88.369 0l80.843-80.844v224.173c0 34.51 27.976 62.486 62.486 62.486s62.486-27.976 62.486-62.486V62.488c0-25.274-15.224-48.058-38.573-57.729"+ fillRule="nonzero"+ />+ </svg>+);+export const browserbaseLogo = (props: LogoProps) => (<svg fill="none" viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg" {...props}><rect fill="white" height="124" width="134" x="30" y="36" />@@ -827,6 +836,7 @@ export const logos = {messenger: messengerLogo,x: xLogo,blitzreels: blitzreelsLogo,+ mux: muxLogo,browserbase: browserbaseLogo,jetty: jettyLogo,"agent-browser": agentBrowserLogo,diff --git a/apps/docs/lib/templates/manifest.ts b/apps/docs/lib/templates/manifest.tsindex efc1ad67c..a94d57335 100644--- a/apps/docs/lib/templates/manifest.ts+++ b/apps/docs/lib/templates/manifest.ts@@ -8,6 +8,7 @@ export type TemplateIntegration =| "GitHub"| "HTTP API"| "Linear"+ | "Mux"| "Notion"| "Resend"| "Sanity"@@ -315,6 +316,32 @@ export const templateManifest: TemplateManifestEntry[] = ["agent/tools/lint_against_style.ts",],},+ {+ slug: "mux-video-agent",+ title: "Mux video",+ setupPrompt:+ "Set up the Mux Video Agent template in my current workspace using https://github.com/muxinc/mux-video-agent as the source. Copy the project files, install its dependencies, and follow the repository README to configure it. Preserve the existing project if the workspace is not empty, and tell me about the required Mux credentials, AI Gateway setup, and manual deployment steps.",+ description:+ "A durable video agent that creates and inspects Mux assets, makes clips, and runs supported Mux Robots workflows with human approval for write actions.",+ sourceHref: "https://github.com/muxinc/mux-video-agent",+ category: "Example",+ model: "openai/gpt-5.6-luna",+ integrations: ["Mux"],+ source: "GitHub",+ github: { owner: "muxinc", repo: "mux-video-agent", ref: "main" },+ files: [+ "agent/agent.ts",+ "agent/channels/eve.ts",+ "agent/extensions/mux_video.ts",+ "agent/instructions.md",+ "packages/eve-video/extension/extension.ts",+ "packages/eve-video/extension/instructions.md",+ "packages/eve-video/extension/skills/workflows/SKILL.md",+ "packages/eve-video/extension/tools/create_asset.ts",+ "packages/eve-video/extension/tools/create_clip.ts",+ "packages/eve-video/extension/tools/run_workflow.ts",+ ],+ },{slug: "weather-agent-fixture",title: "Weather",diff --git a/packages/eve-catalog/src/index.test.ts b/packages/eve-catalog/src/index.test.tsindex 4a08c4fa4..55f9a1054 100644--- a/packages/eve-catalog/src/index.test.ts+++ b/packages/eve-catalog/src/index.test.ts@@ -149,6 +149,13 @@ describe("integration catalog", () => {});});+ it("exposes Mux Video as a gallery-only extension", () => {+ expect(getIntegrationEntry("mux-video")).toMatchObject({+ kind: "extension",+ surfaces: { scaffoldable: false, registry: false, gallery: true },+ });+ });+it("exposes GitHub Tools as an extension distinct from the GitHub channel", () => {expect(getIntegrationEntry("github")?.kind).toBe("channel");expect(getIntegrationEntry("github-tools")?.kind).toBe("extension");diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex 070c53fe4..1dd093121 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -290,6 +290,13 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [tagline: "Turn long videos into short clips, generate media, repair edits, and export.",surfaces: { scaffoldable: false, registry: true, gallery: true },},+ {+ slug: "mux-video",+ name: "Mux Video",+ kind: "extension",+ tagline: "Create and inspect video assets, make clips, and run Mux Robots workflows.",+ surfaces: { scaffoldable: false, registry: false, gallery: true },+ },{slug: "browserbase",name: "Browserbase",