Skip to content

Automate browser based workflows with AI

docs: serve documentation media from jsDelivr (SKY-12977) (#7722)

Suchintand064e71ff31f
diff --git a/docs/cookbooks/healthcare-portal-data.mdx b/docs/cookbooks/healthcare-portal-data.mdx
index 974e419ec..652b01107 100644
--- a/docs/cookbooks/healthcare-portal-data.mdx
+++ b/docs/cookbooks/healthcare-portal-data.mdx
@@ -125,7 +125,7 @@ Log in once, save the browser state as a profile, and skip login on future runs.
muted
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/workflow-start.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/1dcbdffcdff31b8a67458ed3b64fe1d17f17f6b3c10b18bfbde92a75391daab0-workflow-start.mp4"
></video>
</Frame>
</Step>
@@ -524,7 +524,7 @@ A [Browser Profile](/developers/optimization/browser-profiles) is a saved snapsh
muted
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/browser-session-create.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/3c68f88cf30fe223cc7dfe2edd90e03054377d702b1c619e65cfef3c064efe41-browser-session-create.mp4"
></video>
</Frame>
</Step>
@@ -721,7 +721,7 @@ OpenEMR can timeout or show session-expired pages. Use `error_code_mapping` on a
muted
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/navigation-error-messages.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/dd90d50875e60e6a99319157683bfc61a227db9772018eccde3c31ff039f2f3e-navigation-error-messages.mp4"
></video>
</Frame>
diff --git a/docs/developers/credentials/handle-2fa.mdx b/docs/developers/credentials/handle-2fa.mdx
index 1381b3ee3..36d278de3 100644
--- a/docs/developers/credentials/handle-2fa.mdx
+++ b/docs/developers/credentials/handle-2fa.mdx
@@ -153,7 +153,7 @@ This setup requires a Zapier Pro plan account.
loop
playsInline
className="rounded-xl"
- src="/images/zapier-forwarding-setup.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/authentication/39a279a5540ad3aeed3717a9fb307c4fb2d0eac61a462b91320b44f54a4bd60b-zapier-forwarding-setup.mp4"
></video>
</Frame>
diff --git a/docs/developers/debugging/observability-with-laminar.mdx b/docs/developers/debugging/observability-with-laminar.mdx
index 8e4d16463..898fd4700 100644
--- a/docs/developers/debugging/observability-with-laminar.mdx
+++ b/docs/developers/debugging/observability-with-laminar.mdx
@@ -65,7 +65,7 @@ LMNR_PROJECT_API_KEY=your-laminar-api-key
muted
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/laminar-keys.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/observability/f2d0b8714b6e6ec3b0b50d9a6e3384897a1d093f47c0542c9d6e1dc69b3fddee-laminar-keys.mp4"
></video>
</Frame>
diff --git a/docs/developers/getting-started/quickstart.mdx b/docs/developers/getting-started/quickstart.mdx
index 2080112d9..9fb3399f4 100644
--- a/docs/developers/getting-started/quickstart.mdx
+++ b/docs/developers/getting-started/quickstart.mdx
@@ -216,7 +216,7 @@ skyvern init
```
<p align="center">
- <img src="/images/skyvern-init.gif" alt="Skyvern init interactive setup wizard" />
+ <img src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/quickstart/8d8dc46d95f62f20c9ee6e433a1dcca0e2bb7b074fe93a2d56bc4fcd7ac85d4a-skyvern-init.gif" alt="Skyvern init interactive setup wizard" />
</p>
@@ -302,7 +302,7 @@ A browser window will open on your machine (if you chose headful mode). Recordin
If you also selected Claude Code during setup, start your local frontend dev server and run `/qa http://localhost:3000` in Claude Code to validate the app against your local environment.
<video style={{ aspectRatio: '16 / 9', width: '100%' }} controls>
- <source src="/images/skyvern-agent-local.mp4" type="video/mp4" />
+ <source src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/quickstart/56f8b625b7ac6324f44e76fb13c14ebd546350ee97aa3ba76bceec62f579dc15-skyvern-agent-local.mp4" type="video/mp4" />
</video>
---
diff --git a/docs/images/browser-session-create.mp4 b/docs/images/browser-session-create.mp4
deleted file mode 100644
index e4510bbf3..000000000
Binary files a/docs/images/browser-session-create.mp4 and /dev/null differ
diff --git a/docs/images/laminar-keys.mp4 b/docs/images/laminar-keys.mp4
deleted file mode 100644
index 0d596719d..000000000
Binary files a/docs/images/laminar-keys.mp4 and /dev/null differ
diff --git a/docs/images/make/make1.mp4 b/docs/images/make/make1.mp4
deleted file mode 100644
index 4065f19a8..000000000
Binary files a/docs/images/make/make1.mp4 and /dev/null differ
diff --git a/docs/images/make/make2.mp4 b/docs/images/make/make2.mp4
deleted file mode 100644
index 87aa234d3..000000000
Binary files a/docs/images/make/make2.mp4 and /dev/null differ
diff --git a/docs/images/n8n/n8n1.mp4 b/docs/images/n8n/n8n1.mp4
deleted file mode 100644
index ed76e2697..000000000
Binary files a/docs/images/n8n/n8n1.mp4 and /dev/null differ
diff --git a/docs/images/navigation-error-messages.mp4 b/docs/images/navigation-error-messages.mp4
deleted file mode 100644
index 9957d8d8b..000000000
Binary files a/docs/images/navigation-error-messages.mp4 and /dev/null differ
diff --git a/docs/images/skyvern-agent-local.mp4 b/docs/images/skyvern-agent-local.mp4
deleted file mode 100644
index 8644c824d..000000000
Binary files a/docs/images/skyvern-agent-local.mp4 and /dev/null differ
diff --git a/docs/images/skyvern-init.gif b/docs/images/skyvern-init.gif
deleted file mode 100644
index aa003e679..000000000
Binary files a/docs/images/skyvern-init.gif and /dev/null differ
diff --git a/docs/images/workflow-start.mp4 b/docs/images/workflow-start.mp4
deleted file mode 100644
index 5ae8f9e7e..000000000
Binary files a/docs/images/workflow-start.mp4 and /dev/null differ
diff --git a/docs/images/zapier-forwarding-setup.mp4 b/docs/images/zapier-forwarding-setup.mp4
deleted file mode 100644
index 5de110a11..000000000
Binary files a/docs/images/zapier-forwarding-setup.mp4 and /dev/null differ
diff --git a/docs/images/zapier/zap1.mp4 b/docs/images/zapier/zap1.mp4
deleted file mode 100644
index 14fdfa94f..000000000
Binary files a/docs/images/zapier/zap1.mp4 and /dev/null differ
diff --git a/docs/images/zapier/zap2.mp4 b/docs/images/zapier/zap2.mp4
deleted file mode 100644
index 03c0a043b..000000000
Binary files a/docs/images/zapier/zap2.mp4 and /dev/null differ
diff --git a/docs/integrations/make.mdx b/docs/integrations/make.mdx
index f75d798e6..c56b3121a 100644
--- a/docs/integrations/make.mdx
+++ b/docs/integrations/make.mdx
@@ -37,7 +37,7 @@ Connect Skyvern to 2,000+ apps through Make. Trigger browser automations from an
loop
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/make/make1.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/make/4a6af7c02a875f43863583e5929368f0a1783a8f2457690b6a2b359343197627-make1.mp4"
></video>
</Frame>
</Step>
@@ -52,7 +52,7 @@ Connect Skyvern to 2,000+ apps through Make. Trigger browser automations from an
loop
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/make/make2.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/make/4220a02d47007e40468b5d2356b3ed8c53603e89532b88835572aded35e582dd-make2.mp4"
></video>
</Frame>
</Step>
diff --git a/docs/integrations/n8n.mdx b/docs/integrations/n8n.mdx
index fac415df8..390989576 100644
--- a/docs/integrations/n8n.mdx
+++ b/docs/integrations/n8n.mdx
@@ -34,7 +34,7 @@ Connect Skyvern to n8n's open-source automation platform. Trigger browser automa
loop
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/n8n/n8n1.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/n8n/2248b0eb8f8dfadd4196478712f8fb65de1ef2544cf6f513d9c7ec3c9f4f119e-n8n1.mp4"
></video>
</Frame>
</Step>
diff --git a/docs/integrations/zapier.mdx b/docs/integrations/zapier.mdx
index 39165d8bd..ca1bdae20 100644
--- a/docs/integrations/zapier.mdx
+++ b/docs/integrations/zapier.mdx
@@ -40,7 +40,7 @@ Connect Skyvern to 7,000+ apps through Zapier. Trigger browser automations from
loop
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/zapier/zap1.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/zapier/06b4c3ca491de54d8f46625f29bc7e220a41f26690a7b83b498e5656b31d12b2-zap1.mp4"
></video>
</Frame>
</Step>
@@ -55,7 +55,7 @@ Connect Skyvern to 7,000+ apps through Zapier. Trigger browser automations from
loop
playsInline
className="w-full aspect-video rounded-xl"
- src="/images/zapier/zap2.mp4"
+ src="https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/zapier/8feb209615ef1199d75cb94844f5ad9b6ec0d31c5e5a91344615810801bd522b-zap2.mp4"
></video>
</Frame>
</Step>
diff --git a/docs/media-cdn-manifest.md b/docs/media-cdn-manifest.md
new file mode 100644
index 000000000..5f6973f03
--- /dev/null
+++ b/docs/media-cdn-manifest.md
@@ -0,0 +1,140 @@
+# Documentation media CDN manifest
+
+Skyvern's large public-documentation media is stored in
+[`Skyvern-AI/skyvern-docs-media`](https://github.com/Skyvern-AI/skyvern-docs-media) and served through
+jsDelivr. References must use content-addressed filenames and the full immutable media commit
+`383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a`.
+
+## Published assets
+
+### `docs/images/skyvern-agent-local.mp4`
+
+- Original: SHA-256 `6da40c69458f7ea9dd3bc697d6dca7f790b632a4ef165eb68ee70189c7ec756e`, 21,492,235 bytes
+- Hosted path: `media/quickstart/56f8b625b7ac6324f44e76fb13c14ebd546350ee97aa3ba76bceec62f579dc15-skyvern-agent-local.mp4`
+- Hosted: SHA-256 `56f8b625b7ac6324f44e76fb13c14ebd546350ee97aa3ba76bceec62f579dc15`, 5,475,920 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/quickstart/56f8b625b7ac6324f44e76fb13c14ebd546350ee97aa3ba76bceec62f579dc15-skyvern-agent-local.mp4
+- Re-encode: H.264 CRF 18 with `yuv420p` and fast-start metadata. Duration (36.333333 seconds),
+ resolution (3840x1852), frame rate (15 fps), and absence of audio are preserved. Full-file quality
+ comparison: SSIM 0.999451, PSNR 56.692168 dB, and sampled VMAF 97.053543.
+
+### `docs/images/zapier-forwarding-setup.mp4`
+
+- Original: SHA-256 `39a279a5540ad3aeed3717a9fb307c4fb2d0eac61a462b91320b44f54a4bd60b`, 14,363,999 bytes
+- Hosted path: `media/authentication/39a279a5540ad3aeed3717a9fb307c4fb2d0eac61a462b91320b44f54a4bd60b-zapier-forwarding-setup.mp4`
+- Hosted: SHA-256 `39a279a5540ad3aeed3717a9fb307c4fb2d0eac61a462b91320b44f54a4bd60b`, 14,363,999 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/authentication/39a279a5540ad3aeed3717a9fb307c4fb2d0eac61a462b91320b44f54a4bd60b-zapier-forwarding-setup.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/skyvern-init.gif`
+
+- Original: SHA-256 `8d8dc46d95f62f20c9ee6e433a1dcca0e2bb7b074fe93a2d56bc4fcd7ac85d4a`, 9,345,750 bytes
+- Hosted path: `media/quickstart/8d8dc46d95f62f20c9ee6e433a1dcca0e2bb7b074fe93a2d56bc4fcd7ac85d4a-skyvern-init.gif`
+- Hosted: SHA-256 `8d8dc46d95f62f20c9ee6e433a1dcca0e2bb7b074fe93a2d56bc4fcd7ac85d4a`, 9,345,750 bytes, `image/gif`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/quickstart/8d8dc46d95f62f20c9ee6e433a1dcca0e2bb7b074fe93a2d56bc4fcd7ac85d4a-skyvern-init.gif
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/zapier/zap1.mp4`
+
+- Original: SHA-256 `06b4c3ca491de54d8f46625f29bc7e220a41f26690a7b83b498e5656b31d12b2`, 4,889,331 bytes
+- Hosted path: `media/integrations/zapier/06b4c3ca491de54d8f46625f29bc7e220a41f26690a7b83b498e5656b31d12b2-zap1.mp4`
+- Hosted: SHA-256 `06b4c3ca491de54d8f46625f29bc7e220a41f26690a7b83b498e5656b31d12b2`, 4,889,331 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/zapier/06b4c3ca491de54d8f46625f29bc7e220a41f26690a7b83b498e5656b31d12b2-zap1.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/zapier/zap2.mp4`
+
+- Original: SHA-256 `8feb209615ef1199d75cb94844f5ad9b6ec0d31c5e5a91344615810801bd522b`, 3,260,575 bytes
+- Hosted path: `media/integrations/zapier/8feb209615ef1199d75cb94844f5ad9b6ec0d31c5e5a91344615810801bd522b-zap2.mp4`
+- Hosted: SHA-256 `8feb209615ef1199d75cb94844f5ad9b6ec0d31c5e5a91344615810801bd522b`, 3,260,575 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/zapier/8feb209615ef1199d75cb94844f5ad9b6ec0d31c5e5a91344615810801bd522b-zap2.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/n8n/n8n1.mp4`
+
+- Original: SHA-256 `2248b0eb8f8dfadd4196478712f8fb65de1ef2544cf6f513d9c7ec3c9f4f119e`, 4,468,871 bytes
+- Hosted path: `media/integrations/n8n/2248b0eb8f8dfadd4196478712f8fb65de1ef2544cf6f513d9c7ec3c9f4f119e-n8n1.mp4`
+- Hosted: SHA-256 `2248b0eb8f8dfadd4196478712f8fb65de1ef2544cf6f513d9c7ec3c9f4f119e`, 4,468,871 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/n8n/2248b0eb8f8dfadd4196478712f8fb65de1ef2544cf6f513d9c7ec3c9f4f119e-n8n1.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/make/make1.mp4`
+
+- Original: SHA-256 `4a6af7c02a875f43863583e5929368f0a1783a8f2457690b6a2b359343197627`, 4,249,598 bytes
+- Hosted path: `media/integrations/make/4a6af7c02a875f43863583e5929368f0a1783a8f2457690b6a2b359343197627-make1.mp4`
+- Hosted: SHA-256 `4a6af7c02a875f43863583e5929368f0a1783a8f2457690b6a2b359343197627`, 4,249,598 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/make/4a6af7c02a875f43863583e5929368f0a1783a8f2457690b6a2b359343197627-make1.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/make/make2.mp4`
+
+- Original: SHA-256 `4220a02d47007e40468b5d2356b3ed8c53603e89532b88835572aded35e582dd`, 1,875,634 bytes
+- Hosted path: `media/integrations/make/4220a02d47007e40468b5d2356b3ed8c53603e89532b88835572aded35e582dd-make2.mp4`
+- Hosted: SHA-256 `4220a02d47007e40468b5d2356b3ed8c53603e89532b88835572aded35e582dd`, 1,875,634 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/integrations/make/4220a02d47007e40468b5d2356b3ed8c53603e89532b88835572aded35e582dd-make2.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/browser-session-create.mp4`
+
+- Original: SHA-256 `3c68f88cf30fe223cc7dfe2edd90e03054377d702b1c619e65cfef3c064efe41`, 3,735,886 bytes
+- Hosted path: `media/cookbooks/healthcare/3c68f88cf30fe223cc7dfe2edd90e03054377d702b1c619e65cfef3c064efe41-browser-session-create.mp4`
+- Hosted: SHA-256 `3c68f88cf30fe223cc7dfe2edd90e03054377d702b1c619e65cfef3c064efe41`, 3,735,886 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/3c68f88cf30fe223cc7dfe2edd90e03054377d702b1c619e65cfef3c064efe41-browser-session-create.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/navigation-error-messages.mp4`
+
+- Original: SHA-256 `dd90d50875e60e6a99319157683bfc61a227db9772018eccde3c31ff039f2f3e`, 3,581,629 bytes
+- Hosted path: `media/cookbooks/healthcare/dd90d50875e60e6a99319157683bfc61a227db9772018eccde3c31ff039f2f3e-navigation-error-messages.mp4`
+- Hosted: SHA-256 `dd90d50875e60e6a99319157683bfc61a227db9772018eccde3c31ff039f2f3e`, 3,581,629 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/dd90d50875e60e6a99319157683bfc61a227db9772018eccde3c31ff039f2f3e-navigation-error-messages.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/workflow-start.mp4`
+
+- Original: SHA-256 `1dcbdffcdff31b8a67458ed3b64fe1d17f17f6b3c10b18bfbde92a75391daab0`, 3,177,949 bytes
+- Hosted path: `media/cookbooks/healthcare/1dcbdffcdff31b8a67458ed3b64fe1d17f17f6b3c10b18bfbde92a75391daab0-workflow-start.mp4`
+- Hosted: SHA-256 `1dcbdffcdff31b8a67458ed3b64fe1d17f17f6b3c10b18bfbde92a75391daab0`, 3,177,949 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/cookbooks/healthcare/1dcbdffcdff31b8a67458ed3b64fe1d17f17f6b3c10b18bfbde92a75391daab0-workflow-start.mp4
+- Re-encode: none; copied byte-for-byte.
+
+### `docs/images/laminar-keys.mp4`
+
+- Original: SHA-256 `f2d0b8714b6e6ec3b0b50d9a6e3384897a1d093f47c0542c9d6e1dc69b3fddee`, 1,335,413 bytes
+- Hosted path: `media/observability/f2d0b8714b6e6ec3b0b50d9a6e3384897a1d093f47c0542c9d6e1dc69b3fddee-laminar-keys.mp4`
+- Hosted: SHA-256 `f2d0b8714b6e6ec3b0b50d9a6e3384897a1d093f47c0542c9d6e1dc69b3fddee`, 1,335,413 bytes, `video/mp4`
+- URL: https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@383c5fb7f1c10a89e57a34e503b05b7ee4e80a6a/media/observability/f2d0b8714b6e6ec3b0b50d9a6e3384897a1d093f47c0542c9d6e1dc69b3fddee-laminar-keys.mp4
+- Re-encode: none; copied byte-for-byte.
+
+## Verification
+
+On 2026-07-24, anonymous full downloads of all 12 URLs matched the hosted SHA-256 and byte length.
+Responses used the declared `video/mp4` or `image/gif` type and
+`Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable`. Each MP4 returned a 1,024-byte
+`206 Partial Content` response for `Range: bytes=0-1023`, with the expected `Content-Range` and
+`Accept-Ranges: bytes`.
+
+A clean Chromium 145 session decoded all 11 MP4s with nonzero dimensions and finite duration, reported no
+media errors, and advanced playback. The GIF decoded at 1376x1080.
+
+## Publishing updates
+
+1. Review jsDelivr's [GitHub endpoint](https://github.com/jsdelivr/jsdelivr#github),
+ [package restrictions](https://github.com/jsdelivr/jsdelivr#restrictions), and
+ [caching contract](https://github.com/jsdelivr/jsdelivr#caching). Keep the repository below 150 MB and
+ every file below 20 MB.
+2. Work in a temporary clone of `Skyvern-AI/skyvern-docs-media`, never in the documentation repository.
+ Calculate the source SHA-256 and exact byte length before transforming anything.
+3. If an MP4 exceeds 20 MB, encode an H.264 `yuv420p` copy with fast-start metadata. Compare `ffprobe`
+ duration, dimensions, frame rate, and audio streams; run SSIM/PSNR or VMAF; inspect representative
+ frames; and test browser playback.
+4. Put the asset in a logical `media/` subdirectory. Prefix its filename with the full hosted SHA-256.
+ Commit and push the media. Never modify or remove a published origin commit.
+5. Build the URL as
+ `https://cdn.jsdelivr.net/gh/Skyvern-AI/skyvern-docs-media@<full-commit-sha>/<hosted-path>`. Never use a
+ branch, tag, shortened commit, version range, or latest alias.
+6. Before changing docs, anonymously verify the full response's checksum, length, MIME type, and one-year
+ immutable cache policy. Verify `206` byte-range behavior for MP4 and decode every asset in clean
+ Chromium.
+7. Add the source and hosted metadata to this manifest, update only the consumer URL, and preserve all
+ video attributes, source types, styles, and image alt text. Delete a Git copy only after its CDN URL
+ passes every check.
diff --git a/skyvern/config.py b/skyvern/config.py
index 8c5c0b51b..a4d48697e 100644
--- a/skyvern/config.py
+++ b/skyvern/config.py
@@ -301,7 +301,7 @@ class Settings(BaseSettings):
# Directory containing pre-built default browser profiles ({dir}/chrome/ and {dir}/chromium/).
# When set, used as the default profile source for new browser sessions.
# Cloud workers download S3 profiles here at startup; self-hosted users can point this at a
- # local profile directory. Leave empty to use the in-repo template.
+ # local profile directory. Leave empty to use versioned temp caches and clean empty fallbacks.
DEFAULT_BROWSER_PROFILE_DIR: str = ""
BROWSER_WIDTH: int = 1920
BROWSER_HEIGHT: int = 1080
diff --git a/skyvern/forge/sdk/routes/browser_profiles.py b/skyvern/forge/sdk/routes/browser_profiles.py
index 3b8449d37..e73ea881a 100644
--- a/skyvern/forge/sdk/routes/browser_profiles.py
+++ b/skyvern/forge/sdk/routes/browser_profiles.py
@@ -42,29 +42,11 @@ from skyvern.forge.sdk.workflow.browser_session_persistence import retrieve_pers
from skyvern.schemas.proxy_pinning import apply_proxy_pin_update as _apply_proxy_pin_update
from skyvern.schemas.proxy_pinning import should_generate_proxy_session_id
from skyvern.schemas.runs import ProxyLocation, ProxyLocationInput
+from skyvern.webeye.browser_profile_utils import DEFAULT_PROFILE_COPY_IGNORE, valid_operator_profile_generation
LOG = structlog.get_logger()
DEFAULT_PROFILE_BROWSER_TYPES = ("chrome", "chromium")
-DEFAULT_PROFILE_COPY_IGNORE = {
- "Snapshots",
- "GrShaderCache",
- "ShaderCache",
- "GraphiteDawnCache",
- "DawnCache",
- "DawnGraphiteCache",
- "DawnWebGPUCache",
- "Guest Profile",
- "Profile 2",
- "Profile 3",
- "BrowserMetrics",
- "Crashpad",
- "CrashpadMetrics-active.pma",
- "SingletonCookie",
- "SingletonLock",
- "SingletonSocket",
- "DevToolsActivePort",
-}
def _normalize_proxy_pin_fields(
@@ -572,13 +554,22 @@ def _versioned_browser_profile_template_candidates(base_dir: FilePath, browser_t
return [path for _, path in candidates]
+def _browser_profile_template_identity(directory: FilePath) -> str | None:
+ if (
+ not directory.is_dir()
+ or (directory / ".skyvern_corrupt").exists()
+ or not (directory / "Default").is_dir()
+ or not (directory / "Default" / "Preferences").is_file()
+ or not (directory / "Local State").is_file()
+ ):
+ return None
+ if directory.name in DEFAULT_PROFILE_BROWSER_TYPES:
+ return valid_operator_profile_generation(str(directory.parent), directory.name, str(directory))
+ return ""
+
+
def _is_valid_browser_profile_template(directory: FilePath) -> bool:
- return (
- directory.is_dir()
- and (directory / "Default").is_dir()
- and (directory / "Default" / "Preferences").is_file()
- and (directory / "Local State").is_file()
- )
+ return _browser_profile_template_identity(directory) is not None
def _clear_directory(directory: FilePath) -> None:
@@ -610,10 +601,13 @@ def _seed_minimal_empty_browser_profile_directory(profile_dir: FilePath) -> None
def _seed_empty_browser_profile_directory(profile_dir: FilePath) -> None:
for template_dir in _default_browser_profile_template_candidates():
- if not _is_valid_browser_profile_template(template_dir):
+ template_identity = _browser_profile_template_identity(template_dir)
+ if template_identity is None:
continue
try:
_copy_browser_profile_template(template_dir, profile_dir)
+ if _browser_profile_template_identity(template_dir) != template_identity:
+ raise OSError("Default browser profile template was invalidated while copying")
LOG.info(
"Seeded empty browser profile from default profile template",
template_dir=str(template_dir),
diff --git a/skyvern/webeye/browser_profile_utils.py b/skyvern/webeye/browser_profile_utils.py
new file mode 100644
index 000000000..976f3f62e
--- /dev/null
+++ b/skyvern/webeye/browser_profile_utils.py
@@ -0,0 +1,75 @@
+import hashlib
+import os
+import stat
+import tempfile
+
+DEFAULT_PROFILE_COPY_IGNORE = {
+ "Snapshots",
+ "GrShaderCache",
+ "ShaderCache",
+ "GraphiteDawnCache",
+ "DawnCache",
+ "DawnGraphiteCache",
+ "DawnWebGPUCache",
+ "Guest Profile",
+ "Profile 2",
+ "Profile 3",
+ "BrowserMetrics",
+ "Crashpad",
+ "CrashpadMetrics-active.pma",
+ "SingletonCookie",
+ "SingletonLock",
+ "SingletonSocket",
+ "DevToolsActivePort",
+}
+
+
+def operator_profile_generation(path: str) -> str | None:
+ digest = hashlib.sha256()
+
+ def add(item: str, ancestors: frozenset[tuple[int, int]]) -> None:
+ metadata = os.stat(item)
+ relative_path = os.path.relpath(item, path)
+ digest.update(
+ f"{relative_path}\0{metadata.st_mode}\0{metadata.st_size}\0{metadata.st_mtime_ns}\0"
+ f"{metadata.st_ctime_ns}\0{metadata.st_dev}\0{metadata.st_ino}\n".encode()
+ )
+ if stat.S_ISDIR(metadata.st_mode):
+ identity = (metadata.st_dev, metadata.st_ino)
+ if identity in ancestors:
+ raise OSError(f"Symlink cycle in operator profile: {relative_path}")
+ for entry in sorted(os.scandir(item), key=lambda entry: entry.name):
+ if relative_path != "." or entry.name not in DEFAULT_PROFILE_COPY_IGNORE:
+ add(entry.path, ancestors | {identity})
+
+ try:
+ add(path, frozenset())
+ except OSError:
+ return None
+ return digest.hexdigest()
+
+
+def operator_profile_marker_path(base_dir: str, browser_type: str, generation: str) -> str:
+ digest = hashlib.sha256(os.path.realpath(base_dir).encode()).hexdigest()
+ return os.path.join(
+ tempfile.gettempdir(), "skyvern-browser-profile-invalidations", f"{digest}_{browser_type}_{generation}"
+ )
+
+
+def write_operator_profile_marker(base_dir: str, browser_type: str, generation: str) -> None:
+ marker_path = operator_profile_marker_path(base_dir, browser_type, generation)
+ os.makedirs(os.path.dirname(marker_path), exist_ok=True)
+ descriptor = os.open(marker_path, os.O_CREAT | os.O_WRONLY, 0o600)
+ os.close(descriptor)
+
+
+def valid_operator_profile_generation(
+ base_dir: str,
+ browser_type: str,
+ path: str,
+ invalidated_generation: str | None = None,
+) -> str | None:
+ generation = operator_profile_generation(path)
+ if generation is None or generation == invalidated_generation:
+ return None
+ return None if os.path.exists(operator_profile_marker_path(base_dir, browser_type, generation)) else generation
diff --git a/tests/unit/forge/sdk/test_create_browser_profile_from_session_route.py b/tests/unit/forge/sdk/test_create_browser_profile_from_session_route.py
index c921aa1e2..9d561540f 100644
--- a/tests/unit/forge/sdk/test_create_browser_profile_from_session_route.py
+++ b/tests/unit/forge/sdk/test_create_browser_profile_from_session_route.py
@@ -22,6 +22,7 @@ from skyvern.forge.sdk.schemas.browser_profiles import BrowserProfile, CreateBro
from skyvern.forge.sdk.schemas.persistent_browser_sessions import PersistentBrowserSession
from skyvern.forge.sdk.services import org_auth_service
from skyvern.schemas.runs import ProxyLocation
+from skyvern.webeye.browser_profile_utils import operator_profile_generation, write_operator_profile_marker
_default_profile_template_candidates = browser_profiles_route._default_browser_profile_template_candidates
@@ -267,14 +268,16 @@ def test_create_empty_profile_uses_latest_versioned_default_profile(
tmp_path: Path,
) -> None:
client, mocks = _build_client(monkeypatch)
+ monkeypatch.setattr(browser_profiles_route.settings, "DEFAULT_BROWSER_PROFILE_DIR", str(tmp_path))
_make_default_profile_template(tmp_path, name="chrome_100", marker="old-template")
- _make_default_profile_template(tmp_path, name="chrome_200", marker="new-template")
+ operator_template = _make_default_profile_template(tmp_path, name="chrome", marker="operator-template")
+ generation = operator_profile_generation(str(operator_template))
+ write_operator_profile_marker(str(tmp_path), "chrome", generation or "")
async def _store_profile(**kwargs: str) -> None:
directory = Path(kwargs["directory"])
- assert (directory / "Default" / "template-marker.txt").read_text(encoding="utf-8") == "new-template"
+ assert (directory / "Default" / "template-marker.txt").read_text(encoding="utf-8") == "old-template"
- monkeypatch.setattr(browser_profiles_route.settings, "DEFAULT_BROWSER_PROFILE_DIR", str(tmp_path))
monkeypatch.setattr(
browser_profiles_route,
"_default_browser_profile_template_candidates",
@@ -284,8 +287,30 @@ def test_create_empty_profile_uses_latest_versioned_default_profile(
response = client.post("/v1/browser_profiles/", json={"name": "fresh profile"})
+ marker_file = operator_template / "Default" / "template-marker.txt"
+ marker_file.write_text("repaired-template-with-new-size")
+
assert response.status_code == 200
- mocks.store_profile.assert_awaited_once()
+ assert browser_profiles_route._is_valid_browser_profile_template(operator_template)
+
+
+def test_empty_profile_seed_rejects_template_changed_during_copy(
+ monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+) -> None:
+ _make_default_profile_template(tmp_path, name="chrome")
+ profile_dir = tmp_path / "seed"
+ profile_dir.mkdir()
+ copy_template = browser_profiles_route._copy_browser_profile_template
+
+ def _copy_then_change(source: Path, destination: Path) -> None:
+ copy_template(source, destination)
+ (source / "Default" / "template-marker.txt").write_text("replacement", encoding="utf-8")
+
+ monkeypatch.setattr(browser_profiles_route, "_copy_browser_profile_template", _copy_then_change)
+ browser_profiles_route._seed_empty_browser_profile_directory(profile_dir)
+
+ assert (profile_dir / "Default" / "Preferences").read_text(encoding="utf-8") == "{}"
+ assert not (profile_dir / "Default" / "template-marker.txt").exists()
def test_create_empty_profile_falls_back_to_minimal_seed(monkeypatch: pytest.MonkeyPatch) -> None: