Add compact video agent API responses

[devhims]

Changes

Agent run responses currently repeat identities and return detailed citations and artifacts alongside the answer. Add an opt-in responseFormat=compact to admission and polling so clients receive the answer, deduplicated numbered sources, warnings, outcome, and top-level billing.

• Convert persisted citation markers to [1] references in first-use order, combining adjacent references to the same video. Reuse stored video titles where available.
• Distinguish answered, partial, insufficient_evidence, and needs_clarification from execution status.
• Expose excerpts, artifacts, and execution metadata only when requested with include=evidence,artifacts,diagnostics.
• Keep the existing format as the default. Format selection applies per HTTP request and does not change execution, idempotency, stored evidence, or billing.
• Update OpenAPI and Postman testing instructions.

This changes response serialization only. Internal transcript analysis and exact citation validation remain. Session restoration retains its existing format. Historical outcomes rely on persisted warnings; older runs without NO_CONTENT_EVIDENCE cannot always distinguish unavailable content from other partial results.

Validation

• 355 unit tests across 51 files passed, including response transformation, outcomes, optional details, legacy compatibility, and request validation.
• Platform TypeScript build, generated docs checks, Mintlify validation under Node LTS, and diff checks passed.
• Local HTTP checks against previously completed GLM research and inspect runs verified source references, retained evidence, unchanged legacy results, and billing. No new model runs were needed for this serialization change.
• The saved four-video research response is approximately 2.4 KB in compact form; detailed evidence remains available on request.

The broader web build could not complete locally because Turbopack encountered a port-binding permission error. CI should verify that build. No production deployment has been performed for this change.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
video2ctx	🟢 Ready	View Preview	Sep 5, 2026, 6:07 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
video2ctx-web	Ready	Preview	Sep 5, 2026 6:07pm UTC