Automate browser based workflows with AI
Python aiapiautomationbrowserbrowser-automationcomputergptllmplaywrightpowerautomatepuppeteerpythonrpaseleniumvisionworkflow
Gate artifact URL re-minting to Skyvern signed content URLs (#7499)
Aaron Perez8ed3be1b3f6e
diff --git a/pyproject.toml b/pyproject.tomlindex efe54d138..cc34cd58b 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -1,6 +1,6 @@[project]name = "skyvern"-version = "1.0.46"+version = "1.0.47"description = ""authors = [{ name = "Skyvern AI", email = "[email protected]" }]requires-python = ">=3.11,<3.14"diff --git a/skyvern-frontend/src/components/ArtifactDownloadLink.test.tsx b/skyvern-frontend/src/components/ArtifactDownloadLink.test.tsxindex 631339f4f..ec59f7ba8 100644--- a/skyvern-frontend/src/components/ArtifactDownloadLink.test.tsx+++ b/skyvern-frontend/src/components/ArtifactDownloadLink.test.tsx@@ -48,6 +48,27 @@ describe("ArtifactDownloadLink", () => {openSpy.mockRestore();});+ it("keeps native behavior for non-artifact hrefs (rel semantics, no blank tab)", () => {+ freshMock.mockClear();+ const openSpy = vi.spyOn(window, "open");+ const { container } = render(+ <ArtifactDownloadLink+ href="https://bucket.s3.amazonaws.com/file.pdf?X-Amz-Signature=abc"+ target="_blank"+ rel="noopener noreferrer"+ >+ file.pdf+ </ArtifactDownloadLink>,+ );+ const anchor = container.querySelector("a")!;+ const notPrevented = fireEvent.click(anchor);++ expect(notPrevented).toBe(true);+ expect(openSpy).not.toHaveBeenCalled();+ expect(freshMock).not.toHaveBeenCalled();+ openSpy.mockRestore();+ });+it("keeps native behavior for modified clicks", () => {freshMock.mockClear();const { container } = render(diff --git a/skyvern-frontend/src/components/ArtifactDownloadLink.tsx b/skyvern-frontend/src/components/ArtifactDownloadLink.tsxindex 0b95d33e4..b38564a65 100644--- a/skyvern-frontend/src/components/ArtifactDownloadLink.tsx+++ b/skyvern-frontend/src/components/ArtifactDownloadLink.tsx@@ -1,4 +1,4 @@-import { freshArtifactUrl } from "@/api/artifactUrls";+import { artifactIdFromContentUrl, freshArtifactUrl } from "@/api/artifactUrls";import { useCredentialGetter } from "@/hooks/useCredentialGetter";type Props = Omit<React.ComponentPropsWithoutRef<"a">, "href"> & {@@ -31,6 +31,11 @@ function ArtifactDownloadLink({) {return;}+ // Non-mintable hrefs navigate natively: keeps rel semantics (noreferrer)+ // and avoids the blank-tab flash for links that never need re-minting.+ if (!artifactIdFromContentUrl(href)) {+ return;+ }event.preventDefault();// The tab must be opened synchronously inside the click gesture — opening// it after the awaited mint trips popup blockers (Safari/Firefox). Thediff --git a/skyvern-frontend/src/hooks/useArtifactImageSrc.test.tsx b/skyvern-frontend/src/hooks/useArtifactImageSrc.test.tsxindex 779f73b44..ed3a6700a 100644--- a/skyvern-frontend/src/hooks/useArtifactImageSrc.test.tsx+++ b/skyvern-frontend/src/hooks/useArtifactImageSrc.test.tsx@@ -73,6 +73,51 @@ describe("useArtifactImageSrc", () => {expect(mintMock).toHaveBeenCalledTimes(1);});+ it("re-mints by id when the source is a storage-presigned URL", async () => {+ mintMock.mockClear();+ mintMock.mockResolvedValue({+ artifact_id: "a_s3",+ signed_url: MINTED_URL,+ expires_at: 2,+ });+ const presignedArtifact = {+ artifact_id: "a_s3",+ artifact_type: "screenshot_action",+ uri: "s3://bucket/a_s3.png",+ signed_url:+ "https://bucket.s3.amazonaws.com/a_s3.png?X-Amz-Signature=abc",+ } as ArtifactApiResponse;++ const { container } = render(<Probe probeArtifact={presignedArtifact} />);+ const img = () => container.querySelector("img")!;+ fireEvent.error(img());++ await waitFor(() => {+ expect(img().getAttribute("src")).toBe(MINTED_URL);+ });+ expect(mintMock).toHaveBeenCalledWith(null, "a_s3");+ });++ it("does not mint for file-backed sources (local proxy never expires)", async () => {+ mintMock.mockClear();+ const fileArtifact = {+ artifact_id: "a_file",+ artifact_type: "screenshot_action",+ uri: "file:///data/artifacts/a_file.png",+ signed_url: undefined,+ } as unknown as ArtifactApiResponse;++ const { container, queryByTestId } = render(+ <Probe probeArtifact={fileArtifact} />,+ );+ fireEvent.error(container.querySelector("img")!);++ await waitFor(() => {+ expect(queryByTestId("failed")).not.toBeNull();+ });+ expect(mintMock).not.toHaveBeenCalled();+ });+it("ignores a mint that resolves after the artifact changed", async () => {let resolveMint!: (value: unknown) => void;mintMock.mockReset();diff --git a/skyvern-frontend/src/hooks/useArtifactImageSrc.ts b/skyvern-frontend/src/hooks/useArtifactImageSrc.tsindex 13b429dcc..310dd7586 100644--- a/skyvern-frontend/src/hooks/useArtifactImageSrc.ts+++ b/skyvern-frontend/src/hooks/useArtifactImageSrc.ts@@ -17,6 +17,12 @@ function useArtifactImageSrc(artifact: ArtifactApiResponse | undefined) {const artifactId = artifact?.artifact_id;const baseSrc = artifact ? getImageURL(artifact) : undefined;+ // file://-backed sources render through the local /artifact/image proxy and+ // never expire, so an error there is a real failure. Everything else (signed+ // content URLs, storage-presigned URLs) self-heals by re-minting from the id.+ const mintable = !(artifact?.signed_url ?? artifact?.uri)?.startsWith(+ "file://",+ );const currentArtifactIdRef = useRef(artifactId);useEffect(() => {@@ -26,7 +32,7 @@ function useArtifactImageSrc(artifact: ArtifactApiResponse | undefined) {}, [artifactId, baseSrc]);const onImageError = useCallback(() => {- if (!artifactId || mintedUrl) {+ if (!artifactId || !mintable || mintedUrl) {setImageFailed(true);return;}@@ -42,7 +48,7 @@ function useArtifactImageSrc(artifact: ArtifactApiResponse | undefined) {setImageFailed(true);}});- }, [artifactId, mintedUrl, credentialGetter]);+ }, [artifactId, mintable, mintedUrl, credentialGetter]);return { src: mintedUrl ?? baseSrc, onImageError, imageFailed };}diff --git a/skyvern-frontend/src/routes/workflows/studio/runview/HeroScreenshot.tsx b/skyvern-frontend/src/routes/workflows/studio/runview/HeroScreenshot.tsxindex 8fa17d64e..4800379aa 100644--- a/skyvern-frontend/src/routes/workflows/studio/runview/HeroScreenshot.tsx+++ b/skyvern-frontend/src/routes/workflows/studio/runview/HeroScreenshot.tsx@@ -148,7 +148,7 @@ export function HeroScreenshot({}const screenshotId = screenshot?.artifact_id ?? null;- const { src, onImageError } = useArtifactImageSrc(screenshot);+ const { src, onImageError, imageFailed } = useArtifactImageSrc(screenshot);const isLoading =loadingArtifact || loadingStep || loadingBlock || loadingThought;@@ -182,7 +182,7 @@ export function HeroScreenshot({</div>);}- if (!screenshot || screenshot.archived) {+ if (!screenshot || screenshot.archived || imageFailed) {return (<div className="absolute inset-0 grid place-items-center text-sm text-muted-foreground">Screenshot unavailable.diff --git a/skyvern/cli/core/session_manager.py b/skyvern/cli/core/session_manager.pyindex 8d1493c05..255442786 100644--- a/skyvern/cli/core/session_manager.py+++ b/skyvern/cli/core/session_manager.py@@ -18,6 +18,7 @@ from skyvern.config import settingsfrom .api_key_hash import hash_api_key_for_cachefrom .client import get_active_api_key, get_skyvern, has_api_key_overridefrom .result import BrowserContext, ErrorCode, make_error+from .trajectory_store import delete_session_trajectoriesLOG = structlog.get_logger(__name__)@@ -312,6 +313,16 @@ def _api_key_hash(api_key: str | None) -> str | None:return hash_api_key_for_cache(api_key)+def active_api_key_hash() -> str | None:+ return _api_key_hash(get_active_api_key())+++def current_api_key_hash() -> str | None:+ # Browser recorders call this only after resolve_browser has rebound the session to the active request key.+ state = get_current_session()+ return state.api_key_hash or _api_key_hash(get_active_api_key())++def _hashes_equal(a: str | None, b: str | None) -> bool:"""Constant-time comparison of two API-key hashes (either may be None).@@ -461,6 +472,7 @@ async def close_current_session() -> None:finally:clear_session_ref_map()if current.context and current.context.session_id:+ delete_session_trajectories(current.context.session_id)unregister_copilot_session(current.context.session_id)set_current_session(SessionState())diff --git a/skyvern/cli/core/trajectory_store.py b/skyvern/cli/core/trajectory_store.pynew file mode 100644index 000000000..a8ca83dc8--- /dev/null+++ b/skyvern/cli/core/trajectory_store.py@@ -0,0 +1,89 @@+import json+import time+from copy import deepcopy+from dataclasses import dataclass, field+from typing import Any++MAX_ENTRIES = 200+# Budget for trajectory_json AS EMBEDDED in the tool response: _json_size measures the+# double-encoded length (the string re-escapes when the response dict is serialized),+# so this bounds the final on-the-wire cost against MCP_MAX_RESPONSE_CHARS (140k)+# with headroom for the rest of the envelope.+MAX_BYTES = 120_000+TTL_SECONDS = 60 * 60+MAX_SESSIONS = 64+# One tenant minting many sessions must not flush other tenants' slots: past this,+# the tenant self-evicts its own least-recently-touched session first.+MAX_SESSIONS_PER_TENANT = 16+++@dataclass+class _Trajectory:+ entries: list[dict[str, Any]] = field(default_factory=list)+ truncated: bool = False+ last_touch: float = 0.0+++_trajectories: dict[tuple[str | None, str], _Trajectory] = {}+++def _sweep_expired(now: float) -> None:+ expired = [key for key, trajectory in _trajectories.items() if now - trajectory.last_touch > TTL_SECONDS]+ for key in expired:+ _trajectories.pop(key, None)+++def _json_size(entries: list[dict[str, Any]]) -> int:+ # char count == byte upper bound only while json.dumps keeps its ensure_ascii=True default.+ return len(json.dumps(json.dumps(entries)))+++def append_trajectory_entry(*, api_key_hash: str | None, session_id: str, entry: dict[str, Any]) -> None:+ stored_entry = deepcopy(entry)+ entry_size = _json_size([stored_entry])+ now = time.monotonic()+ _sweep_expired(now)+ key = (api_key_hash, session_id)+ previous = _trajectories.get(key)+ entries = list(previous.entries) if previous else []+ truncated = previous.truncated if previous else False++ if entry_size > MAX_BYTES:+ truncated = True+ else:+ entries.append(stored_entry)+ while len(entries) > MAX_ENTRIES or _json_size(entries) > MAX_BYTES:+ entries.pop(0)+ truncated = True++ _trajectories.pop(key, None)+ _trajectories[key] = _Trajectory(entries=entries, truncated=truncated, last_touch=now)+ tenant_keys = [stored_key for stored_key in _trajectories if stored_key[0] == api_key_hash]+ while len(tenant_keys) > MAX_SESSIONS_PER_TENANT:+ _trajectories.pop(tenant_keys.pop(0))+ while len(_trajectories) > MAX_SESSIONS:+ _trajectories.pop(next(iter(_trajectories)))+++def get_trajectory(*, api_key_hash: str | None, session_id: str) -> tuple[list[dict[str, Any]], bool, bool]:+ now = time.monotonic()+ _sweep_expired(now)+ key = (api_key_hash, session_id)+ trajectory = _trajectories.pop(key, None)+ if trajectory is None:+ return [], False, False++ trajectory.last_touch = now+ _trajectories[key] = trajectory+ return deepcopy(trajectory.entries), trajectory.truncated, True+++def delete_trajectory(*, api_key_hash: str | None, session_id: str) -> None:+ _trajectories.pop((api_key_hash, session_id), None)+++def delete_session_trajectories(session_id: str) -> None:+ # A closed browser session invalidates every principal's capture for it (same-org+ # drivers may hold different API keys); callers gate this on a backend-authorized close.+ for key in [stored_key for stored_key in _trajectories if stored_key[1] == session_id]:+ _trajectories.pop(key, None)diff --git a/skyvern/cli/mcp_tools/__init__.py b/skyvern/cli/mcp_tools/__init__.pyindex 7510d8ae3..e999d3db0 100644--- a/skyvern/cli/mcp_tools/__init__.py+++ b/skyvern/cli/mcp_tools/__init__.py@@ -153,6 +153,7 @@ from .tabs import (skyvern_tab_switch,skyvern_tab_wait_for_new,)+from .trajectory import skyvern_trajectory_getfrom .workflow import (guard_definition_size,skyvern_workflow_cancel,@@ -461,6 +462,7 @@ mcp.tool(tags={"block_discovery"}, annotations=_ro("Get Workflow Block Schema"))mcp.tool(tags={"block_discovery"}, annotations=_ro("Validate Workflow Block"))(skyvern_block_validate)mcp.tool(tags={"block_discovery"}, annotations=_ro("Lint Code Block"))(skyvern_code_block_lint)mcp.tool(tags={"block_discovery"}, annotations=_ro("Synthesize Code Block"))(skyvern_code_block_synthesize)+mcp.tool(tags={"block_discovery"}, annotations=_ro("Get Browser Trajectory"))(skyvern_trajectory_get)# -- Organization settings (no browser needed) --mcp.tool(tags={"settings"}, annotations=_ro("Get Organization Settings"))(skyvern_org_get)@@ -587,6 +589,7 @@ __all__ = ["skyvern_block_validate","skyvern_code_block_lint","skyvern_code_block_synthesize",+ "skyvern_trajectory_get",# Organization settings"skyvern_org_get","skyvern_org_update",diff --git a/skyvern/cli/mcp_tools/_session.py b/skyvern/cli/mcp_tools/_session.pyindex bca564b83..143306e81 100644--- a/skyvern/cli/mcp_tools/_session.py+++ b/skyvern/cli/mcp_tools/_session.py@@ -9,9 +9,11 @@ from skyvern.cli.core.client import get_skyvernfrom skyvern.cli.core.session_manager import (BrowserNotAvailableError,SessionState,+ active_api_key_hash,browser_session,clear_session_ref_map,close_current_session,+ current_api_key_hash,get_current_session,get_page,get_session_ref,@@ -26,9 +28,11 @@ from skyvern.cli.core.session_manager import (__all__ = ["BrowserNotAvailableError","SessionState",+ "active_api_key_hash","browser_session","clear_session_ref_map","close_current_session",+ "current_api_key_hash","get_current_session","get_page","get_session_ref",diff --git a/skyvern/cli/mcp_tools/browser.py b/skyvern/cli/mcp_tools/browser.pyindex f0b820ad2..b398b90c8 100644--- a/skyvern/cli/mcp_tools/browser.py+++ b/skyvern/cli/mcp_tools/browser.py@@ -50,7 +50,13 @@ from skyvern.cli.core.guards import resolve_ai_mode as _resolve_ai_modefrom skyvern.cli.core.guards import (validate_wait_until,)+from skyvern.cli.core.trajectory_store import append_trajectory_entryfrom skyvern.core.script_generations.skyvern_page import SkyvernPage++# Deliberate private import: the recorder must scrub URLs exactly like synthesis does,+# without forking the scrubber or modifying the copilot module.+from skyvern.forge.sdk.copilot.code_block_synthesis import _scrub_url_for_code_literal as scrub_url_for_code_literal+from skyvern.forge.sdk.copilot.typed_value_policy import safe_typed_default_value, typed_text_looks_secretfrom skyvern.schemas.run_blocks import CredentialTypefrom ._common import (@@ -77,6 +83,7 @@ from ._localhost import is_localhost_urlfrom ._session import (BrowserNotAvailableError,clear_session_ref_map,+ current_api_key_hash,get_current_session,get_page,get_session_ref,@@ -95,6 +102,56 @@ _ERROR_MESSAGE_MAX_CHARS = 500_ERROR_BODY_MESSAGE_KEYS = ("detail", "error", "message")+def _trajectory_source_url(page: Any) -> str | None:+ try:+ source_url = page.url+ return source_url if isinstance(source_url, str) else None+ except Exception:+ LOG.debug("Failed to capture trajectory source URL", exc_info=True)+ return None+++def _replayable_select_value(value: str | None) -> bool:+ # Synthesis strips select values before emitting, so only exact, non-empty, non-secret values round-trip.+ return value is not None and value != "" and value == value.strip() and not typed_text_looks_secret(value)+++def _replayable_press_key(key: str) -> bool:+ return len(key.rsplit("+", 1)[-1]) > 1+++def _record_trajectory_entry(+ ctx: Any,+ *,+ tool_name: str,+ source_url: str | None,+ selector: str | None = None,+ typed_text: str | None = None,+ value: str | None = None,+ key: str | None = None,+) -> None:+ try:+ if ctx.mode != "cloud_session" or not ctx.session_id:+ return+ entry: dict[str, Any] = {+ "tool_name": tool_name,+ "selector": selector,+ "source_url": scrub_url_for_code_literal(source_url) if source_url is not None else None,+ "value": value,+ "key": key,+ }+ if tool_name == "type_text":+ entry["typed_length"] = len(typed_text or "")+ entry["typed_value"] = safe_typed_default_value(typed_text, selector=selector or "")+ append_trajectory_entry(+ api_key_hash=current_api_key_hash(),+ session_id=ctx.session_id,+ entry={name: field for name, field in entry.items() if field is not None and field != ""},+ )+ except Exception:+ LOG.warning("Failed to record browser trajectory entry", tool_name=tool_name, exc_info=True)++def _blank_to_none(value: str | None) -> str | None:"""Treat a blank/whitespace string as omitted: MCP clients serialize an omitted optionalselector/intent as "", and a "" target would route a deterministic action onto nothing."""@@ -348,6 +405,7 @@ async def skyvern_click(page, ctx = await get_page(session_id=session_id, cdp_url=cdp_url)except BrowserNotAvailableError:return make_result("skyvern_click", ok=False, error=no_browser_error())+ source_url = _trajectory_source_url(page)deterministic = selector is not None and selector_mode == "direct"direct_action = is_direct_action(selector, ai_mode, deterministic=deterministic)@@ -454,6 +512,25 @@ async def skyvern_click(elif selector:data["sdk_equivalent"] = f"await page.click({selector!r})"+ if native_option_selection is not None:+ # Synthesis replays select_option by value only; index/label selections are not replayable.+ if native_option_selection.selected_by == "value" and _replayable_select_value(native_option_selection.value):+ _record_trajectory_entry(+ ctx,+ tool_name="select_option",+ selector=native_option_selection.select_selector,+ source_url=source_url,+ value=native_option_selection.value,+ )+ elif button in (None, "left") and click_count in (None, 1):+ replayable_selector = resolved if used_ai_path else resolved or selector+ if replayable_selector:+ _record_trajectory_entry(+ ctx,+ tool_name="click",+ selector=replayable_selector,+ source_url=source_url,+ )return make_result("skyvern_click",browser_context=ctx,@@ -878,6 +955,7 @@ async def skyvern_type(page, ctx = await get_page(session_id=session_id, cdp_url=cdp_url)except BrowserNotAvailableError:return make_result("skyvern_type", ok=False, error=no_browser_error())+ source_url = _trajectory_source_url(page)# DOM-level guard: check if the target element is a password fieldif selector:@@ -981,6 +1059,14 @@ async def skyvern_type(data["sdk_equivalent"] = f"await page.fill(prompt={intent!r}, value={text!r})"elif selector:data["sdk_equivalent"] = f"await page.fill({selector!r}, {text!r})"+ if clear and selector is not None and (ai_mode is None or deterministic):+ _record_trajectory_entry(+ ctx,+ tool_name="type_text",+ selector=selector,+ source_url=source_url,+ typed_text=text,+ )return make_result("skyvern_type",browser_context=ctx,@@ -1208,6 +1294,7 @@ async def skyvern_select_option(page, ctx = await get_page(session_id=session_id, cdp_url=cdp_url)except BrowserNotAvailableError:return make_result("skyvern_select_option", ok=False, error=no_browser_error())+ source_url = _trajectory_source_url(page)deterministic = selector is not None and selector_mode == "direct"direct_action = is_direct_action(selector, ai_mode, deterministic=deterministic)@@ -1463,6 +1550,14 @@ async def skyvern_select_option(data["sdk_equivalent"] = f"await page.select_option(prompt={intent!r}, value={value!r})"elif selector:data["sdk_equivalent"] = f"await page.select_option({selector!r}, value={value!r})"+ if selector is not None and not by_label and (ai_mode is None or deterministic) and _replayable_select_value(value):+ _record_trajectory_entry(+ ctx,+ tool_name="select_option",+ selector=selector,+ source_url=source_url,+ value=value,+ )if custom_attempt_ms:return make_result("skyvern_select_option",@@ -1496,10 +1591,13 @@ async def skyvern_press_key(Use `intent` or `selector` to focus a specific element before pressing.Without either, presses the key on the currently focused element."""+ selector = _blank_to_none(selector)+ intent = _blank_to_none(intent)try:page, ctx = await get_page(session_id=session_id, cdp_url=cdp_url)except BrowserNotAvailableError:return make_result("skyvern_press_key", ok=False, error=no_browser_error())+ source_url = _trajectory_source_url(page)ai_mode = _resolve_ai_mode(selector, intent)[0] if (intent or selector) else Nonedirect_action = is_direct_action(selector, ai_mode)@@ -1545,6 +1643,14 @@ async def skyvern_press_key(else:sdk_eq = f"await page.keyboard.press({key!r})"+ if intent is None and _replayable_press_key(key):+ _record_trajectory_entry(+ ctx,+ tool_name="press_key",+ key=key,+ selector=selector,+ source_url=source_url,+ )return make_result("skyvern_press_key",browser_context=ctx,diff --git a/skyvern/cli/mcp_tools/session.py b/skyvern/cli/mcp_tools/session.pyindex 63997390d..f9c5b882b 100644--- a/skyvern/cli/mcp_tools/session.py+++ b/skyvern/cli/mcp_tools/session.py@@ -15,6 +15,7 @@ from skyvern.cli.core.session_ops import (do_session_create,do_session_list,)+from skyvern.cli.core.trajectory_store import delete_session_trajectoriesfrom skyvern.client.types.extensions import Extensionsfrom skyvern.schemas.runs import proxy_location_to_request@@ -322,6 +323,7 @@ async def skyvern_browser_session_close(try:result = await do_session_close(skyvern, session_id)clear_session_ref_map(session_id=session_id)+ delete_session_trajectories(session_id)except Exception as e:close_error = ediff --git a/skyvern/cli/mcp_tools/trajectory.py b/skyvern/cli/mcp_tools/trajectory.pynew file mode 100644index 000000000..ce87c56bd--- /dev/null+++ b/skyvern/cli/mcp_tools/trajectory.py@@ -0,0 +1,37 @@+from __future__ import annotations++import json+from typing import Annotated, Any++from pydantic import Field++from skyvern.cli.core.trajectory_store import get_trajectory++from ._common import make_result+from ._session import active_api_key_hash+++async def skyvern_trajectory_get(+ session_id: Annotated[str, Field(description="Browser session ID (pbs_...) whose captured trajectory to return")],+) -> dict[str, Any]:+ """Return trajectory_json, entry_count, truncated, and capture_status for a browser session.++ Pass trajectory_json directly to skyvern_code_block_synthesize. Only deterministic skyvern_click,+ skyvern_type, skyvern_select_option, and skyvern_press_key actions are captured, so entry_count reflects+ just those; retrieve before closing the session (close deletes the trajectory). A not_found capture_status+ means nothing was captured, or the trajectory expired, was evicted, or lives in another server process.+ Capture is per server process, so hosted multi-replica results may be partial.+ """+ entries, truncated, found = get_trajectory(api_key_hash=active_api_key_hash(), session_id=session_id)+ return make_result(+ "skyvern_trajectory_get",+ data={+ "trajectory_json": json.dumps(entries),+ "entry_count": len(entries),+ "truncated": truncated,+ "capture_status": "found" if found else "not_found",+ },+ )+++__all__ = ["skyvern_trajectory_get"]diff --git a/skyvern/client/__init__.py b/skyvern/client/__init__.pyindex add7d0b01..536e4d6ff 100644--- a/skyvern/client/__init__.py+++ b/skyvern/client/__init__.py@@ -54,6 +54,7 @@ if typing.TYPE_CHECKING:BrowserProfileProxyLocation,BrowserSessionResponse,BulkCancelRunsResponse,+ ClearOrganizationAuthTokenResponse,ClickAction,ClickActionData,ClickContext,@@ -70,6 +71,8 @@ if typing.TYPE_CHECKING:CodeBlockParametersItem_Onepassword,CodeBlockParametersItem_Output,CodeBlockParametersItem_Workflow,+ CodeBlockStep,+ CodeBlockStepYaml,CodeBlockYaml,ConditionalBlock,ConditionalBlockYaml,@@ -98,12 +101,35 @@ if typing.TYPE_CHECKING:CredentialParameterYaml,CredentialResponse,CredentialResponseCredential,+ CredentialResponseProxyLocation,CredentialTypeOutput,CredentialVaultType,+ CreditCardBillingAddress,CreditCardCredentialResponse,+ CustomLlm,+ CustomLlmConfig,+ CustomLlmListResponse,+ CustomLlmProvider,+ CustomLlmResponse,DeleteScheduleResponse,DownloadToS3Block,DownloadToS3BlockYaml,+ EmailInboxBlock,+ EmailInboxBlockEmailClient,+ EmailInboxBlockParametersItem,+ EmailInboxBlockParametersItem_AwsSecret,+ EmailInboxBlockParametersItem_AzureSecret,+ EmailInboxBlockParametersItem_AzureVaultCredential,+ EmailInboxBlockParametersItem_BitwardenCreditCardData,+ EmailInboxBlockParametersItem_BitwardenLoginCredential,+ EmailInboxBlockParametersItem_BitwardenSensitiveInformation,+ EmailInboxBlockParametersItem_Context,+ EmailInboxBlockParametersItem_Credential,+ EmailInboxBlockParametersItem_Onepassword,+ EmailInboxBlockParametersItem_Output,+ EmailInboxBlockParametersItem_Workflow,+ EmailInboxBlockYaml,+ EmailInboxBlockYamlEmailClient,Extensions,ExtractAction,ExtractActionData,@@ -156,6 +182,7 @@ if typing.TYPE_CHECKING:ForLoopBlockLoopBlocksItem_Code,ForLoopBlockLoopBlocksItem_Conditional,ForLoopBlockLoopBlocksItem_DownloadToS3,+ ForLoopBlockLoopBlocksItem_EmailInbox,ForLoopBlockLoopBlocksItem_Extraction,ForLoopBlockLoopBlocksItem_FileDownload,ForLoopBlockLoopBlocksItem_FileUpload,@@ -168,9 +195,11 @@ if typing.TYPE_CHECKING:ForLoopBlockLoopBlocksItem_HumanInteraction,ForLoopBlockLoopBlocksItem_Login,ForLoopBlockLoopBlocksItem_Navigation,+ ForLoopBlockLoopBlocksItem_PdfFill,ForLoopBlockLoopBlocksItem_PdfParser,ForLoopBlockLoopBlocksItem_PrintPage,ForLoopBlockLoopBlocksItem_SendEmail,+ ForLoopBlockLoopBlocksItem_SplitPdf,ForLoopBlockLoopBlocksItem_Task,ForLoopBlockLoopBlocksItem_TaskV2,ForLoopBlockLoopBlocksItem_TextPrompt,@@ -198,6 +227,7 @@ if typing.TYPE_CHECKING:ForLoopBlockYamlLoopBlocksItem_Code,ForLoopBlockYamlLoopBlocksItem_Conditional,ForLoopBlockYamlLoopBlocksItem_DownloadToS3,+ ForLoopBlockYamlLoopBlocksItem_EmailInbox,ForLoopBlockYamlLoopBlocksItem_Extraction,ForLoopBlockYamlLoopBlocksItem_FileDownload,ForLoopBlockYamlLoopBlocksItem_FileUpload,@@ -210,9 +240,11 @@ if typing.TYPE_CHECKING:ForLoopBlockYamlLoopBlocksItem_HumanInteraction,ForLoopBlockYamlLoopBlocksItem_Login,ForLoopBlockYamlLoopBlocksItem_Navigation,+ ForLoopBlockYamlLoopBlocksItem_PdfFill,ForLoopBlockYamlLoopBlocksItem_PdfParser,ForLoopBlockYamlLoopBlocksItem_PrintPage,ForLoopBlockYamlLoopBlocksItem_SendEmail,+ ForLoopBlockYamlLoopBlocksItem_SplitPdf,ForLoopBlockYamlLoopBlocksItem_Task,ForLoopBlockYamlLoopBlocksItem_TaskV2,ForLoopBlockYamlLoopBlocksItem_TextPrompt,@@ -335,6 +367,22 @@ if typing.TYPE_CHECKING:OutputParameter,OutputParameterYaml,PasswordCredentialResponse,+ PdfFillBlock,+ PdfFillBlockParametersItem,+ PdfFillBlockParametersItem_AwsSecret,+ PdfFillBlockParametersItem_AzureSecret,+ PdfFillBlockParametersItem_AzureVaultCredential,+ PdfFillBlockParametersItem_BitwardenCreditCardData,+ PdfFillBlockParametersItem_BitwardenLoginCredential,+ PdfFillBlockParametersItem_BitwardenSensitiveInformation,+ PdfFillBlockParametersItem_Context,+ PdfFillBlockParametersItem_Credential,+ PdfFillBlockParametersItem_Onepassword,+ PdfFillBlockParametersItem_Output,+ PdfFillBlockParametersItem_Workflow,+ PdfFillBlockPayload,+ PdfFillBlockYaml,+ PdfFillBlockYamlPayload,PdfFormat,PdfParserBlock,PdfParserBlockYaml,@@ -370,6 +418,10 @@ if typing.TYPE_CHECKING:RunSdkActionRequestAction_Validate,RunSdkActionResponse,RunStatus,+ RunTagHistoryResponse,+ RunTagsBatchResponse,+ RunTagsResponse,+ RunType,RunWebhookReplayResponse,Script,ScriptFileCreate,@@ -383,6 +435,21 @@ if typing.TYPE_CHECKING:SendEmailBlockYaml,SkyvernForgeSdkSchemasCredentialsCredentialType,SkyvernSchemasCredentialTypeCredentialType,+ SplitPdfBlock,+ SplitPdfBlockParametersItem,+ SplitPdfBlockParametersItem_AwsSecret,+ SplitPdfBlockParametersItem_AzureSecret,+ SplitPdfBlockParametersItem_AzureVaultCredential,+ SplitPdfBlockParametersItem_BitwardenCreditCardData,+ SplitPdfBlockParametersItem_BitwardenLoginCredential,+ SplitPdfBlockParametersItem_BitwardenSensitiveInformation,+ SplitPdfBlockParametersItem_Context,+ SplitPdfBlockParametersItem_Credential,+ SplitPdfBlockParametersItem_Onepassword,+ SplitPdfBlockParametersItem_Output,+ SplitPdfBlockParametersItem_Workflow,+ SplitPdfBlockYaml,+ TagApplyRequest,TagDeleteInput,TagHistoryItem,TagHistoryResponse,@@ -391,6 +458,9 @@ if typing.TYPE_CHECKING:TagKey,TagKeyDeleteResponse,TagResponse,+ TagValue,+ TagValueDeleteResponse,+ TagValueRenameResponse,TagsResponse,TaskBlock,TaskBlockDataSchema,@@ -500,6 +570,7 @@ if typing.TYPE_CHECKING:WhileLoopBlockLoopBlocksItem_Code,WhileLoopBlockLoopBlocksItem_Conditional,WhileLoopBlockLoopBlocksItem_DownloadToS3,+ WhileLoopBlockLoopBlocksItem_EmailInbox,WhileLoopBlockLoopBlocksItem_Extraction,WhileLoopBlockLoopBlocksItem_FileDownload,WhileLoopBlockLoopBlocksItem_FileUpload,@@ -512,9 +583,11 @@ if typing.TYPE_CHECKING:WhileLoopBlockLoopBlocksItem_HumanInteraction,WhileLoopBlockLoopBlocksItem_Login,WhileLoopBlockLoopBlocksItem_Navigation,+ WhileLoopBlockLoopBlocksItem_PdfFill,WhileLoopBlockLoopBlocksItem_PdfParser,WhileLoopBlockLoopBlocksItem_PrintPage,WhileLoopBlockLoopBlocksItem_SendEmail,+ WhileLoopBlockLoopBlocksItem_SplitPdf,WhileLoopBlockLoopBlocksItem_Task,WhileLoopBlockLoopBlocksItem_TaskV2,WhileLoopBlockLoopBlocksItem_TextPrompt,@@ -529,6 +602,7 @@ if typing.TYPE_CHECKING:WhileLoopBlockYamlLoopBlocksItem_Code,WhileLoopBlockYamlLoopBlocksItem_Conditional,WhileLoopBlockYamlLoopBlocksItem_DownloadToS3,+ WhileLoopBlockYamlLoopBlocksItem_EmailInbox,WhileLoopBlockYamlLoopBlocksItem_Extraction,WhileLoopBlockYamlLoopBlocksItem_FileDownload,WhileLoopBlockYamlLoopBlocksItem_FileUpload,@@ -541,9 +615,11 @@ if typing.TYPE_CHECKING:WhileLoopBlockYamlLoopBlocksItem_HumanInteraction,WhileLoopBlockYamlLoopBlocksItem_Login,WhileLoopBlockYamlLoopBlocksItem_Navigation,+ WhileLoopBlockYamlLoopBlocksItem_PdfFill,WhileLoopBlockYamlLoopBlocksItem_PdfParser,WhileLoopBlockYamlLoopBlocksItem_PrintPage,WhileLoopBlockYamlLoopBlocksItem_SendEmail,+ WhileLoopBlockYamlLoopBlocksItem_SplitPdf,WhileLoopBlockYamlLoopBlocksItem_Task,WhileLoopBlockYamlLoopBlocksItem_TaskV2,WhileLoopBlockYamlLoopBlocksItem_TextPrompt,@@ -561,6 +637,7 @@ if typing.TYPE_CHECKING:WorkflowDefinitionBlocksItem_Code,WorkflowDefinitionBlocksItem_Conditional,WorkflowDefinitionBlocksItem_DownloadToS3,+ WorkflowDefinitionBlocksItem_EmailInbox,WorkflowDefinitionBlocksItem_Extraction,WorkflowDefinitionBlocksItem_FileDownload,WorkflowDefinitionBlocksItem_FileUpload,@@ -573,9 +650,11 @@ if typing.TYPE_CHECKING:WorkflowDefinitionBlocksItem_HumanInteraction,WorkflowDefinitionBlocksItem_Login,WorkflowDefinitionBlocksItem_Navigation,+ WorkflowDefinitionBlocksItem_PdfFill,WorkflowDefinitionBlocksItem_PdfParser,WorkflowDefinitionBlocksItem_PrintPage,WorkflowDefinitionBlocksItem_SendEmail,+ WorkflowDefinitionBlocksItem_SplitPdf,WorkflowDefinitionBlocksItem_Task,WorkflowDefinitionBlocksItem_TaskV2,WorkflowDefinitionBlocksItem_TextPrompt,@@ -602,6 +681,7 @@ if typing.TYPE_CHECKING:WorkflowDefinitionYamlBlocksItem_Code,WorkflowDefinitionYamlBlocksItem_Conditional,WorkflowDefinitionYamlBlocksItem_DownloadToS3,+ WorkflowDefinitionYamlBlocksItem_EmailInbox,WorkflowDefinitionYamlBlocksItem_Extraction,WorkflowDefinitionYamlBlocksItem_FileDownload,WorkflowDefinitionYamlBlocksItem_FileUpload,@@ -614,9 +694,11 @@ if typing.TYPE_CHECKING:WorkflowDefinitionYamlBlocksItem_HumanInteraction,WorkflowDefinitionYamlBlocksItem_Login,WorkflowDefinitionYamlBlocksItem_Navigation,+ WorkflowDefinitionYamlBlocksItem_PdfFill,WorkflowDefinitionYamlBlocksItem_PdfParser,WorkflowDefinitionYamlBlocksItem_PrintPage,WorkflowDefinitionYamlBlocksItem_SendEmail,+ WorkflowDefinitionYamlBlocksItem_SplitPdf,WorkflowDefinitionYamlBlocksItem_Task,WorkflowDefinitionYamlBlocksItem_TaskV2,WorkflowDefinitionYamlBlocksItem_TextPrompt,@@ -743,6 +825,7 @@ _dynamic_imports: typing.Dict[str, str] = {"BrowserProfileProxyLocation": ".types","BrowserSessionResponse": ".types","BulkCancelRunsResponse": ".types",+ "ClearOrganizationAuthTokenResponse": ".types","ClickAction": ".types","ClickActionData": ".types","ClickContext": ".types",@@ -759,6 +842,8 @@ _dynamic_imports: typing.Dict[str, str] = {"CodeBlockParametersItem_Onepassword": ".types","CodeBlockParametersItem_Output": ".types","CodeBlockParametersItem_Workflow": ".types",+ "CodeBlockStep": ".types",+ "CodeBlockStepYaml": ".types","CodeBlockYaml": ".types","ConditionalBlock": ".types","ConditionalBlockYaml": ".types",@@ -788,12 +873,35 @@ _dynamic_imports: typing.Dict[str, str] = {"CredentialParameterYaml": ".types","CredentialResponse": ".types","CredentialResponseCredential": ".types",+ "CredentialResponseProxyLocation": ".types","CredentialTypeOutput": ".types","CredentialVaultType": ".types",+ "CreditCardBillingAddress": ".types","CreditCardCredentialResponse": ".types",+ "CustomLlm": ".types",+ "CustomLlmConfig": ".types",+ "CustomLlmListResponse": ".types",+ "CustomLlmProvider": ".types",+ "CustomLlmResponse": ".types","DeleteScheduleResponse": ".types","DownloadToS3Block": ".types","DownloadToS3BlockYaml": ".types",+ "EmailInboxBlock": ".types",+ "EmailInboxBlockEmailClient": ".types",+ "EmailInboxBlockParametersItem": ".types",+ "EmailInboxBlockParametersItem_AwsSecret": ".types",+ "EmailInboxBlockParametersItem_AzureSecret": ".types",+ "EmailInboxBlockParametersItem_AzureVaultCredential": ".types",+ "EmailInboxBlockParametersItem_BitwardenCreditCardData": ".types",+ "EmailInboxBlockParametersItem_BitwardenLoginCredential": ".types",+ "EmailInboxBlockParametersItem_BitwardenSensitiveInformation": ".types",+ "EmailInboxBlockParametersItem_Context": ".types",+ "EmailInboxBlockParametersItem_Credential": ".types",+ "EmailInboxBlockParametersItem_Onepassword": ".types",+ "EmailInboxBlockParametersItem_Output": ".types",+ "EmailInboxBlockParametersItem_Workflow": ".types",+ "EmailInboxBlockYaml": ".types",+ "EmailInboxBlockYamlEmailClient": ".types","Extensions": ".types","ExtractAction": ".types","ExtractActionData": ".types",@@ -846,6 +954,7 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockLoopBlocksItem_Code": ".types","ForLoopBlockLoopBlocksItem_Conditional": ".types","ForLoopBlockLoopBlocksItem_DownloadToS3": ".types",+ "ForLoopBlockLoopBlocksItem_EmailInbox": ".types","ForLoopBlockLoopBlocksItem_Extraction": ".types","ForLoopBlockLoopBlocksItem_FileDownload": ".types","ForLoopBlockLoopBlocksItem_FileUpload": ".types",@@ -858,9 +967,11 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockLoopBlocksItem_HumanInteraction": ".types","ForLoopBlockLoopBlocksItem_Login": ".types","ForLoopBlockLoopBlocksItem_Navigation": ".types",+ "ForLoopBlockLoopBlocksItem_PdfFill": ".types","ForLoopBlockLoopBlocksItem_PdfParser": ".types","ForLoopBlockLoopBlocksItem_PrintPage": ".types","ForLoopBlockLoopBlocksItem_SendEmail": ".types",+ "ForLoopBlockLoopBlocksItem_SplitPdf": ".types","ForLoopBlockLoopBlocksItem_Task": ".types","ForLoopBlockLoopBlocksItem_TaskV2": ".types","ForLoopBlockLoopBlocksItem_TextPrompt": ".types",@@ -888,6 +999,7 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockYamlLoopBlocksItem_Code": ".types","ForLoopBlockYamlLoopBlocksItem_Conditional": ".types","ForLoopBlockYamlLoopBlocksItem_DownloadToS3": ".types",+ "ForLoopBlockYamlLoopBlocksItem_EmailInbox": ".types","ForLoopBlockYamlLoopBlocksItem_Extraction": ".types","ForLoopBlockYamlLoopBlocksItem_FileDownload": ".types","ForLoopBlockYamlLoopBlocksItem_FileUpload": ".types",@@ -900,9 +1012,11 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockYamlLoopBlocksItem_HumanInteraction": ".types","ForLoopBlockYamlLoopBlocksItem_Login": ".types","ForLoopBlockYamlLoopBlocksItem_Navigation": ".types",+ "ForLoopBlockYamlLoopBlocksItem_PdfFill": ".types","ForLoopBlockYamlLoopBlocksItem_PdfParser": ".types","ForLoopBlockYamlLoopBlocksItem_PrintPage": ".types","ForLoopBlockYamlLoopBlocksItem_SendEmail": ".types",+ "ForLoopBlockYamlLoopBlocksItem_SplitPdf": ".types","ForLoopBlockYamlLoopBlocksItem_Task": ".types","ForLoopBlockYamlLoopBlocksItem_TaskV2": ".types","ForLoopBlockYamlLoopBlocksItem_TextPrompt": ".types",@@ -1028,6 +1142,22 @@ _dynamic_imports: typing.Dict[str, str] = {"OutputParameter": ".types","OutputParameterYaml": ".types","PasswordCredentialResponse": ".types",+ "PdfFillBlock": ".types",+ "PdfFillBlockParametersItem": ".types",+ "PdfFillBlockParametersItem_AwsSecret": ".types",+ "PdfFillBlockParametersItem_AzureSecret": ".types",+ "PdfFillBlockParametersItem_AzureVaultCredential": ".types",+ "PdfFillBlockParametersItem_BitwardenCreditCardData": ".types",+ "PdfFillBlockParametersItem_BitwardenLoginCredential": ".types",+ "PdfFillBlockParametersItem_BitwardenSensitiveInformation": ".types",+ "PdfFillBlockParametersItem_Context": ".types",+ "PdfFillBlockParametersItem_Credential": ".types",+ "PdfFillBlockParametersItem_Onepassword": ".types",+ "PdfFillBlockParametersItem_Output": ".types",+ "PdfFillBlockParametersItem_Workflow": ".types",+ "PdfFillBlockPayload": ".types",+ "PdfFillBlockYaml": ".types",+ "PdfFillBlockYamlPayload": ".types","PdfFormat": ".types","PdfParserBlock": ".types","PdfParserBlockYaml": ".types",@@ -1064,6 +1194,10 @@ _dynamic_imports: typing.Dict[str, str] = {"RunSdkActionRequestAction_Validate": ".types","RunSdkActionResponse": ".types","RunStatus": ".types",+ "RunTagHistoryResponse": ".types",+ "RunTagsBatchResponse": ".types",+ "RunTagsResponse": ".types",+ "RunType": ".types","RunWebhookReplayResponse": ".types","SchedulesListAllRequestStatus": ".schedules","Script": ".types",@@ -1080,6 +1214,21 @@ _dynamic_imports: typing.Dict[str, str] = {"SkyvernEnvironment": ".environment","SkyvernForgeSdkSchemasCredentialsCredentialType": ".types","SkyvernSchemasCredentialTypeCredentialType": ".types",+ "SplitPdfBlock": ".types",+ "SplitPdfBlockParametersItem": ".types",+ "SplitPdfBlockParametersItem_AwsSecret": ".types",+ "SplitPdfBlockParametersItem_AzureSecret": ".types",+ "SplitPdfBlockParametersItem_AzureVaultCredential": ".types",+ "SplitPdfBlockParametersItem_BitwardenCreditCardData": ".types",+ "SplitPdfBlockParametersItem_BitwardenLoginCredential": ".types",+ "SplitPdfBlockParametersItem_BitwardenSensitiveInformation": ".types",+ "SplitPdfBlockParametersItem_Context": ".types",+ "SplitPdfBlockParametersItem_Credential": ".types",+ "SplitPdfBlockParametersItem_Onepassword": ".types",+ "SplitPdfBlockParametersItem_Output": ".types",+ "SplitPdfBlockParametersItem_Workflow": ".types",+ "SplitPdfBlockYaml": ".types",+ "TagApplyRequest": ".types","TagDeleteInput": ".types","TagHistoryItem": ".types","TagHistoryResponse": ".types",@@ -1088,6 +1237,9 @@ _dynamic_imports: typing.Dict[str, str] = {"TagKey": ".types","TagKeyDeleteResponse": ".types","TagResponse": ".types",+ "TagValue": ".types",+ "TagValueDeleteResponse": ".types",+ "TagValueRenameResponse": ".types","TagsResponse": ".types","TaskBlock": ".types","TaskBlockDataSchema": ".types",@@ -1198,6 +1350,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockLoopBlocksItem_Code": ".types","WhileLoopBlockLoopBlocksItem_Conditional": ".types","WhileLoopBlockLoopBlocksItem_DownloadToS3": ".types",+ "WhileLoopBlockLoopBlocksItem_EmailInbox": ".types","WhileLoopBlockLoopBlocksItem_Extraction": ".types","WhileLoopBlockLoopBlocksItem_FileDownload": ".types","WhileLoopBlockLoopBlocksItem_FileUpload": ".types",@@ -1210,9 +1363,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockLoopBlocksItem_HumanInteraction": ".types","WhileLoopBlockLoopBlocksItem_Login": ".types","WhileLoopBlockLoopBlocksItem_Navigation": ".types",+ "WhileLoopBlockLoopBlocksItem_PdfFill": ".types","WhileLoopBlockLoopBlocksItem_PdfParser": ".types","WhileLoopBlockLoopBlocksItem_PrintPage": ".types","WhileLoopBlockLoopBlocksItem_SendEmail": ".types",+ "WhileLoopBlockLoopBlocksItem_SplitPdf": ".types","WhileLoopBlockLoopBlocksItem_Task": ".types","WhileLoopBlockLoopBlocksItem_TaskV2": ".types","WhileLoopBlockLoopBlocksItem_TextPrompt": ".types",@@ -1227,6 +1382,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockYamlLoopBlocksItem_Code": ".types","WhileLoopBlockYamlLoopBlocksItem_Conditional": ".types","WhileLoopBlockYamlLoopBlocksItem_DownloadToS3": ".types",+ "WhileLoopBlockYamlLoopBlocksItem_EmailInbox": ".types","WhileLoopBlockYamlLoopBlocksItem_Extraction": ".types","WhileLoopBlockYamlLoopBlocksItem_FileDownload": ".types","WhileLoopBlockYamlLoopBlocksItem_FileUpload": ".types",@@ -1239,9 +1395,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockYamlLoopBlocksItem_HumanInteraction": ".types","WhileLoopBlockYamlLoopBlocksItem_Login": ".types","WhileLoopBlockYamlLoopBlocksItem_Navigation": ".types",+ "WhileLoopBlockYamlLoopBlocksItem_PdfFill": ".types","WhileLoopBlockYamlLoopBlocksItem_PdfParser": ".types","WhileLoopBlockYamlLoopBlocksItem_PrintPage": ".types","WhileLoopBlockYamlLoopBlocksItem_SendEmail": ".types",+ "WhileLoopBlockYamlLoopBlocksItem_SplitPdf": ".types","WhileLoopBlockYamlLoopBlocksItem_Task": ".types","WhileLoopBlockYamlLoopBlocksItem_TaskV2": ".types","WhileLoopBlockYamlLoopBlocksItem_TextPrompt": ".types",@@ -1259,6 +1417,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionBlocksItem_Code": ".types","WorkflowDefinitionBlocksItem_Conditional": ".types","WorkflowDefinitionBlocksItem_DownloadToS3": ".types",+ "WorkflowDefinitionBlocksItem_EmailInbox": ".types","WorkflowDefinitionBlocksItem_Extraction": ".types","WorkflowDefinitionBlocksItem_FileDownload": ".types","WorkflowDefinitionBlocksItem_FileUpload": ".types",@@ -1271,9 +1430,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionBlocksItem_HumanInteraction": ".types","WorkflowDefinitionBlocksItem_Login": ".types","WorkflowDefinitionBlocksItem_Navigation": ".types",+ "WorkflowDefinitionBlocksItem_PdfFill": ".types","WorkflowDefinitionBlocksItem_PdfParser": ".types","WorkflowDefinitionBlocksItem_PrintPage": ".types","WorkflowDefinitionBlocksItem_SendEmail": ".types",+ "WorkflowDefinitionBlocksItem_SplitPdf": ".types","WorkflowDefinitionBlocksItem_Task": ".types","WorkflowDefinitionBlocksItem_TaskV2": ".types","WorkflowDefinitionBlocksItem_TextPrompt": ".types",@@ -1300,6 +1461,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionYamlBlocksItem_Code": ".types","WorkflowDefinitionYamlBlocksItem_Conditional": ".types","WorkflowDefinitionYamlBlocksItem_DownloadToS3": ".types",+ "WorkflowDefinitionYamlBlocksItem_EmailInbox": ".types","WorkflowDefinitionYamlBlocksItem_Extraction": ".types","WorkflowDefinitionYamlBlocksItem_FileDownload": ".types","WorkflowDefinitionYamlBlocksItem_FileUpload": ".types",@@ -1312,9 +1474,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionYamlBlocksItem_HumanInteraction": ".types","WorkflowDefinitionYamlBlocksItem_Login": ".types","WorkflowDefinitionYamlBlocksItem_Navigation": ".types",+ "WorkflowDefinitionYamlBlocksItem_PdfFill": ".types","WorkflowDefinitionYamlBlocksItem_PdfParser": ".types","WorkflowDefinitionYamlBlocksItem_PrintPage": ".types","WorkflowDefinitionYamlBlocksItem_SendEmail": ".types",+ "WorkflowDefinitionYamlBlocksItem_SplitPdf": ".types","WorkflowDefinitionYamlBlocksItem_Task": ".types","WorkflowDefinitionYamlBlocksItem_TaskV2": ".types","WorkflowDefinitionYamlBlocksItem_TextPrompt": ".types",@@ -1455,6 +1619,7 @@ __all__ = ["BrowserProfileProxyLocation","BrowserSessionResponse","BulkCancelRunsResponse",+ "ClearOrganizationAuthTokenResponse","ClickAction","ClickActionData","ClickContext",@@ -1471,6 +1636,8 @@ __all__ = ["CodeBlockParametersItem_Onepassword","CodeBlockParametersItem_Output","CodeBlockParametersItem_Workflow",+ "CodeBlockStep",+ "CodeBlockStepYaml","CodeBlockYaml","ConditionalBlock","ConditionalBlockYaml",@@ -1500,12 +1667,35 @@ __all__ = ["CredentialParameterYaml","CredentialResponse","CredentialResponseCredential",+ "CredentialResponseProxyLocation","CredentialTypeOutput","CredentialVaultType",+ "CreditCardBillingAddress","CreditCardCredentialResponse",+ "CustomLlm",+ "CustomLlmConfig",+ "CustomLlmListResponse",+ "CustomLlmProvider",+ "CustomLlmResponse","DeleteScheduleResponse","DownloadToS3Block","DownloadToS3BlockYaml",+ "EmailInboxBlock",+ "EmailInboxBlockEmailClient",+ "EmailInboxBlockParametersItem",+ "EmailInboxBlockParametersItem_AwsSecret",+ "EmailInboxBlockParametersItem_AzureSecret",+ "EmailInboxBlockParametersItem_AzureVaultCredential",+ "EmailInboxBlockParametersItem_BitwardenCreditCardData",+ "EmailInboxBlockParametersItem_BitwardenLoginCredential",+ "EmailInboxBlockParametersItem_BitwardenSensitiveInformation",+ "EmailInboxBlockParametersItem_Context",+ "EmailInboxBlockParametersItem_Credential",+ "EmailInboxBlockParametersItem_Onepassword",+ "EmailInboxBlockParametersItem_Output",+ "EmailInboxBlockParametersItem_Workflow",+ "EmailInboxBlockYaml",+ "EmailInboxBlockYamlEmailClient","Extensions","ExtractAction","ExtractActionData",@@ -1558,6 +1748,7 @@ __all__ = ["ForLoopBlockLoopBlocksItem_Code","ForLoopBlockLoopBlocksItem_Conditional","ForLoopBlockLoopBlocksItem_DownloadToS3",+ "ForLoopBlockLoopBlocksItem_EmailInbox","ForLoopBlockLoopBlocksItem_Extraction","ForLoopBlockLoopBlocksItem_FileDownload","ForLoopBlockLoopBlocksItem_FileUpload",@@ -1570,9 +1761,11 @@ __all__ = ["ForLoopBlockLoopBlocksItem_HumanInteraction","ForLoopBlockLoopBlocksItem_Login","ForLoopBlockLoopBlocksItem_Navigation",+ "ForLoopBlockLoopBlocksItem_PdfFill","ForLoopBlockLoopBlocksItem_PdfParser","ForLoopBlockLoopBlocksItem_PrintPage","ForLoopBlockLoopBlocksItem_SendEmail",+ "ForLoopBlockLoopBlocksItem_SplitPdf","ForLoopBlockLoopBlocksItem_Task","ForLoopBlockLoopBlocksItem_TaskV2","ForLoopBlockLoopBlocksItem_TextPrompt",@@ -1600,6 +1793,7 @@ __all__ = ["ForLoopBlockYamlLoopBlocksItem_Code","ForLoopBlockYamlLoopBlocksItem_Conditional","ForLoopBlockYamlLoopBlocksItem_DownloadToS3",+ "ForLoopBlockYamlLoopBlocksItem_EmailInbox","ForLoopBlockYamlLoopBlocksItem_Extraction","ForLoopBlockYamlLoopBlocksItem_FileDownload","ForLoopBlockYamlLoopBlocksItem_FileUpload",@@ -1612,9 +1806,11 @@ __all__ = ["ForLoopBlockYamlLoopBlocksItem_HumanInteraction","ForLoopBlockYamlLoopBlocksItem_Login","ForLoopBlockYamlLoopBlocksItem_Navigation",+ "ForLoopBlockYamlLoopBlocksItem_PdfFill","ForLoopBlockYamlLoopBlocksItem_PdfParser","ForLoopBlockYamlLoopBlocksItem_PrintPage","ForLoopBlockYamlLoopBlocksItem_SendEmail",+ "ForLoopBlockYamlLoopBlocksItem_SplitPdf","ForLoopBlockYamlLoopBlocksItem_Task","ForLoopBlockYamlLoopBlocksItem_TaskV2","ForLoopBlockYamlLoopBlocksItem_TextPrompt",@@ -1740,6 +1936,22 @@ __all__ = ["OutputParameter","OutputParameterYaml","PasswordCredentialResponse",+ "PdfFillBlock",+ "PdfFillBlockParametersItem",+ "PdfFillBlockParametersItem_AwsSecret",+ "PdfFillBlockParametersItem_AzureSecret",+ "PdfFillBlockParametersItem_AzureVaultCredential",+ "PdfFillBlockParametersItem_BitwardenCreditCardData",+ "PdfFillBlockParametersItem_BitwardenLoginCredential",+ "PdfFillBlockParametersItem_BitwardenSensitiveInformation",+ "PdfFillBlockParametersItem_Context",+ "PdfFillBlockParametersItem_Credential",+ "PdfFillBlockParametersItem_Onepassword",+ "PdfFillBlockParametersItem_Output",+ "PdfFillBlockParametersItem_Workflow",+ "PdfFillBlockPayload",+ "PdfFillBlockYaml",+ "PdfFillBlockYamlPayload","PdfFormat","PdfParserBlock","PdfParserBlockYaml",@@ -1776,6 +1988,10 @@ __all__ = ["RunSdkActionRequestAction_Validate","RunSdkActionResponse","RunStatus",+ "RunTagHistoryResponse",+ "RunTagsBatchResponse",+ "RunTagsResponse",+ "RunType","RunWebhookReplayResponse","SchedulesListAllRequestStatus","Script",@@ -1792,6 +2008,21 @@ __all__ = ["SkyvernEnvironment","SkyvernForgeSdkSchemasCredentialsCredentialType","SkyvernSchemasCredentialTypeCredentialType",+ "SplitPdfBlock",+ "SplitPdfBlockParametersItem",+ "SplitPdfBlockParametersItem_AwsSecret",+ "SplitPdfBlockParametersItem_AzureSecret",+ "SplitPdfBlockParametersItem_AzureVaultCredential",+ "SplitPdfBlockParametersItem_BitwardenCreditCardData",+ "SplitPdfBlockParametersItem_BitwardenLoginCredential",+ "SplitPdfBlockParametersItem_BitwardenSensitiveInformation",+ "SplitPdfBlockParametersItem_Context",+ "SplitPdfBlockParametersItem_Credential",+ "SplitPdfBlockParametersItem_Onepassword",+ "SplitPdfBlockParametersItem_Output",+ "SplitPdfBlockParametersItem_Workflow",+ "SplitPdfBlockYaml",+ "TagApplyRequest","TagDeleteInput","TagHistoryItem","TagHistoryResponse",@@ -1800,6 +2031,9 @@ __all__ = ["TagKey","TagKeyDeleteResponse","TagResponse",+ "TagValue",+ "TagValueDeleteResponse",+ "TagValueRenameResponse","TagsResponse","TaskBlock","TaskBlockDataSchema",@@ -1910,6 +2144,7 @@ __all__ = ["WhileLoopBlockLoopBlocksItem_Code","WhileLoopBlockLoopBlocksItem_Conditional","WhileLoopBlockLoopBlocksItem_DownloadToS3",+ "WhileLoopBlockLoopBlocksItem_EmailInbox","WhileLoopBlockLoopBlocksItem_Extraction","WhileLoopBlockLoopBlocksItem_FileDownload","WhileLoopBlockLoopBlocksItem_FileUpload",@@ -1922,9 +2157,11 @@ __all__ = ["WhileLoopBlockLoopBlocksItem_HumanInteraction","WhileLoopBlockLoopBlocksItem_Login","WhileLoopBlockLoopBlocksItem_Navigation",+ "WhileLoopBlockLoopBlocksItem_PdfFill","WhileLoopBlockLoopBlocksItem_PdfParser","WhileLoopBlockLoopBlocksItem_PrintPage","WhileLoopBlockLoopBlocksItem_SendEmail",+ "WhileLoopBlockLoopBlocksItem_SplitPdf","WhileLoopBlockLoopBlocksItem_Task","WhileLoopBlockLoopBlocksItem_TaskV2","WhileLoopBlockLoopBlocksItem_TextPrompt",@@ -1939,6 +2176,7 @@ __all__ = ["WhileLoopBlockYamlLoopBlocksItem_Code","WhileLoopBlockYamlLoopBlocksItem_Conditional","WhileLoopBlockYamlLoopBlocksItem_DownloadToS3",+ "WhileLoopBlockYamlLoopBlocksItem_EmailInbox","WhileLoopBlockYamlLoopBlocksItem_Extraction","WhileLoopBlockYamlLoopBlocksItem_FileDownload","WhileLoopBlockYamlLoopBlocksItem_FileUpload",@@ -1951,9 +2189,11 @@ __all__ = ["WhileLoopBlockYamlLoopBlocksItem_HumanInteraction","WhileLoopBlockYamlLoopBlocksItem_Login","WhileLoopBlockYamlLoopBlocksItem_Navigation",+ "WhileLoopBlockYamlLoopBlocksItem_PdfFill","WhileLoopBlockYamlLoopBlocksItem_PdfParser","WhileLoopBlockYamlLoopBlocksItem_PrintPage","WhileLoopBlockYamlLoopBlocksItem_SendEmail",+ "WhileLoopBlockYamlLoopBlocksItem_SplitPdf","WhileLoopBlockYamlLoopBlocksItem_Task","WhileLoopBlockYamlLoopBlocksItem_TaskV2","WhileLoopBlockYamlLoopBlocksItem_TextPrompt",@@ -1971,6 +2211,7 @@ __all__ = ["WorkflowDefinitionBlocksItem_Code","WorkflowDefinitionBlocksItem_Conditional","WorkflowDefinitionBlocksItem_DownloadToS3",+ "WorkflowDefinitionBlocksItem_EmailInbox","WorkflowDefinitionBlocksItem_Extraction","WorkflowDefinitionBlocksItem_FileDownload","WorkflowDefinitionBlocksItem_FileUpload",@@ -1983,9 +2224,11 @@ __all__ = ["WorkflowDefinitionBlocksItem_HumanInteraction","WorkflowDefinitionBlocksItem_Login","WorkflowDefinitionBlocksItem_Navigation",+ "WorkflowDefinitionBlocksItem_PdfFill","WorkflowDefinitionBlocksItem_PdfParser","WorkflowDefinitionBlocksItem_PrintPage","WorkflowDefinitionBlocksItem_SendEmail",+ "WorkflowDefinitionBlocksItem_SplitPdf","WorkflowDefinitionBlocksItem_Task","WorkflowDefinitionBlocksItem_TaskV2","WorkflowDefinitionBlocksItem_TextPrompt",@@ -2012,6 +2255,7 @@ __all__ = ["WorkflowDefinitionYamlBlocksItem_Code","WorkflowDefinitionYamlBlocksItem_Conditional","WorkflowDefinitionYamlBlocksItem_DownloadToS3",+ "WorkflowDefinitionYamlBlocksItem_EmailInbox","WorkflowDefinitionYamlBlocksItem_Extraction","WorkflowDefinitionYamlBlocksItem_FileDownload","WorkflowDefinitionYamlBlocksItem_FileUpload",@@ -2024,9 +2268,11 @@ __all__ = ["WorkflowDefinitionYamlBlocksItem_HumanInteraction","WorkflowDefinitionYamlBlocksItem_Login","WorkflowDefinitionYamlBlocksItem_Navigation",+ "WorkflowDefinitionYamlBlocksItem_PdfFill","WorkflowDefinitionYamlBlocksItem_PdfParser","WorkflowDefinitionYamlBlocksItem_PrintPage","WorkflowDefinitionYamlBlocksItem_SendEmail",+ "WorkflowDefinitionYamlBlocksItem_SplitPdf","WorkflowDefinitionYamlBlocksItem_Task","WorkflowDefinitionYamlBlocksItem_TaskV2","WorkflowDefinitionYamlBlocksItem_TextPrompt",diff --git a/skyvern/client/client.py b/skyvern/client/client.pyindex ccf9194e2..a76bd2074 100644--- a/skyvern/client/client.py+++ b/skyvern/client/client.py@@ -15,6 +15,7 @@ from .types.artifact_type import ArtifactTypefrom .types.browser_profile import BrowserProfilefrom .types.browser_session_response import BrowserSessionResponsefrom .types.bulk_cancel_runs_response import BulkCancelRunsResponse+from .types.clear_organization_auth_token_response import ClearOrganizationAuthTokenResponsefrom .types.create_browser_profile_request_proxy_location import CreateBrowserProfileRequestProxyLocationfrom .types.create_browser_session_request_proxy_location import CreateBrowserSessionRequestProxyLocationfrom .types.create_credential_request_credential import CreateCredentialRequestCredential@@ -22,6 +23,9 @@ from .types.create_credential_request_proxy_location import CreateCredentialRequfrom .types.create_script_response import CreateScriptResponsefrom .types.credential_response import CredentialResponsefrom .types.credential_vault_type import CredentialVaultType+from .types.custom_llm_config import CustomLlmConfig+from .types.custom_llm_list_response import CustomLlmListResponse+from .types.custom_llm_response import CustomLlmResponsefrom .types.extensions import Extensionsfrom .types.folder import Folderfrom .types.get_run_response import GetRunResponse@@ -33,6 +37,10 @@ from .types.run_engine import RunEnginefrom .types.run_sdk_action_request_action import RunSdkActionRequestActionfrom .types.run_sdk_action_response import RunSdkActionResponsefrom .types.run_status import RunStatus+from .types.run_tag_history_response import RunTagHistoryResponse+from .types.run_tags_batch_response import RunTagsBatchResponse+from .types.run_tags_response import RunTagsResponse+from .types.run_type import RunTypefrom .types.run_webhook_replay_response import RunWebhookReplayResponsefrom .types.script import Scriptfrom .types.script_file_create import ScriptFileCreate@@ -43,6 +51,9 @@ from .types.tag_history_response import TagHistoryResponsefrom .types.tag_input import TagInputfrom .types.tag_key import TagKeyfrom .types.tag_key_delete_response import TagKeyDeleteResponse+from .types.tag_value import TagValue+from .types.tag_value_delete_response import TagValueDeleteResponse+from .types.tag_value_rename_response import TagValueRenameResponsefrom .types.tags_response import TagsResponsefrom .types.task_run_list_item import TaskRunListItemfrom .types.task_run_request_input_data_extraction_schema import TaskRunRequestInputDataExtractionSchema@@ -1041,19 +1052,24 @@ class Skyvern:)return _response.data- def list_tag_keys(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[TagKey]:+ def get_run_tags(+ self, workflow_run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsResponse:"""- List all tag keys registered for the organization with their descriptions.+ Get the current tag state for a workflow run.Parameters----------+ workflow_run_id : str+ Workflow run ID+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[TagKey]- Successfully retrieved tag keys+ RunTagsResponse+ Successfully retrieved tagsExamples--------@@ -1062,29 +1078,46 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.list_tag_keys()+ client.get_run_tags(+ workflow_run_id="wr_123",+ )"""- _response = self._raw_client.list_tag_keys(request_options=request_options)+ _response = self._raw_client.get_run_tags(workflow_run_id, request_options=request_options)return _response.data- def delete_tag_key(- self, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> TagKeyDeleteResponse:+ def apply_run_tags(+ self,+ workflow_run_id: str,+ *,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> RunTagsResponse:"""- Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.+ Atomically apply tag changes to a workflow run. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.Parameters----------- key : str- Tag key to delete+ workflow_run_id : str+ Workflow run ID++ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.++ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.++ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagKeyDeleteResponse- Successfully deleted tag key+ RunTagsResponse+ Successfully applied tag changesExamples--------@@ -1093,38 +1126,36 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.delete_tag_key(- key="env",+ client.apply_run_tags(+ workflow_run_id="wr_123",)"""- _response = self._raw_client.delete_tag_key(key, request_options=request_options)+ _response = self._raw_client.apply_run_tags(+ workflow_run_id, tags=tags, tags_to_delete=tags_to_delete, colors=colors, request_options=request_options+ )return _response.data- def update_tag_key(- self,- key: str,- *,- description: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> TagKey:+ def delete_run_tag(+ self, workflow_run_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsResponse:"""- Update the description for a tag key.+ Soft-delete a single grouped tag from a workflow run. Writes a DELETE event row.Parameters----------- key : str- Tag key to update+ workflow_run_id : str+ Workflow run ID- description : typing.Optional[str]- Free-form description (max 500 chars). Pass null to clear.+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagKey- Successfully updated tag key+ RunTagsResponse+ Successfully deleted tag (or no-op if absent)Examples--------@@ -1133,72 +1164,84 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.update_tag_key(- key="key",+ client.delete_run_tag(+ workflow_run_id="wr_123",+ key="env",)"""- _response = self._raw_client.update_tag_key(key, description=description, request_options=request_options)+ _response = self._raw_client.delete_run_tag(workflow_run_id, key, request_options=request_options)return _response.data- def batch_get_workflow_tags(+ def get_run_tag_history(self,+ workflow_run_id: str,*,- workflow_permanent_ids: typing.Optional[str] = None,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowTagsBatchResponse:+ ) -> RunTagHistoryResponse:"""- Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.+ Chronological tag-event log for a workflow run (newest first). Includes SET and DELETE events.Parameters----------- workflow_permanent_ids : typing.Optional[str]- Comma-separated workflow permanent IDs+ workflow_run_id : str+ Workflow run ID++ limit : typing.Optional[int]+ Max events to return++ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowTagsBatchResponse- Successfully retrieved tags+ RunTagHistoryResponse+ Successfully retrieved tag historyExamples--------+ import datetime+from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.batch_get_workflow_tags(- workflow_permanent_ids="workflow_permanent_ids",+ client.get_run_tag_history(+ workflow_run_id="wr_123",+ limit=1,+ since=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ key="key",)"""- _response = self._raw_client.batch_get_workflow_tags(- workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ _response = self._raw_client.get_run_tag_history(+ workflow_run_id, limit=limit, since=since, key=key, request_options=request_options)return _response.data- def batch_get_workflow_tags_post(- self,- *,- workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowTagsBatchResponse:+ def list_tag_keys(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[TagKey]:"""- Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).+ List all tag keys registered for the organization with their descriptions.Parameters----------- workflow_permanent_ids : typing.Optional[typing.Sequence[str]]- Workflow permanent IDs to fetch tags for.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowTagsBatchResponse- Successfully retrieved tags+ typing.List[TagKey]+ Successfully retrieved tag keysExamples--------@@ -1207,37 +1250,29 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.batch_get_workflow_tags_post()+ client.list_tag_keys()"""- _response = self._raw_client.batch_get_workflow_tags_post(- workflow_permanent_ids=workflow_permanent_ids, request_options=request_options- )+ _response = self._raw_client.list_tag_keys(request_options=request_options)return _response.data- def get_run_artifacts(- self,- run_id: str,- *,- artifact_type: typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[Artifact]:+ def delete_tag_key(+ self, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> TagKeyDeleteResponse:"""- Get artifacts for a run+ Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.Parameters----------- run_id : str- The id of the task run or the workflow run.-- artifact_type : typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]]+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[Artifact]- Successful Response+ TagKeyDeleteResponse+ Successfully deleted tag keyExamples--------@@ -1246,73 +1281,71 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_run_artifacts(- run_id="run_id",+ client.delete_tag_key(+ key="env",)"""- _response = self._raw_client.get_run_artifacts(- run_id, artifact_type=artifact_type, request_options=request_options- )+ _response = self._raw_client.delete_tag_key(key, request_options=request_options)return _response.data- def retry_run_webhook(+ def update_tag_key(self,- run_id: str,+ key: str,*,- request: typing.Optional[RetryRunWebhookRequest] = None,+ description: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> RunWebhookReplayResponse:+ ) -> TagKey:"""- Retry sending the webhook for a run+ Update the description for a tag key.Parameters----------- run_id : str- The id of the task run or the workflow run.+ key : str+ Tag key to update- request : typing.Optional[RetryRunWebhookRequest]+ description : typing.Optional[str]+ Free-form description (max 500 chars). Pass null to clear.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- RunWebhookReplayResponse- Successful Response+ TagKey+ Successfully updated tag keyExamples--------- from skyvern import RetryRunWebhookRequest, Skyvern+ from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.retry_run_webhook(- run_id="tsk_123",- request=RetryRunWebhookRequest(),+ client.update_tag_key(+ key="key",)"""- _response = self._raw_client.retry_run_webhook(run_id, request=request, request_options=request_options)+ _response = self._raw_client.update_tag_key(key, description=description, request_options=request_options)return _response.data- def get_run_timeline(- self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> typing.List[WorkflowRunTimeline]:+ def list_tag_values(+ self, *, key: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.List[TagValue]:"""- Get timeline for a run (workflow run or task_v2 run)+ List the palette color and current workflow usage count for each grouped tag (key, value) for the organization. The frontend joins these onto tags by (key, value); workflow_count is the number of non-deleted workflows carrying the label and powers the per-label usage and delete blast-radius warnings.Parameters----------- run_id : str- The id of the workflow run or task_v2 run.+ key : typing.Optional[str]+ Filter to values for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[WorkflowRunTimeline]- Successfully retrieved run timeline+ typing.List[TagValue]+ Successfully retrieved tag valuesExamples--------@@ -1321,26 +1354,34 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_run_timeline(- run_id="wr_123",+ client.list_tag_values(+ key="key",)"""- _response = self._raw_client.get_run_timeline(run_id, request_options=request_options)+ _response = self._raw_client.list_tag_values(key=key, request_options=request_options)return _response.data- def get_version(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Dict[str, str]:+ def delete_tag_value(+ self, key: str, *, value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValueDeleteResponse:"""- Returns the current Skyvern server version (git SHA for official builds).+ Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.Parameters----------+ key : str+ Tag key (group)++ value : str+ Tag value (label) under the key to soft-delete.+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.Dict[str, str]- Current server version+ TagValueDeleteResponse+ Successfully deleted tag valueExamples--------@@ -1349,39 +1390,38 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_version()+ client.delete_tag_value(+ key="env",+ value="value",+ )"""- _response = self._raw_client.get_version(request_options=request_options)+ _response = self._raw_client.delete_tag_value(key, value=value, request_options=request_options)return _response.data- def get_runs_v2(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,- search_key: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[TaskRunListItem]:+ def update_tag_value(+ self, key: str, *, value: str, color: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValue:"""+ Recolor a grouped tag (key, value). The value is supplied in the body so values containing '/' stay addressable. The new color must be a palette name.+Parameters----------- page : typing.Optional[int]-- page_size : typing.Optional[int]+ key : str+ Tag key (group)- status : typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]]+ value : str+ Tag value (label) under the key to recolor.- search_key : typing.Optional[str]- Case-insensitive substring search (min 3 chars for trigram index).+ color : str+ Palette color name to assign to this (key, value).request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[TaskRunListItem]- Successful Response+ TagValue+ Successfully recolored tag valueExamples--------@@ -1390,30 +1430,39 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_runs_v2(- page=1,- page_size=1,- search_key="search_key",+ client.update_tag_value(+ key="env",+ value="value",+ color="color",)"""- _response = self._raw_client.get_runs_v2(- page=page, page_size=page_size, status=status, search_key=search_key, request_options=request_options- )+ _response = self._raw_client.update_tag_value(key, value=value, color=color, request_options=request_options)return _response.data- def upload_file(self, *, file: str, request_options: typing.Optional[RequestOptions] = None) -> UploadFileResponse:+ def rename_tag_value(+ self, key: str, *, value: str, new_value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValueRenameResponse:"""+ Rename a grouped tag (key, value) to (key, new_value). The cascade re-tags every workflow carrying the old label; the new label inherits the old color. Both values ride in the body so values containing '/' stay addressable. Rejects with 409 when the new value already exists for the key.+Parameters----------- file : str+ key : str+ Tag key (group)++ value : str+ Current tag value (label) under the key to rename.++ new_value : str+ New tag value (label) to rename it to.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- UploadFileResponse- Successful Response+ TagValueRenameResponse+ Successfully renamed tag valueExamples--------@@ -1422,44 +1471,38 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.upload_file(- file="file",+ client.rename_tag_value(+ key="env",+ value="value",+ new_value="new_value",)"""- _response = self._raw_client.upload_file(file=file, request_options=request_options)+ _response = self._raw_client.rename_tag_value(+ key, value=value, new_value=new_value, request_options=request_options+ )return _response.data- def list_browser_profiles(+ def batch_get_workflow_tags(self,*,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- include_deleted: typing.Optional[bool] = None,- search_key: typing.Optional[str] = None,+ workflow_permanent_ids: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[BrowserProfile]:+ ) -> WorkflowTagsBatchResponse:"""- Get all browser profiles for the organization+ Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.Parameters----------- page : typing.Optional[int]-- page_size : typing.Optional[int]-- include_deleted : typing.Optional[bool]- Include deleted browser profiles-- search_key : typing.Optional[str]- Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.+ workflow_permanent_ids : typing.Optional[str]+ Comma-separated workflow permanent IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[BrowserProfile]- Successfully retrieved browser profiles+ WorkflowTagsBatchResponse+ Successfully retrieved tagsExamples--------@@ -1468,63 +1511,69 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.list_browser_profiles(- page=1,- page_size=1,- include_deleted=True,- search_key="search_key",+ client.batch_get_workflow_tags(+ workflow_permanent_ids="workflow_permanent_ids",)"""- _response = self._raw_client.list_browser_profiles(- page=page,- page_size=page_size,- include_deleted=include_deleted,- search_key=search_key,- request_options=request_options,+ _response = self._raw_client.batch_get_workflow_tags(+ workflow_permanent_ids=workflow_permanent_ids, request_options=request_options)return _response.data- def create_browser_profile(+ def batch_get_workflow_tags_post(self,*,- name: str,- description: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[CreateBrowserProfileRequestProxyLocation] = OMIT,- proxy_session_id: typing.Optional[str] = OMIT,+ workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> BrowserProfile:+ ) -> WorkflowTagsBatchResponse:"""- Create a blank browser profile, or create one from a persistent browser session or workflow run.+ Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).Parameters----------- name : str- Name for the browser profile+ workflow_permanent_ids : typing.Optional[typing.Sequence[str]]+ Workflow permanent IDs to fetch tags for.- description : typing.Optional[str]- Optional profile description+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- browser_session_id : typing.Optional[str]- Persistent browser session to convert into a profile. Omit for a blank profile.+ Returns+ -------+ WorkflowTagsBatchResponse+ Successfully retrieved tags- workflow_run_id : typing.Optional[str]- Workflow run whose persisted session should be captured. Omit for a blank profile.+ Examples+ --------+ from skyvern import Skyvern- proxy_location : typing.Optional[CreateBrowserProfileRequestProxyLocation]- Optional proxy location for this profile's pinned proxy identity.+ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.batch_get_workflow_tags_post()+ """+ _response = self._raw_client.batch_get_workflow_tags_post(+ workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ )+ return _response.data- proxy_session_id : typing.Optional[str]- Explicit sticky-session id for this profile's pinned proxy identity.+ def batch_get_run_tags(+ self, *, workflow_run_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsBatchResponse:+ """+ Batch fetch current tags for many workflow runs. Avoids N+1 on run-list pages.++ Parameters+ ----------+ workflow_run_ids : typing.Optional[str]+ Comma-separated workflow run IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserProfile- Successfully created browser profile+ RunTagsBatchResponse+ Successfully retrieved tagsExamples--------@@ -1533,39 +1582,36 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.create_browser_profile(- name="name",+ client.batch_get_run_tags(+ workflow_run_ids="workflow_run_ids",)"""- _response = self._raw_client.create_browser_profile(- name=name,- description=description,- browser_session_id=browser_session_id,- workflow_run_id=workflow_run_id,- proxy_location=proxy_location,- proxy_session_id=proxy_session_id,- request_options=request_options,+ _response = self._raw_client.batch_get_run_tags(+ workflow_run_ids=workflow_run_ids, request_options=request_options)return _response.data- def get_browser_profile(- self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> BrowserProfile:+ def batch_get_run_tags_post(+ self,+ *,+ workflow_run_ids: typing.Optional[typing.Sequence[str]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> RunTagsBatchResponse:"""- Get a specific browser profile by ID+ Batch fetch current tags for many workflow runs (POST variant for id lists exceeding URL length).Parameters----------- profile_id : str- The ID of the browser profile. browser_profile_id starts with `bp_`+ workflow_run_ids : typing.Optional[typing.Sequence[str]]+ Workflow run IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserProfile- Successfully retrieved browser profile+ RunTagsBatchResponse+ Successfully retrieved tagsExamples--------@@ -1574,30 +1620,37 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_browser_profile(- profile_id="bp_123456",- )+ client.batch_get_run_tags_post()"""- _response = self._raw_client.get_browser_profile(profile_id, request_options=request_options)+ _response = self._raw_client.batch_get_run_tags_post(+ workflow_run_ids=workflow_run_ids, request_options=request_options+ )return _response.data- def delete_browser_profile(- self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> None:+ def get_run_artifacts(+ self,+ run_id: str,+ *,+ artifact_type: typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[Artifact]:"""- Delete a browser profile (soft delete)+ Get artifacts for a runParameters----------- profile_id : str- The ID of the browser profile to delete. browser_profile_id starts with `bp_`+ run_id : str+ The id of the task run or the workflow run.++ artifact_type : typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- None+ typing.List[Artifact]+ Successful ResponseExamples--------@@ -1606,54 +1659,73 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.delete_browser_profile(- profile_id="bp_123456",+ client.get_run_artifacts(+ run_id="run_id",)"""- _response = self._raw_client.delete_browser_profile(profile_id, request_options=request_options)+ _response = self._raw_client.get_run_artifacts(+ run_id, artifact_type=artifact_type, request_options=request_options+ )return _response.data- def update_browser_profile(+ def retry_run_webhook(self,- profile_id: str,+ run_id: str,*,- name: typing.Optional[str] = OMIT,- description: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[UpdateBrowserProfileRequestProxyLocation] = OMIT,- proxy_session_id: typing.Optional[str] = OMIT,- rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ request: typing.Optional[RetryRunWebhookRequest] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> BrowserProfile:+ ) -> RunWebhookReplayResponse:"""- Update a browser profile's name and/or description+ Retry sending the webhook for a runParameters----------- profile_id : str- The ID of the browser profile to update. browser_profile_id starts with `bp_`+ run_id : str+ The id of the task run or the workflow run.- name : typing.Optional[str]- New name for the browser profile+ request : typing.Optional[RetryRunWebhookRequest]- description : typing.Optional[str]- New description for the browser profile+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- proxy_location : typing.Optional[UpdateBrowserProfileRequestProxyLocation]- Optional proxy location for this profile's pinned proxy identity.+ Returns+ -------+ RunWebhookReplayResponse+ Successful Response- proxy_session_id : typing.Optional[str]- Opaque Skyvern-managed proxy sticky-session id.+ Examples+ --------+ from skyvern import RetryRunWebhookRequest, Skyvern- rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id for this profile.+ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.retry_run_webhook(+ run_id="tsk_123",+ request=RetryRunWebhookRequest(),+ )+ """+ _response = self._raw_client.retry_run_webhook(run_id, request=request, request_options=request_options)+ return _response.data++ def get_run_timeline(+ self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.List[WorkflowRunTimeline]:+ """+ Get timeline for a run (workflow run or task_v2 run)++ Parameters+ ----------+ run_id : str+ The id of the workflow run or task_v2 run.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserProfile- Successfully updated browser profile+ typing.List[WorkflowRunTimeline]+ Successfully retrieved run timelineExamples--------@@ -1662,26 +1734,16 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.update_browser_profile(- profile_id="bp_123456",+ client.get_run_timeline(+ run_id="wr_123",)"""- _response = self._raw_client.update_browser_profile(- profile_id,- name=name,- description=description,- proxy_location=proxy_location,- proxy_session_id=proxy_session_id,- rotate_proxy_session_id=rotate_proxy_session_id,- request_options=request_options,- )+ _response = self._raw_client.get_run_timeline(run_id, request_options=request_options)return _response.data- def get_browser_sessions(- self, *, request_options: typing.Optional[RequestOptions] = None- ) -> typing.List[BrowserSessionResponse]:+ def get_version(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Dict[str, str]:"""- Get all active browser sessions for the organization+ Returns the current Skyvern server version (git SHA for official builds).Parameters----------@@ -1690,8 +1752,8 @@ class Skyvern:Returns-------- typing.List[BrowserSessionResponse]- Successfully retrieved all active browser sessions+ typing.Dict[str, str]+ Current server versionExamples--------@@ -1700,86 +1762,42 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_browser_sessions()+ client.get_version()"""- _response = self._raw_client.get_browser_sessions(request_options=request_options)+ _response = self._raw_client.get_version(request_options=request_options)return _response.data- def create_browser_session(+ def get_runs_v2(self,*,- timeout: typing.Optional[int] = OMIT,- proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,- extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,- browser_type: typing.Optional[PersistentBrowserType] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- generate_browser_profile: typing.Optional[bool] = OMIT,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ run_type: typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> BrowserSessionResponse:+ ) -> typing.List[TaskRunListItem]:"""- Create a browser session that persists across multiple runs-Parameters----------- timeout : typing.Optional[int]- Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.+ page : typing.Optional[int]- proxy_location : typing.Optional[CreateBrowserSessionRequestProxyLocation]+ page_size : typing.Optional[int]- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.+ status : typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]]- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy-- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}-- extensions : typing.Optional[typing.Sequence[Extensions]]- A list of extensions to install in the browser session.-- browser_type : typing.Optional[PersistentBrowserType]- The type of browser to use for the session.-- browser_profile_id : typing.Optional[str]- ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`.+ search_key : typing.Optional[str]+ Case-insensitive substring search (min 3 chars for trigram index).- generate_browser_profile : typing.Optional[bool]- When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.+ run_type : typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserSessionResponse- Successfully created browser session+ typing.List[TaskRunListItem]+ Successful ResponseExamples--------@@ -1788,37 +1806,35 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.create_browser_session()+ client.get_runs_v2(+ page=1,+ page_size=1,+ search_key="search_key",+ )"""- _response = self._raw_client.create_browser_session(- timeout=timeout,- proxy_location=proxy_location,- extensions=extensions,- browser_type=browser_type,- browser_profile_id=browser_profile_id,- generate_browser_profile=generate_browser_profile,+ _response = self._raw_client.get_runs_v2(+ page=page,+ page_size=page_size,+ status=status,+ search_key=search_key,+ run_type=run_type,request_options=request_options,)return _response.data- def close_browser_session(- self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> typing.Optional[typing.Any]:+ def upload_file(self, *, file: str, request_options: typing.Optional[RequestOptions] = None) -> UploadFileResponse:"""- Close a session. Once closed, the session cannot be used again.-Parameters----------- browser_session_id : str- The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`+ file : strrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.Optional[typing.Any]- Successfully closed browser session+ UploadFileResponse+ Successful ResponseExamples--------@@ -1827,31 +1843,48 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.close_browser_session(- browser_session_id="pbs_123456",+ client.upload_file(+ file="file",)"""- _response = self._raw_client.close_browser_session(browser_session_id, request_options=request_options)+ _response = self._raw_client.upload_file(file=file, request_options=request_options)return _response.data- def get_browser_session(- self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> BrowserSessionResponse:+ def list_browser_profiles(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ include_deleted: typing.Optional[bool] = None,+ search_key: typing.Optional[str] = None,+ managed: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[BrowserProfile]:"""- Get details about a specific browser session, including the browser address for cdp connection.+ Get all browser profiles for the organizationParameters----------- browser_session_id : str- The ID of the browser session. browser_session_id starts with `pbs_`+ page : typing.Optional[int]++ page_size : typing.Optional[int]++ include_deleted : typing.Optional[bool]+ Include deleted browser profiles++ search_key : typing.Optional[str]+ Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.++ managed : typing.Optional[bool]+ Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserSessionResponse- Successfully retrieved browser session details+ typing.List[BrowserProfile]+ Successfully retrieved browser profilesExamples--------@@ -1860,38 +1893,65 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_browser_session(- browser_session_id="pbs_123456",+ client.list_browser_profiles(+ page=1,+ page_size=1,+ include_deleted=True,+ search_key="search_key",+ managed=True,)"""- _response = self._raw_client.get_browser_session(browser_session_id, request_options=request_options)+ _response = self._raw_client.list_browser_profiles(+ page=page,+ page_size=page_size,+ include_deleted=include_deleted,+ search_key=search_key,+ managed=managed,+ request_options=request_options,+ )return _response.data- def update_browser_session(+ def create_browser_profile(self,- browser_session_id: str,*,- generate_browser_profile: bool,+ name: str,+ description: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[CreateBrowserProfileRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> BrowserSessionResponse:+ ) -> BrowserProfile:"""- Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.+ Create a blank browser profile, or create one from a persistent browser session or workflow run.Parameters----------- browser_session_id : str- The ID of the browser session. browser_session_id starts with `pbs_`+ name : str+ Name for the browser profile- generate_browser_profile : bool- Enable or disable saving this session's browser profile when it ends. Can be toggled while the session is still alive; the value is read at session teardown.+ description : typing.Optional[str]+ Optional profile description++ browser_session_id : typing.Optional[str]+ Persistent browser session to convert into a profile. Omit for a blank profile.++ workflow_run_id : typing.Optional[str]+ Workflow run whose persisted session should be captured. Omit for a blank profile.++ proxy_location : typing.Optional[CreateBrowserProfileRequestProxyLocation]+ Optional proxy location for this profile's pinned proxy identity.++ proxy_session_id : typing.Optional[str]+ Explicit sticky-session id for this profile's pinned proxy identity.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BrowserSessionResponse- Successfully updated browser session+ BrowserProfile+ Successfully created browser profileExamples--------@@ -1900,65 +1960,39 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.update_browser_session(- browser_session_id="pbs_123456",- generate_browser_profile=True,+ client.create_browser_profile(+ name="name",)"""- _response = self._raw_client.update_browser_session(- browser_session_id, generate_browser_profile=generate_browser_profile, request_options=request_options+ _response = self._raw_client.create_browser_profile(+ name=name,+ description=description,+ browser_session_id=browser_session_id,+ workflow_run_id=workflow_run_id,+ proxy_location=proxy_location,+ proxy_session_id=proxy_session_id,+ request_options=request_options,)return _response.data- def send_totp_code(- self,- *,- totp_identifier: str,- content: str,- task_id: typing.Optional[str] = OMIT,- workflow_id: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- source: typing.Optional[str] = OMIT,- expired_at: typing.Optional[dt.datetime] = OMIT,- type: typing.Optional[OtpType] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> TotpCode:+ def get_browser_profile(+ self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> BrowserProfile:"""- Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.+ Get a specific browser profile by IDParameters----------- totp_identifier : str- The identifier of the TOTP code. It can be the email address, phone number, or the identifier of the user.-- content : str- The content of the TOTP code. It can be the email content that contains the TOTP code, or the sms message that contains the TOTP code. Skyvern will automatically extract the TOTP code from the content.-- task_id : typing.Optional[str]- The task_id the totp code is for. It can be the task_id of the task that the TOTP code is for.-- workflow_id : typing.Optional[str]- The workflow ID the TOTP code is for. It can be the workflow ID of the workflow that the TOTP code is for.-- workflow_run_id : typing.Optional[str]- The workflow run id that the TOTP code is for. It can be the workflow run id of the workflow run that the TOTP code is for.-- source : typing.Optional[str]- An optional field. The source of the TOTP code. e.g. email, sms, etc.-- expired_at : typing.Optional[dt.datetime]- The timestamp when the TOTP code expires-- type : typing.Optional[OtpType]- Optional. If provided, forces extraction of this specific OTP type (totp or magic_link). Use this when the content contains multiple OTP types and you want to specify which one to extract.+ profile_id : str+ The ID of the browser profile. browser_profile_id starts with `bp_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TotpCode- Successful Response+ BrowserProfile+ Successfully retrieved browser profileExamples--------@@ -1967,61 +2001,30 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.send_totp_code(- totp_identifier="[email protected]",- content="Hello, your verification code is 123456",+ client.get_browser_profile(+ profile_id="bp_123456",)"""- _response = self._raw_client.send_totp_code(- totp_identifier=totp_identifier,- content=content,- task_id=task_id,- workflow_id=workflow_id,- workflow_run_id=workflow_run_id,- source=source,- expired_at=expired_at,- type=type,- request_options=request_options,- )+ _response = self._raw_client.get_browser_profile(profile_id, request_options=request_options)return _response.data- def get_credentials(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- vault_type: typing.Optional[CredentialVaultType] = None,- credential_type: typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType] = None,- search: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[CredentialResponse]:+ def delete_browser_profile(+ self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> None:"""- Retrieves a paginated list of credentials for the current organization+ Delete a browser profile (soft delete)Parameters----------- page : typing.Optional[int]- Page number for pagination-- page_size : typing.Optional[int]- Number of items per page-- vault_type : typing.Optional[CredentialVaultType]- Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')-- credential_type : typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType]- Filter credentials by type (e.g. 'password', 'credit_card', 'secret')-- search : typing.Optional[str]- Case-insensitive search across credential name, username, secret label, and card details+ profile_id : str+ The ID of the browser profile to delete. browser_profile_id starts with `bp_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[CredentialResponse]- Successful Response+ NoneExamples--------@@ -2030,91 +2033,70 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_credentials(- page=1,- page_size=10,- vault_type="skyvern",- credential_type="password",- search="search",+ client.delete_browser_profile(+ profile_id="bp_123456",)"""- _response = self._raw_client.get_credentials(- page=page,- page_size=page_size,- vault_type=vault_type,- credential_type=credential_type,- search=search,- request_options=request_options,- )+ _response = self._raw_client.delete_browser_profile(profile_id, request_options=request_options)return _response.data- def create_credential(+ def update_browser_profile(self,+ profile_id: str,*,- name: str,- credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,- credential: CreateCredentialRequestCredential,- vault_type: typing.Optional[CredentialVaultType] = OMIT,- proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ name: typing.Optional[str] = OMIT,+ description: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[UpdateBrowserProfileRequestProxyLocation] = OMIT,proxy_session_id: typing.Optional[str] = OMIT,rotate_proxy_session_id: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> CredentialResponse:+ ) -> BrowserProfile:"""- Creates a new credential for the current organization+ Update a browser profile's name and/or descriptionParameters----------- name : str- Name of the credential-- credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType- Type of credential to create+ profile_id : str+ The ID of the browser profile to update. browser_profile_id starts with `bp_`- credential : CreateCredentialRequestCredential- The credential data to store+ name : typing.Optional[str]+ New name for the browser profile- vault_type : typing.Optional[CredentialVaultType]- Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.+ description : typing.Optional[str]+ New description for the browser profile- proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]- Optional proxy location for this credential's pinned proxy identity.+ proxy_location : typing.Optional[UpdateBrowserProfileRequestProxyLocation]+ Optional proxy location for this profile's pinned proxy identity.proxy_session_id : typing.Optional[str]- Optional advanced reuse key for this credential's pinned proxy identity.+ Opaque Skyvern-managed proxy sticky-session id.rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id when updating this credential.+ Rotate the Skyvern-managed proxy sticky-session id for this profile.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- CredentialResponse- Successful Response+ BrowserProfile+ Successfully updated browser profileExamples--------- from skyvern import NonEmptyPasswordCredential, Skyvern+ from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.create_credential(- name="Amazon Login",- credential_type="password",- credential=NonEmptyPasswordCredential(- password="securepassword123",- username="[email protected]",- ),+ client.update_browser_profile(+ profile_id="bp_123456",)"""- _response = self._raw_client.create_credential(+ _response = self._raw_client.update_browser_profile(+ profile_id,name=name,- credential_type=credential_type,- credential=credential,- vault_type=vault_type,+ description=description,proxy_location=proxy_location,proxy_session_id=proxy_session_id,rotate_proxy_session_id=rotate_proxy_session_id,@@ -2122,101 +2104,153 @@ class Skyvern:)return _response.data- def update_credential(+ def get_browser_sessions(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.List[BrowserSessionResponse]:+ """+ Get all active browser sessions for the organization++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ typing.List[BrowserSessionResponse]+ Successfully retrieved all active browser sessions++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_browser_sessions()+ """+ _response = self._raw_client.get_browser_sessions(request_options=request_options)+ return _response.data++ def create_browser_session(self,- credential_id: str,*,- name: str,- credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,- credential: CreateCredentialRequestCredential,- vault_type: typing.Optional[CredentialVaultType] = OMIT,- proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ timeout: typing.Optional[int] = OMIT,+ proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,proxy_session_id: typing.Optional[str] = OMIT,- rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,+ browser_type: typing.Optional[PersistentBrowserType] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ generate_browser_profile: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> CredentialResponse:+ ) -> BrowserSessionResponse:"""- Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.+ Create a browser session that persists across multiple runsParameters----------- credential_id : str- The unique identifier of the credential to update-- name : str- Name of the credential+ timeout : typing.Optional[int]+ Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.- credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType- Type of credential to create+ proxy_location : typing.Optional[CreateBrowserSessionRequestProxyLocation]- credential : CreateCredentialRequestCredential- The credential data to store+ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.- vault_type : typing.Optional[CredentialVaultType]- Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.+ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy- proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]- Optional proxy location for this credential's pinned proxy identity.+ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}proxy_session_id : typing.Optional[str]- Optional advanced reuse key for this credential's pinned proxy identity.+ Opaque Skyvern-managed proxy sticky-session id for pinned Residential ISP sessions.- rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id when updating this credential.+ extensions : typing.Optional[typing.Sequence[Extensions]]+ A list of extensions to install in the browser session.++ browser_type : typing.Optional[PersistentBrowserType]+ The type of browser to use for the session.++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`.++ generate_browser_profile : typing.Optional[bool]+ When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- CredentialResponse- Successful Response+ BrowserSessionResponse+ Successfully created browser sessionExamples--------- from skyvern import NonEmptyPasswordCredential, Skyvern+ from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.update_credential(- credential_id="cred_1234567890",- name="Amazon Login",- credential_type="password",- credential=NonEmptyPasswordCredential(- password="securepassword123",- username="[email protected]",- ),- )+ client.create_browser_session()"""- _response = self._raw_client.update_credential(- credential_id,- name=name,- credential_type=credential_type,- credential=credential,- vault_type=vault_type,+ _response = self._raw_client.create_browser_session(+ timeout=timeout,proxy_location=proxy_location,proxy_session_id=proxy_session_id,- rotate_proxy_session_id=rotate_proxy_session_id,+ extensions=extensions,+ browser_type=browser_type,+ browser_profile_id=browser_profile_id,+ generate_browser_profile=generate_browser_profile,request_options=request_options,)return _response.data- def delete_credential(self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:+ def close_browser_session(+ self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.Optional[typing.Any]:"""- Deletes a specific credential by its ID+ Close a session. Once closed, the session cannot be used again.Parameters----------- credential_id : str- The unique identifier of the credential to delete+ browser_session_id : str+ The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- None+ typing.Optional[typing.Any]+ Successfully closed browser sessionExamples--------@@ -2225,31 +2259,31 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.delete_credential(- credential_id="cred_1234567890",+ client.close_browser_session(+ browser_session_id="pbs_123456",)"""- _response = self._raw_client.delete_credential(credential_id, request_options=request_options)+ _response = self._raw_client.close_browser_session(browser_session_id, request_options=request_options)return _response.data- def get_credential(- self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> CredentialResponse:+ def get_browser_session(+ self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> BrowserSessionResponse:"""- Retrieves a specific credential by its ID+ Get details about a specific browser session, including the browser address for cdp connection.Parameters----------- credential_id : str- The unique identifier of the credential+ browser_session_id : str+ The ID of the browser session. browser_session_id starts with `pbs_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- CredentialResponse- Successful Response+ BrowserSessionResponse+ Successfully retrieved browser session detailsExamples--------@@ -2258,121 +2292,38 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_credential(- credential_id="cred_1234567890",+ client.get_browser_session(+ browser_session_id="pbs_123456",)"""- _response = self._raw_client.get_credential(credential_id, request_options=request_options)+ _response = self._raw_client.get_browser_session(browser_session_id, request_options=request_options)return _response.data- def login(+ def update_browser_session(self,+ browser_session_id: str,*,- credential_type: SkyvernSchemasCredentialTypeCredentialType,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[ProxyLocation] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_screenshot_scrolling_times: typing.Optional[int] = OMIT,- prompt: typing.Optional[str] = OMIT,- credential_id: typing.Optional[str] = OMIT,- bitwarden_collection_id: typing.Optional[str] = OMIT,- bitwarden_item_id: typing.Optional[str] = OMIT,- onepassword_vault_id: typing.Optional[str] = OMIT,- onepassword_item_id: typing.Optional[str] = OMIT,- azure_vault_name: typing.Optional[str] = OMIT,- azure_vault_username_key: typing.Optional[str] = OMIT,- azure_vault_password_key: typing.Optional[str] = OMIT,- azure_vault_totp_secret_key: typing.Optional[str] = OMIT,+ generate_browser_profile: bool,request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowRunResponse:+ ) -> BrowserSessionResponse:"""- Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure Vault+ Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.Parameters----------- credential_type : SkyvernSchemasCredentialTypeCredentialType- Where to get the credential from-- user_agent : typing.Optional[str]-- url : typing.Optional[str]- Website URL-- webhook_url : typing.Optional[str]- Webhook URL to send status updates-- proxy_location : typing.Optional[ProxyLocation]- Proxy location to use-- totp_identifier : typing.Optional[str]- Identifier for TOTP (Time-based One-Time Password) if required-- totp_url : typing.Optional[str]- TOTP URL to fetch one-time passwords-- browser_session_id : typing.Optional[str]- ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`-- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this run-- browser_address : typing.Optional[str]- The CDP address for the task.-- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- Additional HTTP headers to include in requests-- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.-- max_screenshot_scrolling_times : typing.Optional[int]- Maximum number of times to scroll for screenshots-- prompt : typing.Optional[str]- Login instructions. Skyvern has default prompt/instruction for login if this field is not provided.-- credential_id : typing.Optional[str]- ID of the Skyvern credential to use for login.-- bitwarden_collection_id : typing.Optional[str]- Bitwarden collection ID. You can find it in the Bitwarden collection URL. e.g. `https://vault.bitwarden.com/vaults/collection_id/items`-- bitwarden_item_id : typing.Optional[str]- Bitwarden item ID-- onepassword_vault_id : typing.Optional[str]- 1Password vault ID-- onepassword_item_id : typing.Optional[str]- 1Password item ID-- azure_vault_name : typing.Optional[str]- Azure Vault Name-- azure_vault_username_key : typing.Optional[str]- Azure Vault username key-- azure_vault_password_key : typing.Optional[str]- Azure Vault password key+ browser_session_id : str+ The ID of the browser session. browser_session_id starts with `pbs_`- azure_vault_totp_secret_key : typing.Optional[str]- Azure Vault TOTP secret key+ generate_browser_profile : bool+ Enable or disable saving this session's browser profile when it ends. Can be toggled while the session is still alive; the value is read at session teardown.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowRunResponse- Successful Response+ BrowserSessionResponse+ Successfully updated browser sessionExamples--------@@ -2381,118 +2332,64 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.login(- user_agent="x-user-agent",- credential_type="skyvern",+ client.update_browser_session(+ browser_session_id="pbs_123456",+ generate_browser_profile=True,)"""- _response = self._raw_client.login(- credential_type=credential_type,- user_agent=user_agent,- url=url,- webhook_url=webhook_url,- proxy_location=proxy_location,- totp_identifier=totp_identifier,- totp_url=totp_url,- browser_session_id=browser_session_id,- browser_profile_id=browser_profile_id,- browser_address=browser_address,- extra_http_headers=extra_http_headers,- cdp_connect_headers=cdp_connect_headers,- max_screenshot_scrolling_times=max_screenshot_scrolling_times,- prompt=prompt,- credential_id=credential_id,- bitwarden_collection_id=bitwarden_collection_id,- bitwarden_item_id=bitwarden_item_id,- onepassword_vault_id=onepassword_vault_id,- onepassword_item_id=onepassword_item_id,- azure_vault_name=azure_vault_name,- azure_vault_username_key=azure_vault_username_key,- azure_vault_password_key=azure_vault_password_key,- azure_vault_totp_secret_key=azure_vault_totp_secret_key,- request_options=request_options,+ _response = self._raw_client.update_browser_session(+ browser_session_id, generate_browser_profile=generate_browser_profile, request_options=request_options)return _response.data- def download_files(+ def send_totp_code(self,*,- navigation_goal: str,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[ProxyLocation] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_screenshot_scrolling_times: typing.Optional[int] = OMIT,- download_suffix: typing.Optional[str] = OMIT,- download_timeout: typing.Optional[float] = OMIT,- max_steps_per_run: typing.Optional[int] = OMIT,+ totp_identifier: str,+ content: str,+ task_id: typing.Optional[str] = OMIT,+ workflow_id: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ source: typing.Optional[str] = OMIT,+ expired_at: typing.Optional[dt.datetime] = OMIT,+ type: typing.Optional[OtpType] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowRunResponse:+ ) -> TotpCode:"""- Download a file from a website by navigating and clicking download buttons+ Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.Parameters----------- navigation_goal : str- Instructions for navigating to and downloading the file-- user_agent : typing.Optional[str]-- url : typing.Optional[str]- Website URL-- webhook_url : typing.Optional[str]- Webhook URL to send status updates-- proxy_location : typing.Optional[ProxyLocation]- Proxy location to use-- totp_identifier : typing.Optional[str]- Identifier for TOTP (Time-based One-Time Password) if required-- totp_url : typing.Optional[str]- TOTP URL to fetch one-time passwords-- browser_session_id : typing.Optional[str]- ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`-- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this run+ totp_identifier : str+ The identifier of the TOTP code. It can be the email address, phone number, or the identifier of the user.- browser_address : typing.Optional[str]- The CDP address for the task.+ content : str+ The content of the TOTP code. It can be the email content that contains the TOTP code, or the sms message that contains the TOTP code. Skyvern will automatically extract the TOTP code from the content.- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- Additional HTTP headers to include in requests+ task_id : typing.Optional[str]+ The task_id the totp code is for. It can be the task_id of the task that the TOTP code is for.- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.+ workflow_id : typing.Optional[str]+ The workflow ID the TOTP code is for. It can be the workflow ID of the workflow that the TOTP code is for.- max_screenshot_scrolling_times : typing.Optional[int]- Maximum number of times to scroll for screenshots+ workflow_run_id : typing.Optional[str]+ The workflow run id that the TOTP code is for. It can be the workflow run id of the workflow run that the TOTP code is for.- download_suffix : typing.Optional[str]- Suffix or complete filename for the downloaded file+ source : typing.Optional[str]+ An optional field. The source of the TOTP code. e.g. email, sms, etc.- download_timeout : typing.Optional[float]- Timeout in seconds for the download operation+ expired_at : typing.Optional[dt.datetime]+ The timestamp when the TOTP code expires- max_steps_per_run : typing.Optional[int]- Maximum number of steps to execute+ type : typing.Optional[OtpType]+ Optional. If provided, forces extraction of this specific OTP type (totp or magic_link). Use this when the content contains multiple OTP types and you want to specify which one to extract.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowRunResponse+ TotpCodeSuccessful ResponseExamples@@ -2502,41 +2399,36 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.download_files(- user_agent="x-user-agent",- navigation_goal="navigation_goal",+ client.send_totp_code(+ totp_identifier="[email protected]",+ content="Hello, your verification code is 123456",)"""- _response = self._raw_client.download_files(- navigation_goal=navigation_goal,- user_agent=user_agent,- url=url,- webhook_url=webhook_url,- proxy_location=proxy_location,+ _response = self._raw_client.send_totp_code(totp_identifier=totp_identifier,- totp_url=totp_url,- browser_session_id=browser_session_id,- browser_profile_id=browser_profile_id,- browser_address=browser_address,- extra_http_headers=extra_http_headers,- cdp_connect_headers=cdp_connect_headers,- max_screenshot_scrolling_times=max_screenshot_scrolling_times,- download_suffix=download_suffix,- download_timeout=download_timeout,- max_steps_per_run=max_steps_per_run,+ content=content,+ task_id=task_id,+ workflow_id=workflow_id,+ workflow_run_id=workflow_run_id,+ source=source,+ expired_at=expired_at,+ type=type,request_options=request_options,)return _response.data- def get_scripts(+ def get_credentials(self,*,page: typing.Optional[int] = None,page_size: typing.Optional[int] = None,+ vault_type: typing.Optional[CredentialVaultType] = None,+ credential_type: typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType] = None,+ search: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[Script]:+ ) -> typing.List[CredentialResponse]:"""- Retrieves a paginated list of scripts for the current organization+ Retrieves a paginated list of credentials for the current organizationParameters----------@@ -2546,12 +2438,21 @@ class Skyvern:page_size : typing.Optional[int]Number of items per page+ vault_type : typing.Optional[CredentialVaultType]+ Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')++ credential_type : typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType]+ Filter credentials by type (e.g. 'password', 'credit_card', 'secret')++ search : typing.Optional[str]+ Case-insensitive search across credential name, username, secret label, and card details+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[Script]+ typing.List[CredentialResponse]Successful ResponseExamples@@ -2561,220 +2462,254 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_scripts(+ client.get_credentials(page=1,page_size=10,+ vault_type="skyvern",+ credential_type="password",+ search="search",)"""- _response = self._raw_client.get_scripts(page=page, page_size=page_size, request_options=request_options)+ _response = self._raw_client.get_credentials(+ page=page,+ page_size=page_size,+ vault_type=vault_type,+ credential_type=credential_type,+ search=search,+ request_options=request_options,+ )return _response.data- def create_script(+ def create_credential(self,*,- workflow_id: typing.Optional[str] = OMIT,- run_id: typing.Optional[str] = OMIT,- files: typing.Optional[typing.Sequence[ScriptFileCreate]] = OMIT,+ name: str,+ credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,+ credential: CreateCredentialRequestCredential,+ vault_type: typing.Optional[CredentialVaultType] = OMIT,+ proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ rotate_proxy_session_id: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> CreateScriptResponse:+ ) -> CredentialResponse:"""- Create a new script with optional files and metadata+ Creates a new credential for the current organizationParameters----------- workflow_id : typing.Optional[str]- Associated workflow ID+ name : str+ Name of the credential- run_id : typing.Optional[str]- Associated run ID+ credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType+ Type of credential to create- files : typing.Optional[typing.Sequence[ScriptFileCreate]]- Array of files to include in the script+ credential : CreateCredentialRequestCredential+ The credential data to store++ vault_type : typing.Optional[CredentialVaultType]+ Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.++ proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]+ Optional proxy location for this credential's pinned proxy identity.++ proxy_session_id : typing.Optional[str]+ Optional advanced reuse key for this credential's pinned proxy identity.++ rotate_proxy_session_id : typing.Optional[bool]+ Rotate the Skyvern-managed proxy sticky-session id when updating this credential.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- CreateScriptResponse+ CredentialResponseSuccessful ResponseExamples--------- from skyvern import Skyvern+ from skyvern import NonEmptyPasswordCredential, Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.create_script()+ client.create_credential(+ name="Amazon Login",+ credential_type="password",+ credential=NonEmptyPasswordCredential(+ password="securepassword123",+ username="[email protected]",+ ),+ )"""- _response = self._raw_client.create_script(- workflow_id=workflow_id, run_id=run_id, files=files, request_options=request_options+ _response = self._raw_client.create_credential(+ name=name,+ credential_type=credential_type,+ credential=credential,+ vault_type=vault_type,+ proxy_location=proxy_location,+ proxy_session_id=proxy_session_id,+ rotate_proxy_session_id=rotate_proxy_session_id,+ request_options=request_options,)return _response.data- def get_script(self, script_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Script:+ def update_credential(+ self,+ credential_id: str,+ *,+ name: str,+ credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,+ credential: CreateCredentialRequestCredential,+ vault_type: typing.Optional[CredentialVaultType] = OMIT,+ proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> CredentialResponse:"""- Retrieves a specific script by its ID+ Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.Parameters----------- script_id : str- The unique identifier of the script+ credential_id : str+ The unique identifier of the credential to update++ name : str+ Name of the credential++ credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType+ Type of credential to create++ credential : CreateCredentialRequestCredential+ The credential data to store++ vault_type : typing.Optional[CredentialVaultType]+ Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.++ proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]+ Optional proxy location for this credential's pinned proxy identity.++ proxy_session_id : typing.Optional[str]+ Optional advanced reuse key for this credential's pinned proxy identity.++ rotate_proxy_session_id : typing.Optional[bool]+ Rotate the Skyvern-managed proxy sticky-session id when updating this credential.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Script+ CredentialResponseSuccessful ResponseExamples--------- from skyvern import Skyvern+ from skyvern import NonEmptyPasswordCredential, Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.get_script(- script_id="s_abc123",+ client.update_credential(+ credential_id="cred_1234567890",+ name="Amazon Login",+ credential_type="password",+ credential=NonEmptyPasswordCredential(+ password="securepassword123",+ username="[email protected]",+ ),)"""- _response = self._raw_client.get_script(script_id, request_options=request_options)+ _response = self._raw_client.update_credential(+ credential_id,+ name=name,+ credential_type=credential_type,+ credential=credential,+ vault_type=vault_type,+ proxy_location=proxy_location,+ proxy_session_id=proxy_session_id,+ rotate_proxy_session_id=rotate_proxy_session_id,+ request_options=request_options,+ )return _response.data- def deploy_script(- self,- script_id: str,- *,- files: typing.Sequence[ScriptFileCreate],- request_options: typing.Optional[RequestOptions] = None,- ) -> CreateScriptResponse:+ def delete_credential(self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:"""- Deploy a script with updated files, creating a new version+ Deletes a specific credential by its IDParameters----------- script_id : str- The unique identifier of the script-- files : typing.Sequence[ScriptFileCreate]- Array of files to include in the script+ credential_id : str+ The unique identifier of the credential to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- CreateScriptResponse- Successful Response+ NoneExamples--------- from skyvern import ScriptFileCreate, Skyvern+ from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.deploy_script(- script_id="s_abc123",- files=[- ScriptFileCreate(- path="src/main.py",- content="content",- )- ],+ client.delete_credential(+ credential_id="cred_1234567890",)"""- _response = self._raw_client.deploy_script(script_id, files=files, request_options=request_options)+ _response = self._raw_client.delete_credential(credential_id, request_options=request_options)return _response.data- def run_sdk_action(- self,- *,- url: str,- action: RunSdkActionRequestAction,- browser_session_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> RunSdkActionResponse:+ def get_credential(+ self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> CredentialResponse:"""- Execute a single SDK action with the specified parameters+ Retrieves a specific credential by its IDParameters----------- url : str- The URL where the action should be executed-- action : RunSdkActionRequestAction- The action to execute with its specific parameters-- browser_session_id : typing.Optional[str]- The browser session ID-- browser_address : typing.Optional[str]- The browser address-- workflow_run_id : typing.Optional[str]- Optional workflow run ID to continue an existing workflow run+ credential_id : str+ The unique identifier of the credentialrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- RunSdkActionResponse+ CredentialResponseSuccessful ResponseExamples--------- from skyvern import RunSdkActionRequestAction_AiAct, Skyvern+ from skyvern import Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.run_sdk_action(- url="url",- action=RunSdkActionRequestAction_AiAct(),- )- """- _response = self._raw_client.run_sdk_action(- url=url,- action=action,- browser_session_id=browser_session_id,- browser_address=browser_address,- workflow_run_id=workflow_run_id,- request_options=request_options,+ client.get_credential(+ credential_id="cred_1234567890",)+ """+ _response = self._raw_client.get_credential(credential_id, request_options=request_options)return _response.data- def update_workflow_folder(- self,- workflow_permanent_id: str,- *,- folder_id: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> Workflow:+ def list_custom_llms(self, *, request_options: typing.Optional[RequestOptions] = None) -> CustomLlmListResponse:"""- Update a workflow's folder assignment for the latest version+ List the custom LLM configurations available to the current organization.Parameters----------- workflow_permanent_id : str- Workflow permanent ID-- folder_id : typing.Optional[str]- Folder ID to assign workflow to. Set to null to remove from folder.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Workflow- Successfully updated workflow folder+ CustomLlmListResponse+ Successful ResponseExamples--------@@ -2783,115 +2718,105 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.update_workflow_folder(- workflow_permanent_id="wpid_123",- )+ client.list_custom_llms()"""- _response = self._raw_client.update_workflow_folder(- workflow_permanent_id, folder_id=folder_id, request_options=request_options- )+ _response = self._raw_client.list_custom_llms(request_options=request_options)return _response.data- def get_workflow_tags(- self, workflow_permanent_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> TagsResponse:+ def create_custom_llm(+ self, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> CustomLlmResponse:"""- Get the current tag state for a workflow.+ Create a custom LLM configuration for the current organization.Parameters----------- workflow_permanent_id : str- Workflow permanent ID+ config : CustomLlmConfigrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagsResponse- Successfully retrieved tags+ CustomLlmResponse+ Successful ResponseExamples--------- from skyvern import Skyvern+ from skyvern import CustomLlmConfig, Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.get_workflow_tags(- workflow_permanent_id="wpid_123",+ client.create_custom_llm(+ config=CustomLlmConfig(+ display_name="display_name",+ provider="openai_compatible",+ model_name="model_name",+ ),)"""- _response = self._raw_client.get_workflow_tags(workflow_permanent_id, request_options=request_options)+ _response = self._raw_client.create_custom_llm(config=config, request_options=request_options)return _response.data- def apply_workflow_tags(- self,- workflow_permanent_id: str,- *,- tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,- tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> TagsResponse:+ def update_custom_llm(+ self, custom_llm_id: str, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> CustomLlmResponse:"""- Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.+ Update a custom LLM configuration for the current organization.Parameters----------- workflow_permanent_id : str- Workflow permanent ID+ custom_llm_id : str+ The custom LLM id.- tags : typing.Optional[typing.Sequence[TagInput]]- Tags to set (overwrite). List of {key?, value} objects.-- tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]- Tags to soft-delete. List of {key?, value?} targets.+ config : CustomLlmConfigrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagsResponse- Successfully applied tag changes+ CustomLlmResponse+ Successful ResponseExamples--------- from skyvern import Skyvern+ from skyvern import CustomLlmConfig, Skyvernclient = Skyvern(api_key="YOUR_API_KEY",)- client.apply_workflow_tags(- workflow_permanent_id="wpid_123",+ client.update_custom_llm(+ custom_llm_id="custom_llm_id",+ config=CustomLlmConfig(+ display_name="display_name",+ provider="openai_compatible",+ model_name="model_name",+ ),)"""- _response = self._raw_client.apply_workflow_tags(- workflow_permanent_id, tags=tags, tags_to_delete=tags_to_delete, request_options=request_options- )+ _response = self._raw_client.update_custom_llm(custom_llm_id, config=config, request_options=request_options)return _response.data- def delete_workflow_tag(- self, workflow_permanent_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> TagsResponse:+ def delete_custom_llm(+ self, custom_llm_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> ClearOrganizationAuthTokenResponse:"""- Soft-delete a single tag from a workflow. Writes a DELETE event row.+ Delete a custom LLM configuration for the current organization.Parameters----------- workflow_permanent_id : str- Workflow permanent ID-- key : str- Tag key to delete+ custom_llm_id : str+ The custom LLM id.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagsResponse- Successfully deleted tag (or no-op if absent)+ ClearOrganizationAuthTokenResponse+ Successful ResponseExamples--------@@ -2900,90 +2825,113 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.delete_workflow_tag(- workflow_permanent_id="wpid_123",- key="env",+ client.delete_custom_llm(+ custom_llm_id="custom_llm_id",)"""- _response = self._raw_client.delete_workflow_tag(workflow_permanent_id, key, request_options=request_options)+ _response = self._raw_client.delete_custom_llm(custom_llm_id, request_options=request_options)return _response.data- def get_workflow_tag_history(+ def login(self,- workflow_permanent_id: str,*,- limit: typing.Optional[int] = None,- since: typing.Optional[dt.datetime] = None,- key: typing.Optional[str] = None,+ credential_type: SkyvernSchemasCredentialTypeCredentialType,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[ProxyLocation] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_screenshot_scrolling_times: typing.Optional[int] = OMIT,+ prompt: typing.Optional[str] = OMIT,+ credential_id: typing.Optional[str] = OMIT,+ bitwarden_collection_id: typing.Optional[str] = OMIT,+ bitwarden_item_id: typing.Optional[str] = OMIT,+ onepassword_vault_id: typing.Optional[str] = OMIT,+ onepassword_item_id: typing.Optional[str] = OMIT,+ azure_vault_name: typing.Optional[str] = OMIT,+ azure_vault_username_key: typing.Optional[str] = OMIT,+ azure_vault_password_key: typing.Optional[str] = OMIT,+ azure_vault_totp_secret_key: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> TagHistoryResponse:+ ) -> WorkflowRunResponse:"""- Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.+ Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure VaultParameters----------- workflow_permanent_id : str- Workflow permanent ID+ credential_type : SkyvernSchemasCredentialTypeCredentialType+ Where to get the credential from- limit : typing.Optional[int]- Max events to return+ user_agent : typing.Optional[str]- since : typing.Optional[dt.datetime]- Only return events at or after this timestamp+ url : typing.Optional[str]+ Website URL- key : typing.Optional[str]- Filter to events for a single tag key+ webhook_url : typing.Optional[str]+ Webhook URL to send status updates- request_options : typing.Optional[RequestOptions]- Request-specific configuration.+ proxy_location : typing.Optional[ProxyLocation]+ Proxy location to use- Returns- -------- TagHistoryResponse- Successfully retrieved tag history+ totp_identifier : typing.Optional[str]+ Identifier for TOTP (Time-based One-Time Password) if required- Examples- --------- import datetime+ totp_url : typing.Optional[str]+ TOTP URL to fetch one-time passwords- from skyvern import Skyvern+ browser_session_id : typing.Optional[str]+ ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`- client = Skyvern(- api_key="YOUR_API_KEY",- )- client.get_workflow_tag_history(- workflow_permanent_id="wpid_123",- limit=1,- since=datetime.datetime.fromisoformat(- "2024-01-15 09:30:00+00:00",- ),- key="key",- )- """- _response = self._raw_client.get_workflow_tag_history(- workflow_permanent_id, limit=limit, since=since, key=key, request_options=request_options- )- return _response.data+ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this run- def retry_workflow_run(- self,- workflow_run_id: str,- *,- max_steps_override: typing.Optional[int] = None,- user_agent: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowRunResponse:- """- Retry a workflow run using the original run parameters.+ browser_address : typing.Optional[str]+ The CDP address for the task.- Parameters- ----------- workflow_run_id : str- The id of the workflow run to retry.+ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Additional HTTP headers to include in requests- max_steps_override : typing.Optional[int]+ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.- user_agent : typing.Optional[str]+ max_screenshot_scrolling_times : typing.Optional[int]+ Maximum number of times to scroll for screenshots++ prompt : typing.Optional[str]+ Login instructions. Skyvern has default prompt/instruction for login if this field is not provided.++ credential_id : typing.Optional[str]+ ID of the Skyvern credential to use for login.++ bitwarden_collection_id : typing.Optional[str]+ Bitwarden collection ID. You can find it in the Bitwarden collection URL. e.g. `https://vault.bitwarden.com/vaults/collection_id/items`++ bitwarden_item_id : typing.Optional[str]+ Bitwarden item ID++ onepassword_vault_id : typing.Optional[str]+ 1Password vault ID++ onepassword_item_id : typing.Optional[str]+ 1Password item ID++ azure_vault_name : typing.Optional[str]+ Azure Vault Name++ azure_vault_username_key : typing.Optional[str]+ Azure Vault username key++ azure_vault_password_key : typing.Optional[str]+ Azure Vault password key++ azure_vault_totp_secret_key : typing.Optional[str]+ Azure Vault TOTP secret keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -2991,7 +2939,7 @@ class Skyvern:Returns-------WorkflowRunResponse- Successfully retried workflow run+ Successful ResponseExamples--------@@ -3000,83 +2948,118 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.retry_workflow_run(- workflow_run_id="wr_123",- max_steps_override=1,+ client.login(user_agent="x-user-agent",+ credential_type="skyvern",)"""- _response = self._raw_client.retry_workflow_run(- workflow_run_id,- max_steps_override=max_steps_override,+ _response = self._raw_client.login(+ credential_type=credential_type,user_agent=user_agent,- request_options=request_options,- )- return _response.data-- def get_workflow_runs(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,- search_key: typing.Optional[str] = None,- error_code: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[WorkflowRun]:- """- List workflow runs across all workflows for the current organization.+ url=url,+ webhook_url=webhook_url,+ proxy_location=proxy_location,+ totp_identifier=totp_identifier,+ totp_url=totp_url,+ browser_session_id=browser_session_id,+ browser_profile_id=browser_profile_id,+ browser_address=browser_address,+ extra_http_headers=extra_http_headers,+ cdp_connect_headers=cdp_connect_headers,+ max_screenshot_scrolling_times=max_screenshot_scrolling_times,+ prompt=prompt,+ credential_id=credential_id,+ bitwarden_collection_id=bitwarden_collection_id,+ bitwarden_item_id=bitwarden_item_id,+ onepassword_vault_id=onepassword_vault_id,+ onepassword_item_id=onepassword_item_id,+ azure_vault_name=azure_vault_name,+ azure_vault_username_key=azure_vault_username_key,+ azure_vault_password_key=azure_vault_password_key,+ azure_vault_totp_secret_key=azure_vault_totp_secret_key,+ request_options=request_options,+ )+ return _response.data- Results are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.+ def download_files(+ self,+ *,+ navigation_goal: str,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[ProxyLocation] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_screenshot_scrolling_times: typing.Optional[int] = OMIT,+ download_suffix: typing.Optional[str] = OMIT,+ download_timeout: typing.Optional[float] = OMIT,+ max_steps_per_run: typing.Optional[int] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> WorkflowRunResponse:+ """+ Download a file from a website by navigating and clicking download buttons- ### search_key+ Parameters+ ----------+ navigation_goal : str+ Instructions for navigating to and downloading the file- A case-insensitive substring search that matches against **any** of the following fields:+ user_agent : typing.Optional[str]- | Searched field | Description |- |---|---|- | `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |- | Parameter **key** | The `key` of any workflow parameter definition associated with the run |- | Parameter **description** | The `description` of any workflow parameter definition |- | Run parameter **value** | The actual value supplied for any parameter when the run was created |- | `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |+ url : typing.Optional[str]+ Website URL- Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.+ webhook_url : typing.Optional[str]+ Webhook URL to send status updates- ### error_code+ proxy_location : typing.Optional[ProxyLocation]+ Proxy location to use- An **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).+ totp_identifier : typing.Optional[str]+ Identifier for TOTP (Time-based One-Time Password) if required- ### Combining filters+ totp_url : typing.Optional[str]+ TOTP URL to fetch one-time passwords- All query parameters use AND logic:- - `?status=failed` — only failed runs- - `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error- - `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match+ browser_session_id : typing.Optional[str]+ ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`- Parameters- ----------- page : typing.Optional[int]- Page number for pagination.+ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this run- page_size : typing.Optional[int]- Number of runs to return per page.+ browser_address : typing.Optional[str]+ The CDP address for the task.- status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]- Filter by one or more run statuses.+ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Additional HTTP headers to include in requests- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.+ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.- error_code : typing.Optional[str]- Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ max_screenshot_scrolling_times : typing.Optional[int]+ Maximum number of times to scroll for screenshots++ download_suffix : typing.Optional[str]+ Suffix or complete filename for the downloaded file++ download_timeout : typing.Optional[float]+ Timeout in seconds for the download operation++ max_steps_per_run : typing.Optional[int]+ Maximum number of steps to executerequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[WorkflowRun]+ WorkflowRunResponseSuccessful ResponseExamples@@ -3086,72 +3069,56 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_workflow_runs(- page=1,- page_size=1,- search_key="search_key",- error_code="error_code",+ client.download_files(+ user_agent="x-user-agent",+ navigation_goal="navigation_goal",)"""- _response = self._raw_client.get_workflow_runs(- page=page,- page_size=page_size,- status=status,- search_key=search_key,- error_code=error_code,+ _response = self._raw_client.download_files(+ navigation_goal=navigation_goal,+ user_agent=user_agent,+ url=url,+ webhook_url=webhook_url,+ proxy_location=proxy_location,+ totp_identifier=totp_identifier,+ totp_url=totp_url,+ browser_session_id=browser_session_id,+ browser_profile_id=browser_profile_id,+ browser_address=browser_address,+ extra_http_headers=extra_http_headers,+ cdp_connect_headers=cdp_connect_headers,+ max_screenshot_scrolling_times=max_screenshot_scrolling_times,+ download_suffix=download_suffix,+ download_timeout=download_timeout,+ max_steps_per_run=max_steps_per_run,request_options=request_options,)return _response.data- def get_workflow_runs_by_id(+ def get_scripts(self,- workflow_id: str,*,page: typing.Optional[int] = None,page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,- search_key: typing.Optional[str] = None,- error_code: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[WorkflowRun]:+ ) -> typing.List[Script]:"""- List runs for a specific workflow.-- Supports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.-- ### search_key-- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.-- ### error_code-- Exact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.+ Retrieves a paginated list of scripts for the current organizationParameters----------- workflow_id : str-page : typing.Optional[int]- Page number for pagination.+ Page number for paginationpage_size : typing.Optional[int]- Number of runs to return per page.-- status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]- Filter by one or more run statuses.-- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.-- error_code : typing.Optional[str]- Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ Number of items per pagerequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[WorkflowRun]+ typing.List[Script]Successful ResponseExamples@@ -3161,48 +3128,42 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_workflow_runs_by_id(- workflow_id="workflow_id",+ client.get_scripts(page=1,- page_size=1,- search_key="search_key",- error_code="error_code",+ page_size=10,)"""- _response = self._raw_client.get_workflow_runs_by_id(- workflow_id,- page=page,- page_size=page_size,- status=status,- search_key=search_key,- error_code=error_code,- request_options=request_options,- )+ _response = self._raw_client.get_scripts(page=page, page_size=page_size, request_options=request_options)return _response.data- def get_workflow(+ def create_script(self,- workflow_permanent_id: str,*,- version: typing.Optional[int] = None,- template: typing.Optional[bool] = None,+ workflow_id: typing.Optional[str] = OMIT,+ run_id: typing.Optional[str] = OMIT,+ files: typing.Optional[typing.Sequence[ScriptFileCreate]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> Workflow:+ ) -> CreateScriptResponse:"""+ Create a new script with optional files and metadata+Parameters----------- workflow_permanent_id : str+ workflow_id : typing.Optional[str]+ Associated workflow ID- version : typing.Optional[int]+ run_id : typing.Optional[str]+ Associated run ID- template : typing.Optional[bool]+ files : typing.Optional[typing.Sequence[ScriptFileCreate]]+ Array of files to include in the scriptrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Workflow+ CreateScriptResponseSuccessful ResponseExamples@@ -3212,39 +3173,28 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_workflow(- workflow_permanent_id="workflow_permanent_id",- version=1,- template=True,- )+ client.create_script()"""- _response = self._raw_client.get_workflow(- workflow_permanent_id, version=version, template=template, request_options=request_options+ _response = self._raw_client.create_script(+ workflow_id=workflow_id, run_id=run_id, files=files, request_options=request_options)return _response.data- def get_workflow_versions(- self,- workflow_permanent_id: str,- *,- template: typing.Optional[bool] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[Workflow]:+ def get_script(self, script_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Script:"""- Get all versions of a workflow by its permanent ID.+ Retrieves a specific script by its IDParameters----------- workflow_permanent_id : str-- template : typing.Optional[bool]+ script_id : str+ The unique identifier of the scriptrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[Workflow]+ ScriptSuccessful ResponseExamples@@ -3254,276 +3204,1456 @@ class Skyvern:client = Skyvern(api_key="YOUR_API_KEY",)- client.get_workflow_versions(- workflow_permanent_id="workflow_permanent_id",- template=True,+ client.get_script(+ script_id="s_abc123",)"""- _response = self._raw_client.get_workflow_versions(+ _response = self._raw_client.get_script(script_id, request_options=request_options)+ return _response.data++ def deploy_script(+ self,+ script_id: str,+ *,+ files: typing.Sequence[ScriptFileCreate],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> CreateScriptResponse:+ """+ Deploy a script with updated files, creating a new version++ Parameters+ ----------+ script_id : str+ The unique identifier of the script++ files : typing.Sequence[ScriptFileCreate]+ Array of files to include in the script++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CreateScriptResponse+ Successful Response++ Examples+ --------+ from skyvern import ScriptFileCreate, Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.deploy_script(+ script_id="s_abc123",+ files=[+ ScriptFileCreate(+ path="src/main.py",+ content="content",+ )+ ],+ )+ """+ _response = self._raw_client.deploy_script(script_id, files=files, request_options=request_options)+ return _response.data++ def run_sdk_action(+ self,+ *,+ url: str,+ action: RunSdkActionRequestAction,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> RunSdkActionResponse:+ """+ Execute a single SDK action with the specified parameters++ Parameters+ ----------+ url : str+ The URL where the action should be executed++ action : RunSdkActionRequestAction+ The action to execute with its specific parameters++ browser_session_id : typing.Optional[str]+ The browser session ID++ browser_address : typing.Optional[str]+ The browser address++ workflow_run_id : typing.Optional[str]+ Optional workflow run ID to continue an existing workflow run++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ RunSdkActionResponse+ Successful Response++ Examples+ --------+ from skyvern import RunSdkActionRequestAction_AiAct, Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.run_sdk_action(+ url="url",+ action=RunSdkActionRequestAction_AiAct(),+ )+ """+ _response = self._raw_client.run_sdk_action(+ url=url,+ action=action,+ browser_session_id=browser_session_id,+ browser_address=browser_address,+ workflow_run_id=workflow_run_id,+ request_options=request_options,+ )+ return _response.data++ def update_workflow_folder(+ self,+ workflow_permanent_id: str,+ *,+ folder_id: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Workflow:+ """+ Update a workflow's folder assignment for the latest version++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ folder_id : typing.Optional[str]+ Folder ID to assign workflow to. Set to null to remove from folder.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ Workflow+ Successfully updated workflow folder++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.update_workflow_folder(+ workflow_permanent_id="wpid_123",+ )+ """+ _response = self._raw_client.update_workflow_folder(+ workflow_permanent_id, folder_id=folder_id, request_options=request_options+ )+ return _response.data++ def get_workflow_tags(+ self, workflow_permanent_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> TagsResponse:+ """+ Get the current tag state for a workflow.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ TagsResponse+ Successfully retrieved tags++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow_tags(+ workflow_permanent_id="wpid_123",+ )+ """+ _response = self._raw_client.get_workflow_tags(workflow_permanent_id, request_options=request_options)+ return _response.data++ def apply_workflow_tags(+ self,+ workflow_permanent_id: str,+ *,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> TagsResponse:+ """+ Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.++ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.++ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ TagsResponse+ Successfully applied tag changes++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.apply_workflow_tags(+ workflow_permanent_id="wpid_123",+ )+ """+ _response = self._raw_client.apply_workflow_tags(+ workflow_permanent_id,+ tags=tags,+ tags_to_delete=tags_to_delete,+ colors=colors,+ request_options=request_options,+ )+ return _response.data++ def delete_workflow_tag(+ self, workflow_permanent_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> TagsResponse:+ """+ Soft-delete a single tag from a workflow. Writes a DELETE event row.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ key : str+ Tag key to delete++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ TagsResponse+ Successfully deleted tag (or no-op if absent)++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.delete_workflow_tag(+ workflow_permanent_id="wpid_123",+ key="env",+ )+ """+ _response = self._raw_client.delete_workflow_tag(workflow_permanent_id, key, request_options=request_options)+ return _response.data++ def get_workflow_tag_history(+ self,+ workflow_permanent_id: str,+ *,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> TagHistoryResponse:+ """+ Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ limit : typing.Optional[int]+ Max events to return++ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag key++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ TagHistoryResponse+ Successfully retrieved tag history++ Examples+ --------+ import datetime++ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow_tag_history(+ workflow_permanent_id="wpid_123",+ limit=1,+ since=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ key="key",+ )+ """+ _response = self._raw_client.get_workflow_tag_history(+ workflow_permanent_id, limit=limit, since=since, key=key, request_options=request_options+ )+ return _response.data++ def retry_workflow_run(+ self,+ workflow_run_id: str,+ *,+ max_steps_override: typing.Optional[int] = None,+ user_agent: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> WorkflowRunResponse:+ """+ Retry a workflow run using the original run parameters.++ Parameters+ ----------+ workflow_run_id : str+ The id of the workflow run to retry.++ max_steps_override : typing.Optional[int]++ user_agent : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ WorkflowRunResponse+ Successfully retried workflow run++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.retry_workflow_run(+ workflow_run_id="wr_123",+ max_steps_override=1,+ user_agent="x-user-agent",+ )+ """+ _response = self._raw_client.retry_workflow_run(+ workflow_run_id,+ max_steps_override=max_steps_override,+ user_agent=user_agent,+ request_options=request_options,+ )+ return _response.data++ def get_workflow_runs(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ error_code: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[WorkflowRun]:+ """+ List workflow runs across all workflows for the current organization.++ Results are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.++ ### search_key++ A case-insensitive substring search that matches against **any** of the following fields:++ | Searched field | Description |+ |---|---|+ | `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |+ | Parameter **key** | The `key` of any workflow parameter definition associated with the run |+ | Parameter **description** | The `description` of any workflow parameter definition |+ | Run parameter **value** | The actual value supplied for any parameter when the run was created |+ | `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |++ Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.++ ### error_code++ An **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).++ ### Combining filters++ All query parameters use AND logic:+ - `?status=failed` — only failed runs+ - `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error+ - `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match++ Parameters+ ----------+ page : typing.Optional[int]+ Page number for pagination.++ page_size : typing.Optional[int]+ Number of runs to return per page.++ status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]+ Filter by one or more run statuses.++ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.++ error_code : typing.Optional[str]+ Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ typing.List[WorkflowRun]+ Successful Response++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow_runs(+ page=1,+ page_size=1,+ search_key="search_key",+ error_code="error_code",+ )+ """+ _response = self._raw_client.get_workflow_runs(+ page=page,+ page_size=page_size,+ status=status,+ search_key=search_key,+ error_code=error_code,+ request_options=request_options,+ )+ return _response.data++ def get_workflow_runs_by_id(+ self,+ workflow_id: str,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ error_code: typing.Optional[str] = None,+ created_at_start: typing.Optional[dt.datetime] = None,+ created_at_end: typing.Optional[dt.datetime] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[WorkflowRun]:+ """+ List runs for a specific workflow.++ Supports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.++ ### search_key++ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.++ ### error_code++ Exact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.++ Parameters+ ----------+ workflow_id : str++ page : typing.Optional[int]+ Page number for pagination.++ page_size : typing.Optional[int]+ Number of runs to return per page.++ status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]+ Filter by one or more run statuses.++ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.++ error_code : typing.Optional[str]+ Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.++ created_at_start : typing.Optional[dt.datetime]+ Only include runs created at or after this UTC timestamp (ISO 8601).++ created_at_end : typing.Optional[dt.datetime]+ Only include runs created strictly before this UTC timestamp (ISO 8601).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ typing.List[WorkflowRun]+ Successful Response++ Examples+ --------+ import datetime++ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow_runs_by_id(+ workflow_id="workflow_id",+ page=1,+ page_size=1,+ search_key="search_key",+ error_code="error_code",+ created_at_start=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ created_at_end=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ )+ """+ _response = self._raw_client.get_workflow_runs_by_id(+ workflow_id,+ page=page,+ page_size=page_size,+ status=status,+ search_key=search_key,+ error_code=error_code,+ created_at_start=created_at_start,+ created_at_end=created_at_end,+ request_options=request_options,+ )+ return _response.data++ def get_workflow(+ self,+ workflow_permanent_id: str,+ *,+ version: typing.Optional[int] = None,+ template: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Workflow:+ """+ Parameters+ ----------+ workflow_permanent_id : str++ version : typing.Optional[int]++ template : typing.Optional[bool]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ Workflow+ Successful Response++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow(+ workflow_permanent_id="workflow_permanent_id",+ version=1,+ template=True,+ )+ """+ _response = self._raw_client.get_workflow(+ workflow_permanent_id, version=version, template=template, request_options=request_options+ )+ return _response.data++ def get_workflow_versions(+ self,+ workflow_permanent_id: str,+ *,+ template: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[Workflow]:+ """+ Get all versions of a workflow by its permanent ID.++ Parameters+ ----------+ workflow_permanent_id : str++ template : typing.Optional[bool]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ typing.List[Workflow]+ Successful Response++ Examples+ --------+ from skyvern import Skyvern++ client = Skyvern(+ api_key="YOUR_API_KEY",+ )+ client.get_workflow_versions(+ workflow_permanent_id="workflow_permanent_id",+ template=True,+ )+ """+ _response = self._raw_client.get_workflow_versions(workflow_permanent_id, template=template, request_options=request_options)return _response.data- @property- def artifacts(self):- if self._artifacts is None:- from .artifacts.client import ArtifactsClient # noqa: E402+ @property+ def artifacts(self):+ if self._artifacts is None:+ from .artifacts.client import ArtifactsClient # noqa: E402++ self._artifacts = ArtifactsClient(client_wrapper=self._client_wrapper)+ return self._artifacts++ @property+ def scripts(self):+ if self._scripts is None:+ from .scripts.client import ScriptsClient # noqa: E402++ self._scripts = ScriptsClient(client_wrapper=self._client_wrapper)+ return self._scripts++ @property+ def schedules(self):+ if self._schedules is None:+ from .schedules.client import SchedulesClient # noqa: E402++ self._schedules = SchedulesClient(client_wrapper=self._client_wrapper)+ return self._schedules++ @property+ def agents(self):+ if self._agents is None:+ from .agents.client import AgentsClient # noqa: E402++ self._agents = AgentsClient(client_wrapper=self._client_wrapper)+ return self._agents+++class AsyncSkyvern:+ """+ Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.++ Parameters+ ----------+ base_url : typing.Optional[str]+ The base url to use for requests from the client.++ environment : SkyvernEnvironment+ The environment to use for requests from the client. from .environment import SkyvernEnvironment++++ Defaults to SkyvernEnvironment.CLOUD++++ api_key : typing.Optional[str]+ headers : typing.Optional[typing.Dict[str, str]]+ Additional headers to send with every request.++ timeout : typing.Optional[float]+ The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.++ follow_redirects : typing.Optional[bool]+ Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.++ httpx_client : typing.Optional[httpx.AsyncClient]+ The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.++ Examples+ --------+ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+ """++ def __init__(+ self,+ *,+ base_url: typing.Optional[str] = None,+ environment: SkyvernEnvironment = SkyvernEnvironment.CLOUD,+ api_key: typing.Optional[str] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ timeout: typing.Optional[float] = None,+ follow_redirects: typing.Optional[bool] = True,+ httpx_client: typing.Optional[httpx.AsyncClient] = None,+ ):+ _defaulted_timeout = (+ timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read+ )+ self._client_wrapper = AsyncClientWrapper(+ base_url=_get_base_url(base_url=base_url, environment=environment),+ api_key=api_key,+ headers=headers,+ httpx_client=httpx_client+ if httpx_client is not None+ else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)+ if follow_redirects is not None+ else httpx.AsyncClient(timeout=_defaulted_timeout),+ timeout=_defaulted_timeout,+ )+ self._raw_client = AsyncRawSkyvern(client_wrapper=self._client_wrapper)+ self._artifacts: typing.Optional[AsyncArtifactsClient] = None+ self._scripts: typing.Optional[AsyncScriptsClient] = None+ self._schedules: typing.Optional[AsyncSchedulesClient] = None+ self._agents: typing.Optional[AsyncAgentsClient] = None++ @property+ def with_raw_response(self) -> AsyncRawSkyvern:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSkyvern+ """+ return self._raw_client++ async def run_task(+ self,+ *,+ prompt: str,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ engine: typing.Optional[RunEngine] = OMIT,+ title: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[TaskRunRequestInputProxyLocation] = OMIT,+ data_extraction_schema: typing.Optional[TaskRunRequestInputDataExtractionSchema] = OMIT,+ error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_steps: typing.Optional[int] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ publish_workflow: typing.Optional[bool] = OMIT,+ include_action_history_in_verification: typing.Optional[bool] = OMIT,+ max_screenshot_scrolls: typing.Optional[int] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ run_with: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> TaskRunResponse:+ """+ Run a task++ Parameters+ ----------+ prompt : str++ The goal or task description for Skyvern to accomplish++ user_agent : typing.Optional[str]++ url : typing.Optional[str]++ The starting URL for the task. If not provided, Skyvern will attempt to determine an appropriate URL++ engine : typing.Optional[RunEngine]++ The engine that powers the agent task. The default value is `skyvern-1.0`, which is good for simple tasks like filling a form, or searching for information on Google. `skyvern-2.0` remains available for existing V2 workflows and explicitly requested V2 task runs. The `openai-cua` engine uses OpenAI's CUA model. The `anthropic-cua` uses Anthropic's Claude Sonnet 3.7 model with the computer use tool.++ title : typing.Optional[str]+ The title for the task++ proxy_location : typing.Optional[TaskRunRequestInputProxyLocation]++ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.++ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy++ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}++ data_extraction_schema : typing.Optional[TaskRunRequestInputDataExtractionSchema]++ The schema for data to be extracted from the webpage. If you're looking for consistent data schema being returned by the agent, it's highly recommended to use https://json-schema.org/.++ error_code_mapping : typing.Optional[typing.Dict[str, typing.Optional[str]]]++ Custom mapping of error codes to error messages if Skyvern encounters an error.++ max_steps : typing.Optional[int]++ Maximum number of steps the task can take. Task will fail if it exceeds this number. Cautions: you are charged per step so please set this number to a reasonable value. Contact [email protected] for custom pricing.++ webhook_url : typing.Optional[str]++ After a run is finished, send an update to this URL. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for more details.++ totp_identifier : typing.Optional[str]++ Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.++ totp_url : typing.Optional[str]++ URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.++ browser_session_id : typing.Optional[str]++ Run the task or workflow in the specific Skyvern browser session. Having a browser session can persist the real-time state of the browser, so that the next run can continue from where the previous run left off.++ model : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]++ Optional model configuration.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ The extra HTTP headers for the requests in browser.++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.++ publish_workflow : typing.Optional[bool]+ Deprecated. Whether to publish a `skyvern-2.0` task as a reusable workflow. For backwards compatibility, this routes the request through the legacy `skyvern-2.0` publish path. Prefer creating reusable workflows through the workflow APIs.++ include_action_history_in_verification : typing.Optional[bool]+ Whether to include action history when verifying that the task is complete++ max_screenshot_scrolls : typing.Optional[int]+ The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.++ browser_address : typing.Optional[str]+ The CDP address for the task.++ run_with : typing.Optional[str]+ Whether to run the task with agent or code. Null means use the default.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ TaskRunResponse+ Successfully run task++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.run_task(+ user_agent="x-user-agent",+ prompt="Find the top 3 posts on Hacker News.",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.run_task(+ prompt=prompt,+ user_agent=user_agent,+ url=url,+ engine=engine,+ title=title,+ proxy_location=proxy_location,+ data_extraction_schema=data_extraction_schema,+ error_code_mapping=error_code_mapping,+ max_steps=max_steps,+ webhook_url=webhook_url,+ totp_identifier=totp_identifier,+ totp_url=totp_url,+ browser_session_id=browser_session_id,+ model=model,+ extra_http_headers=extra_http_headers,+ cdp_connect_headers=cdp_connect_headers,+ publish_workflow=publish_workflow,+ include_action_history_in_verification=include_action_history_in_verification,+ max_screenshot_scrolls=max_screenshot_scrolls,+ browser_address=browser_address,+ run_with=run_with,+ request_options=request_options,+ )+ return _response.data++ async def run_workflow(+ self,+ *,+ agent_id: str,+ template: typing.Optional[bool] = None,+ max_steps_override: typing.Optional[int] = None,+ user_agent: typing.Optional[str] = None,+ parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,+ title: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[WorkflowRunRequestInputProxyLocation] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ max_screenshot_scrolls: typing.Optional[int] = OMIT,+ max_elapsed_time_minutes: typing.Optional[int] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ ai_fallback: typing.Optional[bool] = OMIT,+ run_with: typing.Optional[str] = OMIT,+ run_metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> WorkflowRunResponse:+ """+ Run an agent- self._artifacts = ArtifactsClient(client_wrapper=self._client_wrapper)- return self._artifacts+ Parameters+ ----------+ agent_id : str+ ID of the agent to run. Starts with `wpid_`. `workflow_id` is accepted as an alias.- @property- def scripts(self):- if self._scripts is None:- from .scripts.client import ScriptsClient # noqa: E402+ template : typing.Optional[bool]++ max_steps_override : typing.Optional[int]++ user_agent : typing.Optional[str]++ parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]+ Parameters to pass to the workflow++ title : typing.Optional[str]+ The title for this workflow run++ proxy_location : typing.Optional[WorkflowRunRequestInputProxyLocation]++ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.++ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy++ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}++ webhook_url : typing.Optional[str]+ URL to send workflow status updates to after a run is finished. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for webhook questions.++ totp_url : typing.Optional[str]++ URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.++ totp_identifier : typing.Optional[str]++ Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.++ browser_session_id : typing.Optional[str]+ ID of a Skyvern browser session to reuse, having it continue from the current screen state++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this workflow run++ max_screenshot_scrolls : typing.Optional[int]+ The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.++ max_elapsed_time_minutes : typing.Optional[int]+ Timeout this workflow run after the configured elapsed runtime in minutes. When omitted, the platform default is 240 minutes. The maximum configurable value is 480 minutes.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ The extra HTTP headers for the requests in browser.++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.++ browser_address : typing.Optional[str]+ The CDP address for the workflow run.++ ai_fallback : typing.Optional[bool]+ Whether to fallback to AI if the workflow run fails.++ run_with : typing.Optional[str]+ Whether to run the workflow with agent or code. Null inherits from the workflow setting.++ run_metadata : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ String key/value metadata to attach to this workflow run for analytics tag filtering.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ WorkflowRunResponse+ Successfully ran agent++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.run_workflow(+ max_steps_override=1,+ user_agent="x-user-agent",+ template=True,+ agent_id="wpid_123",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.run_workflow(+ agent_id=agent_id,+ template=template,+ max_steps_override=max_steps_override,+ user_agent=user_agent,+ parameters=parameters,+ title=title,+ proxy_location=proxy_location,+ webhook_url=webhook_url,+ totp_url=totp_url,+ totp_identifier=totp_identifier,+ browser_session_id=browser_session_id,+ browser_profile_id=browser_profile_id,+ max_screenshot_scrolls=max_screenshot_scrolls,+ max_elapsed_time_minutes=max_elapsed_time_minutes,+ extra_http_headers=extra_http_headers,+ cdp_connect_headers=cdp_connect_headers,+ browser_address=browser_address,+ ai_fallback=ai_fallback,+ run_with=run_with,+ run_metadata=run_metadata,+ request_options=request_options,+ )+ return _response.data++ async def get_run(self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetRunResponse:+ """+ Get run information (task run, workflow run)++ Parameters+ ----------+ run_id : str+ The id of the task run or the workflow run.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetRunResponse+ Successfully got run++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- self._scripts = ScriptsClient(client_wrapper=self._client_wrapper)- return self._scripts- @property- def schedules(self):- if self._schedules is None:- from .schedules.client import SchedulesClient # noqa: E402+ async def main() -> None:+ await client.get_run(+ run_id="tsk_123",+ )- self._schedules = SchedulesClient(client_wrapper=self._client_wrapper)- return self._schedules- @property- def agents(self):- if self._agents is None:- from .agents.client import AgentsClient # noqa: E402+ asyncio.run(main())+ """+ _response = await self._raw_client.get_run(run_id, request_options=request_options)+ return _response.data- self._agents = AgentsClient(client_wrapper=self._client_wrapper)- return self._agents+ async def cancel_run(+ self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.Optional[typing.Any]:+ """+ Cancel a run (task or workflow)+ Parameters+ ----------+ run_id : str+ The id of the task run or the workflow run to cancel.-class AsyncSkyvern:- """- Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- Parameters- ----------- base_url : typing.Optional[str]- The base url to use for requests from the client.+ Returns+ -------+ typing.Optional[typing.Any]+ Successful Response- environment : SkyvernEnvironment- The environment to use for requests from the client. from .environment import SkyvernEnvironment+ Examples+ --------+ import asyncio+ from skyvern import AsyncSkyvern+ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- Defaults to SkyvernEnvironment.CLOUD+ async def main() -> None:+ await client.cancel_run(+ run_id="run_id",+ )- api_key : typing.Optional[str]- headers : typing.Optional[typing.Dict[str, str]]- Additional headers to send with every request.+ asyncio.run(main())+ """+ _response = await self._raw_client.cancel_run(run_id, request_options=request_options)+ return _response.data- timeout : typing.Optional[float]- The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.+ async def bulk_cancel_runs(+ self, *, run_ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None+ ) -> BulkCancelRunsResponse:+ """+ Cancel multiple runs (tasks or workflows) in a single request- follow_redirects : typing.Optional[bool]- Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.+ Parameters+ ----------+ run_ids : typing.Sequence[str]+ List of run IDs to cancel- httpx_client : typing.Optional[httpx.AsyncClient]- The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- Examples- --------- from skyvern import AsyncSkyvern+ Returns+ -------+ BulkCancelRunsResponse+ Successful Response- client = AsyncSkyvern(- api_key="YOUR_API_KEY",- )- """+ Examples+ --------+ import asyncio- def __init__(- self,- *,- base_url: typing.Optional[str] = None,- environment: SkyvernEnvironment = SkyvernEnvironment.CLOUD,- api_key: typing.Optional[str] = None,- headers: typing.Optional[typing.Dict[str, str]] = None,- timeout: typing.Optional[float] = None,- follow_redirects: typing.Optional[bool] = True,- httpx_client: typing.Optional[httpx.AsyncClient] = None,- ):- _defaulted_timeout = (- timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read- )- self._client_wrapper = AsyncClientWrapper(- base_url=_get_base_url(base_url=base_url, environment=environment),- api_key=api_key,- headers=headers,- httpx_client=httpx_client- if httpx_client is not None- else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)- if follow_redirects is not None- else httpx.AsyncClient(timeout=_defaulted_timeout),- timeout=_defaulted_timeout,+ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",)- self._raw_client = AsyncRawSkyvern(client_wrapper=self._client_wrapper)- self._artifacts: typing.Optional[AsyncArtifactsClient] = None- self._scripts: typing.Optional[AsyncScriptsClient] = None- self._schedules: typing.Optional[AsyncSchedulesClient] = None- self._agents: typing.Optional[AsyncAgentsClient] = None- @property- def with_raw_response(self) -> AsyncRawSkyvern:- """- Retrieves a raw implementation of this client that returns raw responses.- Returns- -------- AsyncRawSkyvern+ async def main() -> None:+ await client.bulk_cancel_runs(+ run_ids=["run_ids"],+ )+++ asyncio.run(main())"""- return self._raw_client+ _response = await self._raw_client.bulk_cancel_runs(run_ids=run_ids, request_options=request_options)+ return _response.data- async def run_task(+ async def get_workflows(self,*,- prompt: str,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- engine: typing.Optional[RunEngine] = OMIT,- title: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[TaskRunRequestInputProxyLocation] = OMIT,- data_extraction_schema: typing.Optional[TaskRunRequestInputDataExtractionSchema] = OMIT,- error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_steps: typing.Optional[int] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- publish_workflow: typing.Optional[bool] = OMIT,- include_action_history_in_verification: typing.Optional[bool] = OMIT,- max_screenshot_scrolls: typing.Optional[int] = OMIT,- browser_address: typing.Optional[str] = OMIT,- run_with: typing.Optional[str] = OMIT,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ only_saved_tasks: typing.Optional[bool] = None,+ only_workflows: typing.Optional[bool] = None,+ only_templates: typing.Optional[bool] = None,+ search_key: typing.Optional[str] = None,+ title: typing.Optional[str] = None,+ folder_id: typing.Optional[str] = None,+ status: typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]] = None,+ tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,+ template: typing.Optional[bool] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> TaskRunResponse:+ ) -> typing.List[Workflow]:"""- Run a task+ Get all workflows with the latest version for the organization.++ Search semantics:+ - If `search_key` is provided, its value is used as a unified search term for+ `workflows.title`, `folders.title`, and workflow parameter metadata (key, description, and default_value for+ `WorkflowParameterModel`).+ - Falls back to deprecated `title` (title-only search) if `search_key` is not provided.+ - Parameter metadata search excludes soft-deleted parameter rows across all parameter tables.Parameters----------- prompt : str-- The goal or task description for Skyvern to accomplish+ page : typing.Optional[int]- user_agent : typing.Optional[str]+ page_size : typing.Optional[int]- url : typing.Optional[str]+ only_saved_tasks : typing.Optional[bool]- The starting URL for the task. If not provided, Skyvern will attempt to determine an appropriate URL+ only_workflows : typing.Optional[bool]- engine : typing.Optional[RunEngine]+ only_templates : typing.Optional[bool]- The engine that powers the agent task. The default value is `skyvern-1.0`, which is good for simple tasks like filling a form, or searching for information on Google. `skyvern-2.0` remains available for existing V2 workflows and explicitly requested V2 task runs. The `openai-cua` engine uses OpenAI's CUA model. The `anthropic-cua` uses Anthropic's Claude Sonnet 3.7 model with the computer use tool.+ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow title, folder name, and parameter metadata (key, description, default_value). A workflow is returned if any of these fields match. Soft-deleted parameter definitions are excluded. Takes precedence over the deprecated `title` parameter.title : typing.Optional[str]- The title for the task+ Deprecated: use search_key instead. Falls back to title-only search if search_key is not provided.- proxy_location : typing.Optional[TaskRunRequestInputProxyLocation]+ folder_id : typing.Optional[str]+ Filter workflows by folder ID- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.+ status : typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]]- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy+ tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]+ Filter by tags. Each term is a label (`production`), a group (`env:*`), or a group:label (`env:prod`). Repeat the param or comma-separate (`?tags=env:prod,env:staging`). AND across distinct terms, OR within a group's labels (`?tags=customer:acme,env:prod,env:staging` -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only. Not supported with `template=true`.- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}+ template : typing.Optional[bool]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ typing.List[Workflow]+ Successful Response- data_extraction_schema : typing.Optional[TaskRunRequestInputDataExtractionSchema]+ Examples+ --------+ import asyncio- The schema for data to be extracted from the webpage. If you're looking for consistent data schema being returned by the agent, it's highly recommended to use https://json-schema.org/.+ from skyvern import AsyncSkyvern- error_code_mapping : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- Custom mapping of error codes to error messages if Skyvern encounters an error.- max_steps : typing.Optional[int]+ async def main() -> None:+ await client.get_workflows(+ page=1,+ page_size=1,+ only_saved_tasks=True,+ only_workflows=True,+ only_templates=True,+ search_key="search_key",+ title="title",+ folder_id="folder_id",+ template=True,+ )- Maximum number of steps the task can take. Task will fail if it exceeds this number. Cautions: you are charged per step so please set this number to a reasonable value. Contact [email protected] for custom pricing.- webhook_url : typing.Optional[str]+ asyncio.run(main())+ """+ _response = await self._raw_client.get_workflows(+ page=page,+ page_size=page_size,+ only_saved_tasks=only_saved_tasks,+ only_workflows=only_workflows,+ only_templates=only_templates,+ search_key=search_key,+ title=title,+ folder_id=folder_id,+ status=status,+ tags=tags,+ template=template,+ request_options=request_options,+ )+ return _response.data- After a run is finished, send an update to this URL. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for more details.+ async def create_workflow(+ self,+ *,+ folder_id: typing.Optional[str] = None,+ json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,+ yaml_definition: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Workflow:+ """+ Create a new agent- totp_identifier : typing.Optional[str]+ Parameters+ ----------+ folder_id : typing.Optional[str]+ Optional folder ID to assign the workflow to- Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.+ json_definition : typing.Optional[WorkflowCreateYamlRequest]+ Workflow definition in JSON format- totp_url : typing.Optional[str]+ yaml_definition : typing.Optional[str]+ Workflow definition in YAML format- URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- browser_session_id : typing.Optional[str]+ Returns+ -------+ Workflow+ Successfully created agent- Run the task or workflow in the specific Skyvern browser session. Having a browser session can persist the real-time state of the browser, so that the next run can continue from where the previous run left off.+ Examples+ --------+ import asyncio- model : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]+ from skyvern import AsyncSkyvern- Optional model configuration.+ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- The extra HTTP headers for the requests in browser.- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.+ async def main() -> None:+ await client.create_workflow(+ folder_id="folder_id",+ )- publish_workflow : typing.Optional[bool]- Deprecated. Whether to publish a `skyvern-2.0` task as a reusable workflow. For backwards compatibility, this routes the request through the legacy `skyvern-2.0` publish path. Prefer creating reusable workflows through the workflow APIs.- include_action_history_in_verification : typing.Optional[bool]- Whether to include action history when verifying that the task is complete+ asyncio.run(main())+ """+ _response = await self._raw_client.create_workflow(+ folder_id=folder_id,+ json_definition=json_definition,+ yaml_definition=yaml_definition,+ request_options=request_options,+ )+ return _response.data- max_screenshot_scrolls : typing.Optional[int]- The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.+ async def update_workflow(+ self,+ workflow_id: str,+ *,+ json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,+ yaml_definition: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Workflow:+ """+ Update an agent- browser_address : typing.Optional[str]- The CDP address for the task.+ Parameters+ ----------+ workflow_id : str+ The ID of the agent to update. Starts with `wpid_`.- run_with : typing.Optional[str]- Whether to run the task with agent or code. Null means use the default.+ json_definition : typing.Optional[WorkflowCreateYamlRequest]+ Workflow definition in JSON format++ yaml_definition : typing.Optional[str]+ Workflow definition in YAML formatrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TaskRunResponse- Successfully run task+ Workflow+ Successfully updated agentExamples--------@@ -3537,170 +4667,143 @@ class AsyncSkyvern:async def main() -> None:- await client.run_task(- user_agent="x-user-agent",- prompt="Find the top 3 posts on Hacker News.",+ await client.update_workflow(+ workflow_id="wpid_123",)asyncio.run(main())"""- _response = await self._raw_client.run_task(- prompt=prompt,- user_agent=user_agent,- url=url,- engine=engine,- title=title,- proxy_location=proxy_location,- data_extraction_schema=data_extraction_schema,- error_code_mapping=error_code_mapping,- max_steps=max_steps,- webhook_url=webhook_url,- totp_identifier=totp_identifier,- totp_url=totp_url,- browser_session_id=browser_session_id,- model=model,- extra_http_headers=extra_http_headers,- cdp_connect_headers=cdp_connect_headers,- publish_workflow=publish_workflow,- include_action_history_in_verification=include_action_history_in_verification,- max_screenshot_scrolls=max_screenshot_scrolls,- browser_address=browser_address,- run_with=run_with,+ _response = await self._raw_client.update_workflow(+ workflow_id,+ json_definition=json_definition,+ yaml_definition=yaml_definition,request_options=request_options,)return _response.data- async def run_workflow(- self,- *,- agent_id: str,- template: typing.Optional[bool] = None,- max_steps_override: typing.Optional[int] = None,- user_agent: typing.Optional[str] = None,- parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,- title: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[WorkflowRunRequestInputProxyLocation] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- max_screenshot_scrolls: typing.Optional[int] = OMIT,- max_elapsed_time_minutes: typing.Optional[int] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- browser_address: typing.Optional[str] = OMIT,- ai_fallback: typing.Optional[bool] = OMIT,- run_with: typing.Optional[str] = OMIT,- run_metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowRunResponse:+ async def delete_workflow(+ self, workflow_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.Optional[typing.Any]:"""- Run an agent+ Delete an agentParameters----------- agent_id : str- ID of the agent to run. Starts with `wpid_`. `workflow_id` is accepted as an alias.+ workflow_id : str+ The ID of the agent to delete. Starts with `wpid_`.- template : typing.Optional[bool]+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- max_steps_override : typing.Optional[int]+ Returns+ -------+ typing.Optional[typing.Any]+ Successfully deleted agent- user_agent : typing.Optional[str]+ Examples+ --------+ import asyncio- parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]- Parameters to pass to the workflow+ from skyvern import AsyncSkyvern- title : typing.Optional[str]- The title for this workflow run+ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- proxy_location : typing.Optional[WorkflowRunRequestInputProxyLocation]- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.+ async def main() -> None:+ await client.delete_workflow(+ workflow_id="wpid_123",+ )- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}+ asyncio.run(main())+ """+ _response = await self._raw_client.delete_workflow(workflow_id, request_options=request_options)+ return _response.data++ async def get_folders(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ search: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.List[Folder]:+ """+ Get all folders for the organization- webhook_url : typing.Optional[str]- URL to send workflow status updates to after a run is finished. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for webhook questions.+ Parameters+ ----------+ page : typing.Optional[int]+ Page number- totp_url : typing.Optional[str]+ page_size : typing.Optional[int]+ Number of folders per page- URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.+ search : typing.Optional[str]+ Search folders by title or description- totp_identifier : typing.Optional[str]+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.+ Returns+ -------+ typing.List[Folder]+ Successfully retrieved folders- browser_session_id : typing.Optional[str]- ID of a Skyvern browser session to reuse, having it continue from the current screen state+ Examples+ --------+ import asyncio- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this workflow run+ from skyvern import AsyncSkyvern- max_screenshot_scrolls : typing.Optional[int]- The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.+ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )- max_elapsed_time_minutes : typing.Optional[int]- Timeout this workflow run after the configured elapsed runtime in minutes. When omitted, the platform default is 240 minutes. The maximum configurable value is 480 minutes.- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- The extra HTTP headers for the requests in browser.+ async def main() -> None:+ await client.get_folders(+ page=1,+ page_size=1,+ search="search",+ )- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.- browser_address : typing.Optional[str]- The CDP address for the workflow run.+ asyncio.run(main())+ """+ _response = await self._raw_client.get_folders(+ page=page, page_size=page_size, search=search, request_options=request_options+ )+ return _response.data- ai_fallback : typing.Optional[bool]- Whether to fallback to AI if the workflow run fails.+ async def create_folder(+ self,+ *,+ title: str,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Folder:+ """+ Create a new folder to organize workflows- run_with : typing.Optional[str]- Whether to run the workflow with agent or code. Null inherits from the workflow setting.+ Parameters+ ----------+ title : str+ Folder title- run_metadata : typing.Optional[typing.Dict[str, typing.Optional[str]]]- String key/value metadata to attach to this workflow run for analytics tag filtering.+ description : typing.Optional[str]+ Folder descriptionrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowRunResponse- Successfully ran agent+ Folder+ Successfully created folderExamples--------@@ -3714,57 +4817,34 @@ class AsyncSkyvern:async def main() -> None:- await client.run_workflow(- max_steps_override=1,- user_agent="x-user-agent",- template=True,- agent_id="wpid_123",+ await client.create_folder(+ title="title",)asyncio.run(main())"""- _response = await self._raw_client.run_workflow(- agent_id=agent_id,- template=template,- max_steps_override=max_steps_override,- user_agent=user_agent,- parameters=parameters,- title=title,- proxy_location=proxy_location,- webhook_url=webhook_url,- totp_url=totp_url,- totp_identifier=totp_identifier,- browser_session_id=browser_session_id,- browser_profile_id=browser_profile_id,- max_screenshot_scrolls=max_screenshot_scrolls,- max_elapsed_time_minutes=max_elapsed_time_minutes,- extra_http_headers=extra_http_headers,- cdp_connect_headers=cdp_connect_headers,- browser_address=browser_address,- ai_fallback=ai_fallback,- run_with=run_with,- run_metadata=run_metadata,- request_options=request_options,+ _response = await self._raw_client.create_folder(+ title=title, description=description, request_options=request_options)return _response.data- async def get_run(self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetRunResponse:+ async def get_folder(self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Folder:"""- Get run information (task run, workflow run)+ Get a specific folder by IDParameters----------- run_id : str- The id of the task run or the workflow run.+ folder_id : str+ Folder IDrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- GetRunResponse- Successfully got run+ Folder+ Successfully retrieved folderExamples--------@@ -3778,34 +4858,45 @@ class AsyncSkyvern:async def main() -> None:- await client.get_run(- run_id="tsk_123",+ await client.get_folder(+ folder_id="fld_123",)asyncio.run(main())"""- _response = await self._raw_client.get_run(run_id, request_options=request_options)+ _response = await self._raw_client.get_folder(folder_id, request_options=request_options)return _response.data- async def cancel_run(- self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> typing.Optional[typing.Any]:+ async def update_folder(+ self,+ folder_id: str,+ *,+ title: typing.Optional[str] = OMIT,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Folder:"""- Cancel a run (task or workflow)+ Update a folder's title or descriptionParameters----------- run_id : str- The id of the task run or the workflow run to cancel.+ folder_id : str+ Folder ID++ title : typing.Optional[str]+ Folder title++ description : typing.Optional[str]+ Folder descriptionrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.Optional[typing.Any]- Successful Response+ Folder+ Successfully updated folderExamples--------@@ -3819,34 +4910,43 @@ class AsyncSkyvern:async def main() -> None:- await client.cancel_run(- run_id="run_id",+ await client.update_folder(+ folder_id="fld_123",)asyncio.run(main())"""- _response = await self._raw_client.cancel_run(run_id, request_options=request_options)+ _response = await self._raw_client.update_folder(+ folder_id, title=title, description=description, request_options=request_options+ )return _response.data- async def bulk_cancel_runs(- self, *, run_ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None- ) -> BulkCancelRunsResponse:+ async def delete_folder(+ self,+ folder_id: str,+ *,+ delete_workflows: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.Dict[str, typing.Optional[typing.Any]]:"""- Cancel multiple runs (tasks or workflows) in a single request+ Delete a folder. Optionally delete all workflows in the folder.Parameters----------- run_ids : typing.Sequence[str]- List of run IDs to cancel+ folder_id : str+ Folder ID++ delete_workflows : typing.Optional[bool]+ If true, also delete all workflows in this folderrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- BulkCancelRunsResponse- Successful Response+ typing.Dict[str, typing.Optional[typing.Any]]+ Successfully deleted folderExamples--------@@ -3860,77 +4960,93 @@ class AsyncSkyvern:async def main() -> None:- await client.bulk_cancel_runs(- run_ids=["run_ids"],+ await client.delete_folder(+ folder_id="fld_123",+ delete_workflows=True,)asyncio.run(main())"""- _response = await self._raw_client.bulk_cancel_runs(run_ids=run_ids, request_options=request_options)+ _response = await self._raw_client.delete_folder(+ folder_id, delete_workflows=delete_workflows, request_options=request_options+ )return _response.data- async def get_workflows(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- only_saved_tasks: typing.Optional[bool] = None,- only_workflows: typing.Optional[bool] = None,- only_templates: typing.Optional[bool] = None,- search_key: typing.Optional[str] = None,- title: typing.Optional[str] = None,- folder_id: typing.Optional[str] = None,- status: typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]] = None,- tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,- template: typing.Optional[bool] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[Workflow]:+ async def get_run_tags(+ self, workflow_run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsResponse:"""- Get all workflows with the latest version for the organization.-- Search semantics:- - If `search_key` is provided, its value is used as a unified search term for- `workflows.title`, `folders.title`, and workflow parameter metadata (key, description, and default_value for- `WorkflowParameterModel`).- - Falls back to deprecated `title` (title-only search) if `search_key` is not provided.- - Parameter metadata search excludes soft-deleted parameter rows across all parameter tables.+ Get the current tag state for a workflow run.Parameters----------- page : typing.Optional[int]+ workflow_run_id : str+ Workflow run ID- page_size : typing.Optional[int]+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.- only_saved_tasks : typing.Optional[bool]+ Returns+ -------+ RunTagsResponse+ Successfully retrieved tags- only_workflows : typing.Optional[bool]+ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.get_run_tags(+ workflow_run_id="wr_123",+ )- only_templates : typing.Optional[bool]- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow title, folder name, and parameter metadata (key, description, default_value). A workflow is returned if any of these fields match. Soft-deleted parameter definitions are excluded. Takes precedence over the deprecated `title` parameter.+ asyncio.run(main())+ """+ _response = await self._raw_client.get_run_tags(workflow_run_id, request_options=request_options)+ return _response.data- title : typing.Optional[str]- Deprecated: use search_key instead. Falls back to title-only search if search_key is not provided.+ async def apply_run_tags(+ self,+ workflow_run_id: str,+ *,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> RunTagsResponse:+ """+ Atomically apply tag changes to a workflow run. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.- folder_id : typing.Optional[str]- Filter workflows by folder ID+ Parameters+ ----------+ workflow_run_id : str+ Workflow run ID- status : typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]]+ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.- tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]- Filter by tags. Each term is a label (`production`), a group (`env:*`), or a group:label (`env:prod`). Repeat the param or comma-separate (`?tags=env:prod,env:staging`). AND across distinct terms, OR within a group's labels (`?tags=customer:acme,env:prod,env:staging` -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only. Not supported with `template=true`.+ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.- template : typing.Optional[bool]+ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[Workflow]- Successful Response+ RunTagsResponse+ Successfully applied tag changesExamples--------@@ -3944,66 +5060,39 @@ class AsyncSkyvern:async def main() -> None:- await client.get_workflows(- page=1,- page_size=1,- only_saved_tasks=True,- only_workflows=True,- only_templates=True,- search_key="search_key",- title="title",- folder_id="folder_id",- template=True,+ await client.apply_run_tags(+ workflow_run_id="wr_123",)asyncio.run(main())"""- _response = await self._raw_client.get_workflows(- page=page,- page_size=page_size,- only_saved_tasks=only_saved_tasks,- only_workflows=only_workflows,- only_templates=only_templates,- search_key=search_key,- title=title,- folder_id=folder_id,- status=status,- tags=tags,- template=template,- request_options=request_options,+ _response = await self._raw_client.apply_run_tags(+ workflow_run_id, tags=tags, tags_to_delete=tags_to_delete, colors=colors, request_options=request_options)return _response.data- async def create_workflow(- self,- *,- folder_id: typing.Optional[str] = None,- json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,- yaml_definition: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> Workflow:+ async def delete_run_tag(+ self, workflow_run_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsResponse:"""- Create a new agent+ Soft-delete a single grouped tag from a workflow run. Writes a DELETE event row.Parameters----------- folder_id : typing.Optional[str]- Optional folder ID to assign the workflow to-- json_definition : typing.Optional[WorkflowCreateYamlRequest]- Workflow definition in JSON format+ workflow_run_id : str+ Workflow run ID- yaml_definition : typing.Optional[str]- Workflow definition in YAML format+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Workflow- Successfully created agent+ RunTagsResponse+ Successfully deleted tag (or no-op if absent)Examples--------@@ -4017,54 +5106,55 @@ class AsyncSkyvern:async def main() -> None:- await client.create_workflow(- folder_id="folder_id",+ await client.delete_run_tag(+ workflow_run_id="wr_123",+ key="env",)asyncio.run(main())"""- _response = await self._raw_client.create_workflow(- folder_id=folder_id,- json_definition=json_definition,- yaml_definition=yaml_definition,- request_options=request_options,- )+ _response = await self._raw_client.delete_run_tag(workflow_run_id, key, request_options=request_options)return _response.data- async def update_workflow(+ async def get_run_tag_history(self,- workflow_id: str,+ workflow_run_id: str,*,- json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,- yaml_definition: typing.Optional[str] = OMIT,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> Workflow:+ ) -> RunTagHistoryResponse:"""- Update an agent+ Chronological tag-event log for a workflow run (newest first). Includes SET and DELETE events.Parameters----------- workflow_id : str- The ID of the agent to update. Starts with `wpid_`.+ workflow_run_id : str+ Workflow run ID- json_definition : typing.Optional[WorkflowCreateYamlRequest]- Workflow definition in JSON format+ limit : typing.Optional[int]+ Max events to return- yaml_definition : typing.Optional[str]- Workflow definition in YAML format+ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Workflow- Successfully updated agent+ RunTagHistoryResponse+ Successfully retrieved tag historyExamples--------import asyncio+ import datetimefrom skyvern import AsyncSkyvern@@ -4074,39 +5164,36 @@ class AsyncSkyvern:async def main() -> None:- await client.update_workflow(- workflow_id="wpid_123",+ await client.get_run_tag_history(+ workflow_run_id="wr_123",+ limit=1,+ since=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ key="key",)asyncio.run(main())"""- _response = await self._raw_client.update_workflow(- workflow_id,- json_definition=json_definition,- yaml_definition=yaml_definition,- request_options=request_options,+ _response = await self._raw_client.get_run_tag_history(+ workflow_run_id, limit=limit, since=since, key=key, request_options=request_options)return _response.data- async def delete_workflow(- self, workflow_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> typing.Optional[typing.Any]:+ async def list_tag_keys(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[TagKey]:"""- Delete an agent+ List all tag keys registered for the organization with their descriptions.Parameters----------- workflow_id : str- The ID of the agent to delete. Starts with `wpid_`.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.Optional[typing.Any]- Successfully deleted agent+ typing.List[TagKey]+ Successfully retrieved tag keysExamples--------@@ -4120,45 +5207,32 @@ class AsyncSkyvern:async def main() -> None:- await client.delete_workflow(- workflow_id="wpid_123",- )+ await client.list_tag_keys()asyncio.run(main())"""- _response = await self._raw_client.delete_workflow(workflow_id, request_options=request_options)+ _response = await self._raw_client.list_tag_keys(request_options=request_options)return _response.data- async def get_folders(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- search: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.List[Folder]:+ async def delete_tag_key(+ self, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> TagKeyDeleteResponse:"""- Get all folders for the organization+ Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.Parameters----------- page : typing.Optional[int]- Page number-- page_size : typing.Optional[int]- Number of folders per page-- search : typing.Optional[str]- Search folders by title or description+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[Folder]- Successfully retrieved folders+ TagKeyDeleteResponse+ Successfully deleted tag keyExamples--------@@ -4172,45 +5246,41 @@ class AsyncSkyvern:async def main() -> None:- await client.get_folders(- page=1,- page_size=1,- search="search",+ await client.delete_tag_key(+ key="env",)asyncio.run(main())"""- _response = await self._raw_client.get_folders(- page=page, page_size=page_size, search=search, request_options=request_options- )+ _response = await self._raw_client.delete_tag_key(key, request_options=request_options)return _response.data- async def create_folder(+ async def update_tag_key(self,+ key: str,*,- title: str,description: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> Folder:+ ) -> TagKey:"""- Create a new folder to organize workflows+ Update the description for a tag key.Parameters----------- title : str- Folder title+ key : str+ Tag key to updatedescription : typing.Optional[str]- Folder description+ Free-form description (max 500 chars). Pass null to clear.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Folder- Successfully created folder+ TagKey+ Successfully updated tag keyExamples--------@@ -4224,34 +5294,34 @@ class AsyncSkyvern:async def main() -> None:- await client.create_folder(- title="title",+ await client.update_tag_key(+ key="key",)asyncio.run(main())"""- _response = await self._raw_client.create_folder(- title=title, description=description, request_options=request_options- )+ _response = await self._raw_client.update_tag_key(key, description=description, request_options=request_options)return _response.data- async def get_folder(self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Folder:+ async def list_tag_values(+ self, *, key: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.List[TagValue]:"""- Get a specific folder by ID+ List the palette color and current workflow usage count for each grouped tag (key, value) for the organization. The frontend joins these onto tags by (key, value); workflow_count is the number of non-deleted workflows carrying the label and powers the per-label usage and delete blast-radius warnings.Parameters----------- folder_id : str- Folder ID+ key : typing.Optional[str]+ Filter to values for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Folder- Successfully retrieved folder+ typing.List[TagValue]+ Successfully retrieved tag valuesExamples--------@@ -4265,45 +5335,37 @@ class AsyncSkyvern:async def main() -> None:- await client.get_folder(- folder_id="fld_123",+ await client.list_tag_values(+ key="key",)asyncio.run(main())"""- _response = await self._raw_client.get_folder(folder_id, request_options=request_options)+ _response = await self._raw_client.list_tag_values(key=key, request_options=request_options)return _response.data- async def update_folder(- self,- folder_id: str,- *,- title: typing.Optional[str] = OMIT,- description: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> Folder:+ async def delete_tag_value(+ self, key: str, *, value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValueDeleteResponse:"""- Update a folder's title or description+ Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.Parameters----------- folder_id : str- Folder ID-- title : typing.Optional[str]- Folder title+ key : str+ Tag key (group)- description : typing.Optional[str]- Folder description+ value : str+ Tag value (label) under the key to soft-delete.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- Folder- Successfully updated folder+ TagValueDeleteResponse+ Successfully deleted tag valueExamples--------@@ -4317,43 +5379,41 @@ class AsyncSkyvern:async def main() -> None:- await client.update_folder(- folder_id="fld_123",+ await client.delete_tag_value(+ key="env",+ value="value",)asyncio.run(main())"""- _response = await self._raw_client.update_folder(- folder_id, title=title, description=description, request_options=request_options- )- return _response.data-- async def delete_folder(- self,- folder_id: str,- *,- delete_workflows: typing.Optional[bool] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> typing.Dict[str, typing.Optional[typing.Any]]:- """- Delete a folder. Optionally delete all workflows in the folder.+ _response = await self._raw_client.delete_tag_value(key, value=value, request_options=request_options)+ return _response.data++ async def update_tag_value(+ self, key: str, *, value: str, color: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValue:+ """+ Recolor a grouped tag (key, value). The value is supplied in the body so values containing '/' stay addressable. The new color must be a palette name.Parameters----------- folder_id : str- Folder ID+ key : str+ Tag key (group)- delete_workflows : typing.Optional[bool]- If true, also delete all workflows in this folder+ value : str+ Tag value (label) under the key to recolor.++ color : str+ Palette color name to assign to this (key, value).request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.Dict[str, typing.Optional[typing.Any]]- Successfully deleted folder+ TagValue+ Successfully recolored tag valueExamples--------@@ -4367,32 +5427,44 @@ class AsyncSkyvern:async def main() -> None:- await client.delete_folder(- folder_id="fld_123",- delete_workflows=True,+ await client.update_tag_value(+ key="env",+ value="value",+ color="color",)asyncio.run(main())"""- _response = await self._raw_client.delete_folder(- folder_id, delete_workflows=delete_workflows, request_options=request_options+ _response = await self._raw_client.update_tag_value(+ key, value=value, color=color, request_options=request_options)return _response.data- async def list_tag_keys(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[TagKey]:+ async def rename_tag_value(+ self, key: str, *, value: str, new_value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> TagValueRenameResponse:"""- List all tag keys registered for the organization with their descriptions.+ Rename a grouped tag (key, value) to (key, new_value). The cascade re-tags every workflow carrying the old label; the new label inherits the old color. Both values ride in the body so values containing '/' stay addressable. Rejects with 409 when the new value already exists for the key.Parameters----------+ key : str+ Tag key (group)++ value : str+ Current tag value (label) under the key to rename.++ new_value : str+ New tag value (label) to rename it to.+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- typing.List[TagKey]- Successfully retrieved tag keys+ TagValueRenameResponse+ Successfully renamed tag valueExamples--------@@ -4406,32 +5478,41 @@ class AsyncSkyvern:async def main() -> None:- await client.list_tag_keys()+ await client.rename_tag_value(+ key="env",+ value="value",+ new_value="new_value",+ )asyncio.run(main())"""- _response = await self._raw_client.list_tag_keys(request_options=request_options)+ _response = await self._raw_client.rename_tag_value(+ key, value=value, new_value=new_value, request_options=request_options+ )return _response.data- async def delete_tag_key(- self, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> TagKeyDeleteResponse:+ async def batch_get_workflow_tags(+ self,+ *,+ workflow_permanent_ids: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> WorkflowTagsBatchResponse:"""- Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.+ Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.Parameters----------- key : str- Tag key to delete+ workflow_permanent_ids : typing.Optional[str]+ Comma-separated workflow permanent IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagKeyDeleteResponse- Successfully deleted tag key+ WorkflowTagsBatchResponse+ Successfully retrieved tagsExamples--------@@ -4445,41 +5526,39 @@ class AsyncSkyvern:async def main() -> None:- await client.delete_tag_key(- key="env",+ await client.batch_get_workflow_tags(+ workflow_permanent_ids="workflow_permanent_ids",)asyncio.run(main())"""- _response = await self._raw_client.delete_tag_key(key, request_options=request_options)+ _response = await self._raw_client.batch_get_workflow_tags(+ workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ )return _response.data- async def update_tag_key(+ async def batch_get_workflow_tags_post(self,- key: str,*,- description: typing.Optional[str] = OMIT,+ workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> TagKey:+ ) -> WorkflowTagsBatchResponse:"""- Update the description for a tag key.+ Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).Parameters----------- key : str- Tag key to update-- description : typing.Optional[str]- Free-form description (max 500 chars). Pass null to clear.+ workflow_permanent_ids : typing.Optional[typing.Sequence[str]]+ Workflow permanent IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- TagKey- Successfully updated tag key+ WorkflowTagsBatchResponse+ Successfully retrieved tagsExamples--------@@ -4493,36 +5572,33 @@ class AsyncSkyvern:async def main() -> None:- await client.update_tag_key(- key="key",- )+ await client.batch_get_workflow_tags_post()asyncio.run(main())"""- _response = await self._raw_client.update_tag_key(key, description=description, request_options=request_options)+ _response = await self._raw_client.batch_get_workflow_tags_post(+ workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ )return _response.data- async def batch_get_workflow_tags(- self,- *,- workflow_permanent_ids: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowTagsBatchResponse:+ async def batch_get_run_tags(+ self, *, workflow_run_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> RunTagsBatchResponse:"""- Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.+ Batch fetch current tags for many workflow runs. Avoids N+1 on run-list pages.Parameters----------- workflow_permanent_ids : typing.Optional[str]- Comma-separated workflow permanent IDs+ workflow_run_ids : typing.Optional[str]+ Comma-separated workflow run IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowTagsBatchResponse+ RunTagsBatchResponseSuccessfully retrieved tagsExamples@@ -4537,38 +5613,38 @@ class AsyncSkyvern:async def main() -> None:- await client.batch_get_workflow_tags(- workflow_permanent_ids="workflow_permanent_ids",+ await client.batch_get_run_tags(+ workflow_run_ids="workflow_run_ids",)asyncio.run(main())"""- _response = await self._raw_client.batch_get_workflow_tags(- workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ _response = await self._raw_client.batch_get_run_tags(+ workflow_run_ids=workflow_run_ids, request_options=request_options)return _response.data- async def batch_get_workflow_tags_post(+ async def batch_get_run_tags_post(self,*,- workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,+ workflow_run_ids: typing.Optional[typing.Sequence[str]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> WorkflowTagsBatchResponse:+ ) -> RunTagsBatchResponse:"""- Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).+ Batch fetch current tags for many workflow runs (POST variant for id lists exceeding URL length).Parameters----------- workflow_permanent_ids : typing.Optional[typing.Sequence[str]]- Workflow permanent IDs to fetch tags for.+ workflow_run_ids : typing.Optional[typing.Sequence[str]]+ Workflow run IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- WorkflowTagsBatchResponse+ RunTagsBatchResponseSuccessfully retrieved tagsExamples@@ -4583,13 +5659,13 @@ class AsyncSkyvern:async def main() -> None:- await client.batch_get_workflow_tags_post()+ await client.batch_get_run_tags_post()asyncio.run(main())"""- _response = await self._raw_client.batch_get_workflow_tags_post(- workflow_permanent_ids=workflow_permanent_ids, request_options=request_options+ _response = await self._raw_client.batch_get_run_tags_post(+ workflow_run_ids=workflow_run_ids, request_options=request_options)return _response.data@@ -4772,6 +5848,7 @@ class AsyncSkyvern:page_size: typing.Optional[int] = None,status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,search_key: typing.Optional[str] = None,+ run_type: typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]] = None,request_options: typing.Optional[RequestOptions] = None,) -> typing.List[TaskRunListItem]:"""@@ -4786,6 +5863,8 @@ class AsyncSkyvern:search_key : typing.Optional[str]Case-insensitive substring search (min 3 chars for trigram index).+ run_type : typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]]+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -4816,7 +5895,12 @@ class AsyncSkyvern:asyncio.run(main())"""_response = await self._raw_client.get_runs_v2(- page=page, page_size=page_size, status=status, search_key=search_key, request_options=request_options+ page=page,+ page_size=page_size,+ status=status,+ search_key=search_key,+ run_type=run_type,+ request_options=request_options,)return _response.data@@ -4865,6 +5949,7 @@ class AsyncSkyvern:page_size: typing.Optional[int] = None,include_deleted: typing.Optional[bool] = None,search_key: typing.Optional[str] = None,+ managed: typing.Optional[bool] = None,request_options: typing.Optional[RequestOptions] = None,) -> typing.List[BrowserProfile]:"""@@ -4882,6 +5967,9 @@ class AsyncSkyvern:search_key : typing.Optional[str]Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.+ managed : typing.Optional[bool]+ Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -4907,6 +5995,7 @@ class AsyncSkyvern:page_size=1,include_deleted=True,search_key="search_key",+ managed=True,)@@ -4917,6 +6006,7 @@ class AsyncSkyvern:page_size=page_size,include_deleted=include_deleted,search_key=search_key,+ managed=managed,request_options=request_options,)return _response.data@@ -5187,6 +6277,7 @@ class AsyncSkyvern:*,timeout: typing.Optional[int] = OMIT,proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,browser_type: typing.Optional[PersistentBrowserType] = OMIT,browser_profile_id: typing.Optional[str] = OMIT,@@ -5238,6 +6329,9 @@ class AsyncSkyvern:For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}+ proxy_session_id : typing.Optional[str]+ Opaque Skyvern-managed proxy sticky-session id for pinned Residential ISP sessions.+extensions : typing.Optional[typing.Sequence[Extensions]]A list of extensions to install in the browser session.@@ -5278,6 +6372,7 @@ class AsyncSkyvern:_response = await self._raw_client.create_browser_session(timeout=timeout,proxy_location=proxy_location,+ proxy_session_id=proxy_session_id,extensions=extensions,browser_type=browser_type,browser_profile_id=browser_profile_id,@@ -5824,6 +6919,177 @@ class AsyncSkyvern:_response = await self._raw_client.get_credential(credential_id, request_options=request_options)return _response.data+ async def list_custom_llms(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> CustomLlmListResponse:+ """+ List the custom LLM configurations available to the current organization.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CustomLlmListResponse+ Successful Response++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.list_custom_llms()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_custom_llms(request_options=request_options)+ return _response.data++ async def create_custom_llm(+ self, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> CustomLlmResponse:+ """+ Create a custom LLM configuration for the current organization.++ Parameters+ ----------+ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CustomLlmResponse+ Successful Response++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern, CustomLlmConfig++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.create_custom_llm(+ config=CustomLlmConfig(+ display_name="display_name",+ provider="openai_compatible",+ model_name="model_name",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_custom_llm(config=config, request_options=request_options)+ return _response.data++ async def update_custom_llm(+ self, custom_llm_id: str, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> CustomLlmResponse:+ """+ Update a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CustomLlmResponse+ Successful Response++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern, CustomLlmConfig++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.update_custom_llm(+ custom_llm_id="custom_llm_id",+ config=CustomLlmConfig(+ display_name="display_name",+ provider="openai_compatible",+ model_name="model_name",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.update_custom_llm(+ custom_llm_id, config=config, request_options=request_options+ )+ return _response.data++ async def delete_custom_llm(+ self, custom_llm_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> ClearOrganizationAuthTokenResponse:+ """+ Delete a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ClearOrganizationAuthTokenResponse+ Successful Response++ Examples+ --------+ import asyncio++ from skyvern import AsyncSkyvern++ client = AsyncSkyvern(+ api_key="YOUR_API_KEY",+ )+++ async def main() -> None:+ await client.delete_custom_llm(+ custom_llm_id="custom_llm_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.delete_custom_llm(custom_llm_id, request_options=request_options)+ return _response.data+async def login(self,*,@@ -6462,6 +7728,7 @@ class AsyncSkyvern:*,tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,request_options: typing.Optional[RequestOptions] = None,) -> TagsResponse:"""@@ -6478,6 +7745,9 @@ class AsyncSkyvern:tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]Tags to soft-delete. List of {key?, value?} targets.+ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -6506,7 +7776,11 @@ class AsyncSkyvern:asyncio.run(main())"""_response = await self._raw_client.apply_workflow_tags(- workflow_permanent_id, tags=tags, tags_to_delete=tags_to_delete, request_options=request_options+ workflow_permanent_id,+ tags=tags,+ tags_to_delete=tags_to_delete,+ colors=colors,+ request_options=request_options,)return _response.data@@ -6784,6 +8058,8 @@ class AsyncSkyvern:status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,search_key: typing.Optional[str] = None,error_code: typing.Optional[str] = None,+ created_at_start: typing.Optional[dt.datetime] = None,+ created_at_end: typing.Optional[dt.datetime] = None,request_options: typing.Optional[RequestOptions] = None,) -> typing.List[WorkflowRun]:"""@@ -6818,6 +8094,12 @@ class AsyncSkyvern:error_code : typing.Optional[str]Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ created_at_start : typing.Optional[dt.datetime]+ Only include runs created at or after this UTC timestamp (ISO 8601).++ created_at_end : typing.Optional[dt.datetime]+ Only include runs created strictly before this UTC timestamp (ISO 8601).+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -6829,6 +8111,7 @@ class AsyncSkyvern:Examples--------import asyncio+ import datetimefrom skyvern import AsyncSkyvern@@ -6844,6 +8127,12 @@ class AsyncSkyvern:page_size=1,search_key="search_key",error_code="error_code",+ created_at_start=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ created_at_end=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),)@@ -6856,6 +8145,8 @@ class AsyncSkyvern:status=status,search_key=search_key,error_code=error_code,+ created_at_start=created_at_start,+ created_at_end=created_at_end,request_options=request_options,)return _response.datadiff --git a/skyvern/client/core/client_wrapper.py b/skyvern/client/core/client_wrapper.pyindex 0e89bf1e6..7c02341d1 100644--- a/skyvern/client/core/client_wrapper.py+++ b/skyvern/client/core/client_wrapper.py@@ -22,10 +22,10 @@ class BaseClientWrapper:def get_headers(self) -> typing.Dict[str, str]:headers: typing.Dict[str, str] = {- "User-Agent": "skyvern/1.0.45",+ "User-Agent": "skyvern/1.0.47","X-Fern-Language": "Python","X-Fern-SDK-Name": "skyvern",- "X-Fern-SDK-Version": "1.0.45",+ "X-Fern-SDK-Version": "1.0.47",**(self.get_custom_headers() or {}),}if self._api_key is not None:diff --git a/skyvern/client/raw_client.py b/skyvern/client/raw_client.pyindex 7938c1c57..2b386f51d 100644--- a/skyvern/client/raw_client.py+++ b/skyvern/client/raw_client.py@@ -22,6 +22,7 @@ from .types.artifact_type import ArtifactTypefrom .types.browser_profile import BrowserProfilefrom .types.browser_session_response import BrowserSessionResponsefrom .types.bulk_cancel_runs_response import BulkCancelRunsResponse+from .types.clear_organization_auth_token_response import ClearOrganizationAuthTokenResponsefrom .types.create_browser_profile_request_proxy_location import CreateBrowserProfileRequestProxyLocationfrom .types.create_browser_session_request_proxy_location import CreateBrowserSessionRequestProxyLocationfrom .types.create_credential_request_credential import CreateCredentialRequestCredential@@ -29,6 +30,9 @@ from .types.create_credential_request_proxy_location import CreateCredentialRequfrom .types.create_script_response import CreateScriptResponsefrom .types.credential_response import CredentialResponsefrom .types.credential_vault_type import CredentialVaultType+from .types.custom_llm_config import CustomLlmConfig+from .types.custom_llm_list_response import CustomLlmListResponse+from .types.custom_llm_response import CustomLlmResponsefrom .types.extensions import Extensionsfrom .types.folder import Folderfrom .types.get_run_response import GetRunResponse@@ -40,6 +44,10 @@ from .types.run_engine import RunEnginefrom .types.run_sdk_action_request_action import RunSdkActionRequestActionfrom .types.run_sdk_action_response import RunSdkActionResponsefrom .types.run_status import RunStatus+from .types.run_tag_history_response import RunTagHistoryResponse+from .types.run_tags_batch_response import RunTagsBatchResponse+from .types.run_tags_response import RunTagsResponse+from .types.run_type import RunTypefrom .types.run_webhook_replay_response import RunWebhookReplayResponsefrom .types.script import Scriptfrom .types.script_file_create import ScriptFileCreate@@ -50,6 +58,9 @@ from .types.tag_history_response import TagHistoryResponsefrom .types.tag_input import TagInputfrom .types.tag_key import TagKeyfrom .types.tag_key_delete_response import TagKeyDeleteResponse+from .types.tag_value import TagValue+from .types.tag_value_delete_response import TagValueDeleteResponse+from .types.tag_value_rename_response import TagValueRenameResponsefrom .types.tags_response import TagsResponsefrom .types.task_run_list_item import TaskRunListItemfrom .types.task_run_request_input_data_extraction_schema import TaskRunRequestInputDataExtractionSchema@@ -1327,37 +1338,51 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def list_tag_keys(- self, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[typing.List[TagKey]]:+ def get_run_tags(+ self, workflow_run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[RunTagsResponse]:"""- List all tag keys registered for the organization with their descriptions.+ Get the current tag state for a workflow run.Parameters----------+ workflow_run_id : str+ Workflow run ID+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[TagKey]]- Successfully retrieved tag keys+ HttpResponse[RunTagsResponse]+ Successfully retrieved tags"""_response = self._client_wrapper.httpx_client.request(- "v1/tag-keys",+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags",method="GET",request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[TagKey],+ RunTagsResponse,parse_obj_as(- type_=typing.List[TagKey], # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -1374,36 +1399,64 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def delete_tag_key(- self, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[TagKeyDeleteResponse]:+ def apply_run_tags(+ self,+ workflow_run_id: str,+ *,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[RunTagsResponse]:"""- Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.+ Atomically apply tag changes to a workflow run. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.Parameters----------- key : str- Tag key to delete+ workflow_run_id : str+ Workflow run ID++ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.++ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.++ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagKeyDeleteResponse]- Successfully deleted tag key+ HttpResponse[RunTagsResponse]+ Successfully applied tag changes"""_response = self._client_wrapper.httpx_client.request(- f"v1/tag-keys/{jsonable_encoder(key)}",- method="DELETE",+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags",+ method="POST",+ json={+ "tags": convert_and_respect_annotation_metadata(+ object_=tags, annotation=typing.Sequence[TagInput], direction="write"+ ),+ "tags_to_delete": convert_and_respect_annotation_metadata(+ object_=tags_to_delete, annotation=typing.Sequence[TagDeleteInput], direction="write"+ ),+ "colors": colors,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagKeyDeleteResponse,+ RunTagsResponse,parse_obj_as(- type_=TagKeyDeleteResponse, # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)@@ -1435,50 +1488,39 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def update_tag_key(- self,- key: str,- *,- description: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[TagKey]:+ def delete_run_tag(+ self, workflow_run_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[RunTagsResponse]:"""- Update the description for a tag key.+ Soft-delete a single grouped tag from a workflow run. Writes a DELETE event row.Parameters----------- key : str- Tag key to update+ workflow_run_id : str+ Workflow run ID- description : typing.Optional[str]- Free-form description (max 500 chars). Pass null to clear.+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagKey]- Successfully updated tag key+ HttpResponse[RunTagsResponse]+ Successfully deleted tag (or no-op if absent)"""_response = self._client_wrapper.httpx_client.request(- f"v1/tag-keys/{jsonable_encoder(key)}",- method="PATCH",- json={- "description": description,- },- headers={- "content-type": "application/json",- },+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags/{jsonable_encoder(key)}",+ method="DELETE",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagKey,+ RunTagsResponse,parse_obj_as(- type_=TagKey, # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)@@ -1510,48 +1552,62 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def batch_get_workflow_tags(+ def get_run_tag_history(self,+ workflow_run_id: str,*,- workflow_permanent_ids: typing.Optional[str] = None,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[WorkflowTagsBatchResponse]:+ ) -> HttpResponse[RunTagHistoryResponse]:"""- Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.+ Chronological tag-event log for a workflow run (newest first). Includes SET and DELETE events.Parameters----------- workflow_permanent_ids : typing.Optional[str]- Comma-separated workflow permanent IDs+ workflow_run_id : str+ Workflow run ID++ limit : typing.Optional[int]+ Max events to return++ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[WorkflowTagsBatchResponse]- Successfully retrieved tags+ HttpResponse[RunTagHistoryResponse]+ Successfully retrieved tag history"""_response = self._client_wrapper.httpx_client.request(- "v1/workflow-tags",+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags/history",method="GET",params={- "workflow_permanent_ids": workflow_permanent_ids,+ "limit": limit,+ "since": serialize_datetime(since) if since is not None else None,+ "key": key,},request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowTagsBatchResponse,+ RunTagHistoryResponse,parse_obj_as(- type_=WorkflowTagsBatchResponse, # type: ignore+ type_=RunTagHistoryResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(+ if _response.status_code == 404:+ raise NotFoundError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -1577,61 +1633,37 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def batch_get_workflow_tags_post(- self,- *,- workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[WorkflowTagsBatchResponse]:+ def list_tag_keys(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.List[TagKey]]:"""- Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).+ List all tag keys registered for the organization with their descriptions.Parameters----------- workflow_permanent_ids : typing.Optional[typing.Sequence[str]]- Workflow permanent IDs to fetch tags for.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[WorkflowTagsBatchResponse]- Successfully retrieved tags+ HttpResponse[typing.List[TagKey]]+ Successfully retrieved tag keys"""_response = self._client_wrapper.httpx_client.request(- "v1/workflow-tags",- method="POST",- json={- "workflow_permanent_ids": workflow_permanent_ids,- },- headers={- "content-type": "application/json",- },+ "v1/tag-keys",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowTagsBatchResponse,+ typing.List[TagKey],parse_obj_as(- type_=WorkflowTagsBatchResponse, # type: ignore+ type_=typing.List[TagKey], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -1648,49 +1680,51 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_run_artifacts(- self,- run_id: str,- *,- artifact_type: typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[Artifact]]:+ def delete_tag_key(+ self, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagKeyDeleteResponse]:"""- Get artifacts for a run+ Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.Parameters----------- run_id : str- The id of the task run or the workflow run.-- artifact_type : typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]]+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[Artifact]]- Successful Response+ HttpResponse[TagKeyDeleteResponse]+ Successfully deleted tag key"""_response = self._client_wrapper.httpx_client.request(- f"v1/runs/{jsonable_encoder(run_id)}/artifacts",- method="GET",- params={- "artifact_type": artifact_type,- },+ f"v1/tag-keys/{jsonable_encoder(key)}",+ method="DELETE",request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[Artifact],+ TagKeyDeleteResponse,parse_obj_as(- type_=typing.List[Artifact], # type: ignore+ type_=TagKeyDeleteResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -1707,37 +1741,38 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def retry_run_webhook(+ def update_tag_key(self,- run_id: str,+ key: str,*,- request: typing.Optional[RetryRunWebhookRequest] = None,+ description: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[RunWebhookReplayResponse]:+ ) -> HttpResponse[TagKey]:"""- Retry sending the webhook for a run+ Update the description for a tag key.Parameters----------- run_id : str- The id of the task run or the workflow run.+ key : str+ Tag key to update- request : typing.Optional[RetryRunWebhookRequest]+ description : typing.Optional[str]+ Free-form description (max 500 chars). Pass null to clear.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[RunWebhookReplayResponse]- Successful Response+ HttpResponse[TagKey]+ Successfully updated tag key"""_response = self._client_wrapper.httpx_client.request(- f"v1/runs/{jsonable_encoder(run_id)}/retry_webhook",- method="POST",- json=convert_and_respect_annotation_metadata(- object_=request, annotation=RetryRunWebhookRequest, direction="write"- ),+ f"v1/tag-keys/{jsonable_encoder(key)}",+ method="PATCH",+ json={+ "description": description,+ },headers={"content-type": "application/json",},@@ -1747,76 +1782,15 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- RunWebhookReplayResponse,+ TagKey,parse_obj_as(- type_=RunWebhookReplayResponse, # type: ignore+ type_=TagKey, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 422:- raise UnprocessableEntityError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- _response_json = _response.json()- except JSONDecodeError:- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)-- def get_run_timeline(- self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[typing.List[WorkflowRunTimeline]]:- """- Get timeline for a run (workflow run or task_v2 run)-- Parameters- ----------- run_id : str- The id of the workflow run or task_v2 run.-- request_options : typing.Optional[RequestOptions]- Request-specific configuration.-- Returns- -------- HttpResponse[typing.List[WorkflowRunTimeline]]- Successfully retrieved run timeline- """- _response = self._client_wrapper.httpx_client.request(- f"v1/runs/{jsonable_encoder(run_id)}/timeline",- method="GET",- request_options=request_options,- )- try:- if 200 <= _response.status_code < 300:- _data = typing.cast(- typing.List[WorkflowRunTimeline],- parse_obj_as(- type_=typing.List[WorkflowRunTimeline], # type: ignore- object_=_response.json(),- ),- )- return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 404:- raise NotFoundError(+ if _response.status_code == 404:+ raise NotFoundError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -1842,88 +1816,39 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_version(- self, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[typing.Dict[str, str]]:- """- Returns the current Skyvern server version (git SHA for official builds).-- Parameters- ----------- request_options : typing.Optional[RequestOptions]- Request-specific configuration.-- Returns- -------- HttpResponse[typing.Dict[str, str]]- Current server version+ def list_tag_values(+ self, *, key: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.List[TagValue]]:"""- _response = self._client_wrapper.httpx_client.request(- "v1/version",- method="GET",- request_options=request_options,- )- try:- if 200 <= _response.status_code < 300:- _data = typing.cast(- typing.Dict[str, str],- parse_obj_as(- type_=typing.Dict[str, str], # type: ignore- object_=_response.json(),- ),- )- return HttpResponse(response=_response, data=_data)- _response_json = _response.json()- except JSONDecodeError:- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+ List the palette color and current workflow usage count for each grouped tag (key, value) for the organization. The frontend joins these onto tags by (key, value); workflow_count is the number of non-deleted workflows carrying the label and powers the per-label usage and delete blast-radius warnings.- def get_runs_v2(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,- search_key: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[TaskRunListItem]]:- """Parameters----------- page : typing.Optional[int]-- page_size : typing.Optional[int]-- status : typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]]-- search_key : typing.Optional[str]- Case-insensitive substring search (min 3 chars for trigram index).+ key : typing.Optional[str]+ Filter to values for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[TaskRunListItem]]- Successful Response+ HttpResponse[typing.List[TagValue]]+ Successfully retrieved tag values"""_response = self._client_wrapper.httpx_client.request(- "v1/runs",+ "v1/tag-values",method="GET",params={- "page": page,- "page_size": page_size,- "status": status,- "search_key": search_key,+ "key": key,},request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[TaskRunListItem],+ typing.List[TagValue],parse_obj_as(- type_=typing.List[TaskRunListItem], # type: ignore+ type_=typing.List[TagValue], # type: ignoreobject_=_response.json(),),)@@ -1944,43 +1869,61 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def upload_file(- self, *, file: str, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[UploadFileResponse]:+ def delete_tag_value(+ self, key: str, *, value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagValueDeleteResponse]:"""+ Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.+Parameters----------- file : str+ key : str+ Tag key (group)++ value : str+ Tag value (label) under the key to soft-delete.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[UploadFileResponse]- Successful Response+ HttpResponse[TagValueDeleteResponse]+ Successfully deleted tag value"""_response = self._client_wrapper.httpx_client.request(- "v1/upload_file",- method="POST",- data={- "file": file,+ f"v1/tag-values/{jsonable_encoder(key)}",+ method="DELETE",+ json={+ "value": value,+ },+ headers={+ "content-type": "application/json",},- files={},request_options=request_options,omit=OMIT,- force_multipart=True,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- UploadFileResponse,+ TagValueDeleteResponse,parse_obj_as(- type_=UploadFileResponse, # type: ignore+ type_=TagValueDeleteResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -1997,59 +1940,65 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def list_browser_profiles(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- include_deleted: typing.Optional[bool] = None,- search_key: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[BrowserProfile]]:+ def update_tag_value(+ self, key: str, *, value: str, color: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagValue]:"""- Get all browser profiles for the organization+ Recolor a grouped tag (key, value). The value is supplied in the body so values containing '/' stay addressable. The new color must be a palette name.Parameters----------- page : typing.Optional[int]-- page_size : typing.Optional[int]+ key : str+ Tag key (group)- include_deleted : typing.Optional[bool]- Include deleted browser profiles+ value : str+ Tag value (label) under the key to recolor.- search_key : typing.Optional[str]- Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.+ color : str+ Palette color name to assign to this (key, value).request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[BrowserProfile]]- Successfully retrieved browser profiles+ HttpResponse[TagValue]+ Successfully recolored tag value"""_response = self._client_wrapper.httpx_client.request(- "v1/browser_profiles",- method="GET",- params={- "page": page,- "page_size": page_size,- "include_deleted": include_deleted,- "search_key": search_key,+ f"v1/tag-values/{jsonable_encoder(key)}",+ method="PATCH",+ json={+ "value": value,+ "color": color,+ },+ headers={+ "content-type": "application/json",},request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[BrowserProfile],+ TagValue,parse_obj_as(- type_=typing.List[BrowserProfile], # type: ignore+ type_=TagValue, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -2066,60 +2015,37 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def create_browser_profile(- self,- *,- name: str,- description: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[CreateBrowserProfileRequestProxyLocation] = OMIT,- proxy_session_id: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[BrowserProfile]:+ def rename_tag_value(+ self, key: str, *, value: str, new_value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagValueRenameResponse]:"""- Create a blank browser profile, or create one from a persistent browser session or workflow run.+ Rename a grouped tag (key, value) to (key, new_value). The cascade re-tags every workflow carrying the old label; the new label inherits the old color. Both values ride in the body so values containing '/' stay addressable. Rejects with 409 when the new value already exists for the key.Parameters----------- name : str- Name for the browser profile-- description : typing.Optional[str]- Optional profile description-- browser_session_id : typing.Optional[str]- Persistent browser session to convert into a profile. Omit for a blank profile.-- workflow_run_id : typing.Optional[str]- Workflow run whose persisted session should be captured. Omit for a blank profile.+ key : str+ Tag key (group)- proxy_location : typing.Optional[CreateBrowserProfileRequestProxyLocation]- Optional proxy location for this profile's pinned proxy identity.+ value : str+ Current tag value (label) under the key to rename.- proxy_session_id : typing.Optional[str]- Explicit sticky-session id for this profile's pinned proxy identity.+ new_value : str+ New tag value (label) to rename it to.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserProfile]- Successfully created browser profile+ HttpResponse[TagValueRenameResponse]+ Successfully renamed tag value"""_response = self._client_wrapper.httpx_client.request(- "v1/browser_profiles",- method="POST",+ f"v1/tag-values/{jsonable_encoder(key)}/rename",+ method="PATCH",json={- "name": name,- "description": description,- "browser_session_id": browser_session_id,- "workflow_run_id": workflow_run_id,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=CreateBrowserProfileRequestProxyLocation, direction="write"- ),- "proxy_session_id": proxy_session_id,+ "value": value,+ "new_value": new_value,},headers={"content-type": "application/json",@@ -2130,15 +2056,15 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserProfile,+ TagValueRenameResponse,parse_obj_as(- type_=BrowserProfile, # type: ignore+ type_=TagValueRenameResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(+ if _response.status_code == 404:+ raise NotFoundError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2175,42 +2101,48 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_browser_profile(- self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[BrowserProfile]:- """- Get a specific browser profile by ID-- Parameters- ----------- profile_id : str- The ID of the browser profile. browser_profile_id starts with `bp_`+ def batch_get_workflow_tags(+ self,+ *,+ workflow_permanent_ids: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[WorkflowTagsBatchResponse]:+ """+ Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.++ Parameters+ ----------+ workflow_permanent_ids : typing.Optional[str]+ Comma-separated workflow permanent IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserProfile]- Successfully retrieved browser profile+ HttpResponse[WorkflowTagsBatchResponse]+ Successfully retrieved tags"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_profiles/{jsonable_encoder(profile_id)}",+ "v1/workflow-tags",method="GET",+ params={+ "workflow_permanent_ids": workflow_permanent_ids,+ },request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserProfile,+ WorkflowTagsBatchResponse,parse_obj_as(- type_=BrowserProfile, # type: ignore+ type_=WorkflowTagsBatchResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2236,34 +2168,52 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def delete_browser_profile(- self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[None]:+ def batch_get_workflow_tags_post(+ self,+ *,+ workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[WorkflowTagsBatchResponse]:"""- Delete a browser profile (soft delete)+ Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).Parameters----------- profile_id : str- The ID of the browser profile to delete. browser_profile_id starts with `bp_`+ workflow_permanent_ids : typing.Optional[typing.Sequence[str]]+ Workflow permanent IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[None]+ HttpResponse[WorkflowTagsBatchResponse]+ Successfully retrieved tags"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_profiles/{jsonable_encoder(profile_id)}",- method="DELETE",+ "v1/workflow-tags",+ method="POST",+ json={+ "workflow_permanent_ids": workflow_permanent_ids,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:- return HttpResponse(response=_response, data=None)- if _response.status_code == 404:- raise NotFoundError(+ _data = typing.cast(+ WorkflowTagsBatchResponse,+ parse_obj_as(+ type_=WorkflowTagsBatchResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2289,89 +2239,45 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def update_browser_profile(- self,- profile_id: str,- *,- name: typing.Optional[str] = OMIT,- description: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[UpdateBrowserProfileRequestProxyLocation] = OMIT,- proxy_session_id: typing.Optional[str] = OMIT,- rotate_proxy_session_id: typing.Optional[bool] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[BrowserProfile]:+ def batch_get_run_tags(+ self, *, workflow_run_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[RunTagsBatchResponse]:"""- Update a browser profile's name and/or description+ Batch fetch current tags for many workflow runs. Avoids N+1 on run-list pages.Parameters----------- profile_id : str- The ID of the browser profile to update. browser_profile_id starts with `bp_`-- name : typing.Optional[str]- New name for the browser profile-- description : typing.Optional[str]- New description for the browser profile-- proxy_location : typing.Optional[UpdateBrowserProfileRequestProxyLocation]- Optional proxy location for this profile's pinned proxy identity.-- proxy_session_id : typing.Optional[str]- Opaque Skyvern-managed proxy sticky-session id.-- rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id for this profile.+ workflow_run_ids : typing.Optional[str]+ Comma-separated workflow run IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserProfile]- Successfully updated browser profile+ HttpResponse[RunTagsBatchResponse]+ Successfully retrieved tags"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_profiles/{jsonable_encoder(profile_id)}",- method="PATCH",- json={- "name": name,- "description": description,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=UpdateBrowserProfileRequestProxyLocation, direction="write"- ),- "proxy_session_id": proxy_session_id,- "rotate_proxy_session_id": rotate_proxy_session_id,- },- headers={- "content-type": "application/json",+ "v1/run-tags",+ method="GET",+ params={+ "workflow_run_ids": workflow_run_ids,},request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserProfile,+ RunTagsBatchResponse,parse_obj_as(- type_=BrowserProfile, # type: ignore+ type_=RunTagsBatchResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 409:- raise ConflictError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2397,39 +2303,52 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_browser_sessions(- self, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[typing.List[BrowserSessionResponse]]:+ def batch_get_run_tags_post(+ self,+ *,+ workflow_run_ids: typing.Optional[typing.Sequence[str]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[RunTagsBatchResponse]:"""- Get all active browser sessions for the organization+ Batch fetch current tags for many workflow runs (POST variant for id lists exceeding URL length).Parameters----------+ workflow_run_ids : typing.Optional[typing.Sequence[str]]+ Workflow run IDs to fetch tags for.+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[BrowserSessionResponse]]- Successfully retrieved all active browser sessions+ HttpResponse[RunTagsBatchResponse]+ Successfully retrieved tags"""_response = self._client_wrapper.httpx_client.request(- "v1/browser_sessions",- method="GET",+ "v1/run-tags",+ method="POST",+ json={+ "workflow_run_ids": workflow_run_ids,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[BrowserSessionResponse],+ RunTagsBatchResponse,parse_obj_as(- type_=typing.List[BrowserSessionResponse], # type: ignore+ type_=RunTagsBatchResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 403:- raise ForbiddenError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2455,133 +2374,49 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def create_browser_session(+ def get_run_artifacts(self,+ run_id: str,*,- timeout: typing.Optional[int] = OMIT,- proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,- extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,- browser_type: typing.Optional[PersistentBrowserType] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- generate_browser_profile: typing.Optional[bool] = OMIT,+ artifact_type: typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[BrowserSessionResponse]:+ ) -> HttpResponse[typing.List[Artifact]]:"""- Create a browser session that persists across multiple runs+ Get artifacts for a runParameters----------- timeout : typing.Optional[int]- Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.-- proxy_location : typing.Optional[CreateBrowserSessionRequestProxyLocation]-- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.-- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy-- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}-- extensions : typing.Optional[typing.Sequence[Extensions]]- A list of extensions to install in the browser session.-- browser_type : typing.Optional[PersistentBrowserType]- The type of browser to use for the session.-- browser_profile_id : typing.Optional[str]- ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`.+ run_id : str+ The id of the task run or the workflow run.- generate_browser_profile : typing.Optional[bool]- When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.+ artifact_type : typing.Optional[typing.Union[ArtifactType, typing.Sequence[ArtifactType]]]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserSessionResponse]- Successfully created browser session+ HttpResponse[typing.List[Artifact]]+ Successful Response"""_response = self._client_wrapper.httpx_client.request(- "v1/browser_sessions",- method="POST",- json={- "timeout": timeout,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=CreateBrowserSessionRequestProxyLocation, direction="write"- ),- "extensions": extensions,- "browser_type": browser_type,- "browser_profile_id": browser_profile_id,- "generate_browser_profile": generate_browser_profile,- },- headers={- "content-type": "application/json",+ f"v1/runs/{jsonable_encoder(run_id)}/artifacts",+ method="GET",+ params={+ "artifact_type": artifact_type,},request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserSessionResponse,+ typing.List[Artifact],parse_obj_as(- type_=BrowserSessionResponse, # type: ignore+ type_=typing.List[Artifact], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 403:- raise ForbiddenError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -2598,53 +2433,53 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def close_browser_session(- self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[typing.Optional[typing.Any]]:+ def retry_run_webhook(+ self,+ run_id: str,+ *,+ request: typing.Optional[RetryRunWebhookRequest] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[RunWebhookReplayResponse]:"""- Close a session. Once closed, the session cannot be used again.+ Retry sending the webhook for a runParameters----------- browser_session_id : str- The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`+ run_id : str+ The id of the task run or the workflow run.++ request : typing.Optional[RetryRunWebhookRequest]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.Optional[typing.Any]]- Successfully closed browser session+ HttpResponse[RunWebhookReplayResponse]+ Successful Response"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}/close",+ f"v1/runs/{jsonable_encoder(run_id)}/retry_webhook",method="POST",+ json=convert_and_respect_annotation_metadata(+ object_=request, annotation=RetryRunWebhookRequest, direction="write"+ ),+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:- if _response is None or not _response.text.strip():- return HttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- typing.Optional[typing.Any],+ RunWebhookReplayResponse,parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore+ type_=RunWebhookReplayResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 403:- raise ForbiddenError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -2661,42 +2496,42 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_browser_session(- self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[BrowserSessionResponse]:+ def get_run_timeline(+ self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.List[WorkflowRunTimeline]]:"""- Get details about a specific browser session, including the browser address for cdp connection.+ Get timeline for a run (workflow run or task_v2 run)Parameters----------- browser_session_id : str- The ID of the browser session. browser_session_id starts with `pbs_`+ run_id : str+ The id of the workflow run or task_v2 run.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserSessionResponse]- Successfully retrieved browser session details+ HttpResponse[typing.List[WorkflowRunTimeline]]+ Successfully retrieved run timeline"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}",+ f"v1/runs/{jsonable_encoder(run_id)}/timeline",method="GET",request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserSessionResponse,+ typing.List[WorkflowRunTimeline],parse_obj_as(- type_=BrowserSessionResponse, # type: ignore+ type_=typing.List[WorkflowRunTimeline], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 403:- raise ForbiddenError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -2733,178 +2568,92 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def update_browser_session(- self,- browser_session_id: str,- *,- generate_browser_profile: bool,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[BrowserSessionResponse]:+ def get_version(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.Dict[str, str]]:"""- Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.+ Returns the current Skyvern server version (git SHA for official builds).Parameters----------- browser_session_id : str- The ID of the browser session. browser_session_id starts with `pbs_`-- generate_browser_profile : bool- Enable or disable saving this session's browser profile when it ends. Can be toggled while the session is still alive; the value is read at session teardown.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[BrowserSessionResponse]- Successfully updated browser session+ HttpResponse[typing.Dict[str, str]]+ Current server version"""_response = self._client_wrapper.httpx_client.request(- f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}",- method="PATCH",- json={- "generate_browser_profile": generate_browser_profile,- },- headers={- "content-type": "application/json",- },+ "v1/version",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BrowserSessionResponse,+ typing.Dict[str, str],parse_obj_as(- type_=BrowserSessionResponse, # type: ignore+ type_=typing.Dict[str, str], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 403:- raise ForbiddenError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 409:- raise ConflictError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 422:- raise UnprocessableEntityError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )_response_json = _response.json()except JSONDecodeError:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def send_totp_code(+ def get_runs_v2(self,*,- totp_identifier: str,- content: str,- task_id: typing.Optional[str] = OMIT,- workflow_id: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- source: typing.Optional[str] = OMIT,- expired_at: typing.Optional[dt.datetime] = OMIT,- type: typing.Optional[OtpType] = OMIT,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ run_type: typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[TotpCode]:+ ) -> HttpResponse[typing.List[TaskRunListItem]]:"""- Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.-Parameters----------- totp_identifier : str- The identifier of the TOTP code. It can be the email address, phone number, or the identifier of the user.-- content : str- The content of the TOTP code. It can be the email content that contains the TOTP code, or the sms message that contains the TOTP code. Skyvern will automatically extract the TOTP code from the content.-- task_id : typing.Optional[str]- The task_id the totp code is for. It can be the task_id of the task that the TOTP code is for.-- workflow_id : typing.Optional[str]- The workflow ID the TOTP code is for. It can be the workflow ID of the workflow that the TOTP code is for.+ page : typing.Optional[int]- workflow_run_id : typing.Optional[str]- The workflow run id that the TOTP code is for. It can be the workflow run id of the workflow run that the TOTP code is for.+ page_size : typing.Optional[int]- source : typing.Optional[str]- An optional field. The source of the TOTP code. e.g. email, sms, etc.+ status : typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]]- expired_at : typing.Optional[dt.datetime]- The timestamp when the TOTP code expires+ search_key : typing.Optional[str]+ Case-insensitive substring search (min 3 chars for trigram index).- type : typing.Optional[OtpType]- Optional. If provided, forces extraction of this specific OTP type (totp or magic_link). Use this when the content contains multiple OTP types and you want to specify which one to extract.+ run_type : typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TotpCode]+ HttpResponse[typing.List[TaskRunListItem]]Successful Response"""_response = self._client_wrapper.httpx_client.request(- "v1/credentials/totp",- method="POST",- json={- "totp_identifier": totp_identifier,- "task_id": task_id,- "workflow_id": workflow_id,- "workflow_run_id": workflow_run_id,- "source": source,- "content": content,- "expired_at": expired_at,- "type": type,- },- headers={- "content-type": "application/json",+ "v1/runs",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ "status": status,+ "search_key": search_key,+ "run_type": run_type,},request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TotpCode,+ typing.List[TaskRunListItem],parse_obj_as(- type_=TotpCode, # type: ignore+ type_=typing.List[TaskRunListItem], # type: ignoreobject_=_response.json(),),)@@ -2925,62 +2674,39 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_credentials(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- vault_type: typing.Optional[CredentialVaultType] = None,- credential_type: typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType] = None,- search: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[CredentialResponse]]:+ def upload_file(+ self, *, file: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[UploadFileResponse]:"""- Retrieves a paginated list of credentials for the current organization-Parameters----------- page : typing.Optional[int]- Page number for pagination-- page_size : typing.Optional[int]- Number of items per page-- vault_type : typing.Optional[CredentialVaultType]- Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')-- credential_type : typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType]- Filter credentials by type (e.g. 'password', 'credit_card', 'secret')-- search : typing.Optional[str]- Case-insensitive search across credential name, username, secret label, and card details+ file : strrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[CredentialResponse]]+ HttpResponse[UploadFileResponse]Successful Response"""_response = self._client_wrapper.httpx_client.request(- "v1/credentials",- method="GET",- params={- "page": page,- "page_size": page_size,- "vault_type": vault_type,- "credential_type": credential_type,- "search": search,+ "v1/upload_file",+ method="POST",+ data={+ "file": file,},+ files={},request_options=request_options,+ omit=OMIT,+ force_multipart=True,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[CredentialResponse],+ UploadFileResponse,parse_obj_as(- type_=typing.List[CredentialResponse], # type: ignore+ type_=UploadFileResponse, # type: ignoreobject_=_response.json(),),)@@ -3001,80 +2727,60 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def create_credential(+ def list_browser_profiles(self,*,- name: str,- credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,- credential: CreateCredentialRequestCredential,- vault_type: typing.Optional[CredentialVaultType] = OMIT,- proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,- proxy_session_id: typing.Optional[str] = OMIT,- rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ include_deleted: typing.Optional[bool] = None,+ search_key: typing.Optional[str] = None,+ managed: typing.Optional[bool] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[CredentialResponse]:+ ) -> HttpResponse[typing.List[BrowserProfile]]:"""- Creates a new credential for the current organization+ Get all browser profiles for the organizationParameters----------- name : str- Name of the credential-- credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType- Type of credential to create-- credential : CreateCredentialRequestCredential- The credential data to store+ page : typing.Optional[int]- vault_type : typing.Optional[CredentialVaultType]- Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.+ page_size : typing.Optional[int]- proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]- Optional proxy location for this credential's pinned proxy identity.+ include_deleted : typing.Optional[bool]+ Include deleted browser profiles- proxy_session_id : typing.Optional[str]- Optional advanced reuse key for this credential's pinned proxy identity.+ search_key : typing.Optional[str]+ Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.- rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id when updating this credential.+ managed : typing.Optional[bool]+ Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[CredentialResponse]- Successful Response+ HttpResponse[typing.List[BrowserProfile]]+ Successfully retrieved browser profiles"""_response = self._client_wrapper.httpx_client.request(- "v1/credentials",- method="POST",- json={- "name": name,- "credential_type": credential_type,- "credential": convert_and_respect_annotation_metadata(- object_=credential, annotation=CreateCredentialRequestCredential, direction="write"- ),- "vault_type": vault_type,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=CreateCredentialRequestProxyLocation, direction="write"- ),- "proxy_session_id": proxy_session_id,- "rotate_proxy_session_id": rotate_proxy_session_id,- },- headers={- "content-type": "application/json",+ "v1/browser_profiles",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ "include_deleted": include_deleted,+ "search_key": search_key,+ "managed": managed,},request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- CredentialResponse,+ typing.List[BrowserProfile],parse_obj_as(- type_=CredentialResponse, # type: ignore+ type_=typing.List[BrowserProfile], # type: ignoreobject_=_response.json(),),)@@ -3095,71 +2801,60 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def update_credential(+ def create_browser_profile(self,- credential_id: str,*,name: str,- credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,- credential: CreateCredentialRequestCredential,- vault_type: typing.Optional[CredentialVaultType] = OMIT,- proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ description: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[CreateBrowserProfileRequestProxyLocation] = OMIT,proxy_session_id: typing.Optional[str] = OMIT,- rotate_proxy_session_id: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[CredentialResponse]:+ ) -> HttpResponse[BrowserProfile]:"""- Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.+ Create a blank browser profile, or create one from a persistent browser session or workflow run.Parameters----------- credential_id : str- The unique identifier of the credential to update-name : str- Name of the credential+ Name for the browser profile- credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType- Type of credential to create+ description : typing.Optional[str]+ Optional profile description- credential : CreateCredentialRequestCredential- The credential data to store+ browser_session_id : typing.Optional[str]+ Persistent browser session to convert into a profile. Omit for a blank profile.- vault_type : typing.Optional[CredentialVaultType]- Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.+ workflow_run_id : typing.Optional[str]+ Workflow run whose persisted session should be captured. Omit for a blank profile.- proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]- Optional proxy location for this credential's pinned proxy identity.+ proxy_location : typing.Optional[CreateBrowserProfileRequestProxyLocation]+ Optional proxy location for this profile's pinned proxy identity.proxy_session_id : typing.Optional[str]- Optional advanced reuse key for this credential's pinned proxy identity.-- rotate_proxy_session_id : typing.Optional[bool]- Rotate the Skyvern-managed proxy sticky-session id when updating this credential.+ Explicit sticky-session id for this profile's pinned proxy identity.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[CredentialResponse]- Successful Response+ HttpResponse[BrowserProfile]+ Successfully created browser profile"""_response = self._client_wrapper.httpx_client.request(- f"v1/credentials/{jsonable_encoder(credential_id)}/update",+ "v1/browser_profiles",method="POST",json={"name": name,- "credential_type": credential_type,- "credential": convert_and_respect_annotation_metadata(- object_=credential, annotation=CreateCredentialRequestCredential, direction="write"- ),- "vault_type": vault_type,+ "description": description,+ "browser_session_id": browser_session_id,+ "workflow_run_id": workflow_run_id,"proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=CreateCredentialRequestProxyLocation, direction="write"+ object_=proxy_location, annotation=CreateBrowserProfileRequestProxyLocation, direction="write"),"proxy_session_id": proxy_session_id,- "rotate_proxy_session_id": rotate_proxy_session_id,},headers={"content-type": "application/json",@@ -3170,13 +2865,35 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- CredentialResponse,+ BrowserProfile,parse_obj_as(- type_=CredentialResponse, # type: ignore+ type_=BrowserProfile, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3193,32 +2910,51 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def delete_credential(- self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[None]:+ def get_browser_profile(+ self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[BrowserProfile]:"""- Deletes a specific credential by its ID+ Get a specific browser profile by IDParameters----------- credential_id : str- The unique identifier of the credential to delete+ profile_id : str+ The ID of the browser profile. browser_profile_id starts with `bp_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[None]+ HttpResponse[BrowserProfile]+ Successfully retrieved browser profile"""_response = self._client_wrapper.httpx_client.request(- f"v1/credentials/{jsonable_encoder(credential_id)}/delete",- method="POST",+ f"v1/browser_profiles/{jsonable_encoder(profile_id)}",+ method="GET",request_options=request_options,)try:if 200 <= _response.status_code < 300:- return HttpResponse(response=_response, data=None)+ _data = typing.cast(+ BrowserProfile,+ parse_obj_as(+ type_=BrowserProfile, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3235,40 +2971,43 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_credential(- self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[CredentialResponse]:+ def delete_browser_profile(+ self, profile_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[None]:"""- Retrieves a specific credential by its ID+ Delete a browser profile (soft delete)Parameters----------- credential_id : str- The unique identifier of the credential+ profile_id : str+ The ID of the browser profile to delete. browser_profile_id starts with `bp_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[CredentialResponse]- Successful Response+ HttpResponse[None]"""_response = self._client_wrapper.httpx_client.request(- f"v1/credentials/{jsonable_encoder(credential_id)}",- method="GET",+ f"v1/browser_profiles/{jsonable_encoder(profile_id)}",+ method="DELETE",request_options=request_options,)try:if 200 <= _response.status_code < 300:- _data = typing.cast(- CredentialResponse,- parse_obj_as(- type_=CredentialResponse, # type: ignore- object_=_response.json(),+ return HttpResponse(response=_response, data=None)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),),)- return HttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3285,145 +3024,62 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def login(+ def update_browser_profile(self,+ profile_id: str,*,- credential_type: SkyvernSchemasCredentialTypeCredentialType,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[ProxyLocation] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_screenshot_scrolling_times: typing.Optional[int] = OMIT,- prompt: typing.Optional[str] = OMIT,- credential_id: typing.Optional[str] = OMIT,- bitwarden_collection_id: typing.Optional[str] = OMIT,- bitwarden_item_id: typing.Optional[str] = OMIT,- onepassword_vault_id: typing.Optional[str] = OMIT,- onepassword_item_id: typing.Optional[str] = OMIT,- azure_vault_name: typing.Optional[str] = OMIT,- azure_vault_username_key: typing.Optional[str] = OMIT,- azure_vault_password_key: typing.Optional[str] = OMIT,- azure_vault_totp_secret_key: typing.Optional[str] = OMIT,+ name: typing.Optional[str] = OMIT,+ description: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[UpdateBrowserProfileRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ rotate_proxy_session_id: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[WorkflowRunResponse]:+ ) -> HttpResponse[BrowserProfile]:"""- Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure Vault+ Update a browser profile's name and/or descriptionParameters----------- credential_type : SkyvernSchemasCredentialTypeCredentialType- Where to get the credential from-- user_agent : typing.Optional[str]-- url : typing.Optional[str]- Website URL-- webhook_url : typing.Optional[str]- Webhook URL to send status updates-- proxy_location : typing.Optional[ProxyLocation]- Proxy location to use-- totp_identifier : typing.Optional[str]- Identifier for TOTP (Time-based One-Time Password) if required-- totp_url : typing.Optional[str]- TOTP URL to fetch one-time passwords-- browser_session_id : typing.Optional[str]- ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`-- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this run-- browser_address : typing.Optional[str]- The CDP address for the task.-- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- Additional HTTP headers to include in requests-- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.-- max_screenshot_scrolling_times : typing.Optional[int]- Maximum number of times to scroll for screenshots-- prompt : typing.Optional[str]- Login instructions. Skyvern has default prompt/instruction for login if this field is not provided.-- credential_id : typing.Optional[str]- ID of the Skyvern credential to use for login.-- bitwarden_collection_id : typing.Optional[str]- Bitwarden collection ID. You can find it in the Bitwarden collection URL. e.g. `https://vault.bitwarden.com/vaults/collection_id/items`-- bitwarden_item_id : typing.Optional[str]- Bitwarden item ID-- onepassword_vault_id : typing.Optional[str]- 1Password vault ID+ profile_id : str+ The ID of the browser profile to update. browser_profile_id starts with `bp_`- onepassword_item_id : typing.Optional[str]- 1Password item ID+ name : typing.Optional[str]+ New name for the browser profile- azure_vault_name : typing.Optional[str]- Azure Vault Name+ description : typing.Optional[str]+ New description for the browser profile- azure_vault_username_key : typing.Optional[str]- Azure Vault username key+ proxy_location : typing.Optional[UpdateBrowserProfileRequestProxyLocation]+ Optional proxy location for this profile's pinned proxy identity.- azure_vault_password_key : typing.Optional[str]- Azure Vault password key+ proxy_session_id : typing.Optional[str]+ Opaque Skyvern-managed proxy sticky-session id.- azure_vault_totp_secret_key : typing.Optional[str]- Azure Vault TOTP secret key+ rotate_proxy_session_id : typing.Optional[bool]+ Rotate the Skyvern-managed proxy sticky-session id for this profile.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[WorkflowRunResponse]- Successful Response+ HttpResponse[BrowserProfile]+ Successfully updated browser profile"""_response = self._client_wrapper.httpx_client.request(- "v1/run/tasks/login",- method="POST",+ f"v1/browser_profiles/{jsonable_encoder(profile_id)}",+ method="PATCH",json={- "url": url,- "webhook_url": webhook_url,- "proxy_location": proxy_location,- "totp_identifier": totp_identifier,- "totp_url": totp_url,- "browser_session_id": browser_session_id,- "browser_profile_id": browser_profile_id,- "browser_address": browser_address,- "extra_http_headers": extra_http_headers,- "cdp_connect_headers": cdp_connect_headers,- "max_screenshot_scrolling_times": max_screenshot_scrolling_times,- "credential_type": credential_type,- "prompt": prompt,- "credential_id": credential_id,- "bitwarden_collection_id": bitwarden_collection_id,- "bitwarden_item_id": bitwarden_item_id,- "onepassword_vault_id": onepassword_vault_id,- "onepassword_item_id": onepassword_item_id,- "azure_vault_name": azure_vault_name,- "azure_vault_username_key": azure_vault_username_key,- "azure_vault_password_key": azure_vault_password_key,- "azure_vault_totp_secret_key": azure_vault_totp_secret_key,+ "name": name,+ "description": description,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=UpdateBrowserProfileRequestProxyLocation, direction="write"+ ),+ "proxy_session_id": proxy_session_id,+ "rotate_proxy_session_id": rotate_proxy_session_id,},headers={"content-type": "application/json",- "x-user-agent": str(user_agent) if user_agent is not None else None,},request_options=request_options,omit=OMIT,@@ -3431,13 +3087,35 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowRunResponse,+ BrowserProfile,parse_obj_as(- type_=WorkflowRunResponse, # type: ignore+ type_=BrowserProfile, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3454,126 +3132,39 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def download_files(- self,- *,- navigation_goal: str,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[ProxyLocation] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_screenshot_scrolling_times: typing.Optional[int] = OMIT,- download_suffix: typing.Optional[str] = OMIT,- download_timeout: typing.Optional[float] = OMIT,- max_steps_per_run: typing.Optional[int] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[WorkflowRunResponse]:+ def get_browser_sessions(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.List[BrowserSessionResponse]]:"""- Download a file from a website by navigating and clicking download buttons+ Get all active browser sessions for the organizationParameters----------- navigation_goal : str- Instructions for navigating to and downloading the file-- user_agent : typing.Optional[str]-- url : typing.Optional[str]- Website URL-- webhook_url : typing.Optional[str]- Webhook URL to send status updates-- proxy_location : typing.Optional[ProxyLocation]- Proxy location to use-- totp_identifier : typing.Optional[str]- Identifier for TOTP (Time-based One-Time Password) if required-- totp_url : typing.Optional[str]- TOTP URL to fetch one-time passwords-- browser_session_id : typing.Optional[str]- ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`-- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this run-- browser_address : typing.Optional[str]- The CDP address for the task.-- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- Additional HTTP headers to include in requests-- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.-- max_screenshot_scrolling_times : typing.Optional[int]- Maximum number of times to scroll for screenshots-- download_suffix : typing.Optional[str]- Suffix or complete filename for the downloaded file-- download_timeout : typing.Optional[float]- Timeout in seconds for the download operation-- max_steps_per_run : typing.Optional[int]- Maximum number of steps to execute-- request_options : typing.Optional[RequestOptions]- Request-specific configuration.+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.Returns-------- HttpResponse[WorkflowRunResponse]- Successful Response+ HttpResponse[typing.List[BrowserSessionResponse]]+ Successfully retrieved all active browser sessions"""_response = self._client_wrapper.httpx_client.request(- "v1/run/tasks/download_files",- method="POST",- json={- "url": url,- "webhook_url": webhook_url,- "proxy_location": proxy_location,- "totp_identifier": totp_identifier,- "totp_url": totp_url,- "browser_session_id": browser_session_id,- "browser_profile_id": browser_profile_id,- "browser_address": browser_address,- "extra_http_headers": extra_http_headers,- "cdp_connect_headers": cdp_connect_headers,- "max_screenshot_scrolling_times": max_screenshot_scrolling_times,- "navigation_goal": navigation_goal,- "download_suffix": download_suffix,- "download_timeout": download_timeout,- "max_steps_per_run": max_steps_per_run,- },- headers={- "content-type": "application/json",- "x-user-agent": str(user_agent) if user_agent is not None else None,- },+ "v1/browser_sessions",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowRunResponse,+ typing.List[BrowserSessionResponse],parse_obj_as(- type_=WorkflowRunResponse, # type: ignore+ type_=typing.List[BrowserSessionResponse], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 422:- raise UnprocessableEntityError(+ if _response.status_code == 403:+ raise ForbiddenError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -3583,56 +3174,6 @@ class RawSkyvern:),),)- _response_json = _response.json()- except JSONDecodeError:- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)-- def get_scripts(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[Script]]:- """- Retrieves a paginated list of scripts for the current organization-- Parameters- ----------- page : typing.Optional[int]- Page number for pagination-- page_size : typing.Optional[int]- Number of items per page-- request_options : typing.Optional[RequestOptions]- Request-specific configuration.-- Returns- -------- HttpResponse[typing.List[Script]]- Successful Response- """- _response = self._client_wrapper.httpx_client.request(- "v1/scripts",- method="GET",- params={- "page": page,- "page_size": page_size,- },- request_options=request_options,- )- try:- if 200 <= _response.status_code < 300:- _data = typing.cast(- typing.List[Script],- parse_obj_as(- type_=typing.List[Script], # type: ignore- object_=_response.json(),- ),- )- return HttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3649,45 +3190,99 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def create_script(+ def create_browser_session(self,*,- workflow_id: typing.Optional[str] = OMIT,- run_id: typing.Optional[str] = OMIT,- files: typing.Optional[typing.Sequence[ScriptFileCreate]] = OMIT,+ timeout: typing.Optional[int] = OMIT,+ proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,+ browser_type: typing.Optional[PersistentBrowserType] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ generate_browser_profile: typing.Optional[bool] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[CreateScriptResponse]:+ ) -> HttpResponse[BrowserSessionResponse]:"""- Create a new script with optional files and metadata+ Create a browser session that persists across multiple runsParameters----------- workflow_id : typing.Optional[str]- Associated workflow ID+ timeout : typing.Optional[int]+ Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.- run_id : typing.Optional[str]- Associated run ID+ proxy_location : typing.Optional[CreateBrowserSessionRequestProxyLocation]- files : typing.Optional[typing.Sequence[ScriptFileCreate]]- Array of files to include in the script+ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.++ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy++ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}++ proxy_session_id : typing.Optional[str]+ Opaque Skyvern-managed proxy sticky-session id for pinned Residential ISP sessions.++ extensions : typing.Optional[typing.Sequence[Extensions]]+ A list of extensions to install in the browser session.++ browser_type : typing.Optional[PersistentBrowserType]+ The type of browser to use for the session.++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`.++ generate_browser_profile : typing.Optional[bool]+ When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[CreateScriptResponse]- Successful Response+ HttpResponse[BrowserSessionResponse]+ Successfully created browser session"""_response = self._client_wrapper.httpx_client.request(- "v1/scripts",+ "v1/browser_sessions",method="POST",json={- "workflow_id": workflow_id,- "run_id": run_id,- "files": convert_and_respect_annotation_metadata(- object_=files, annotation=typing.Sequence[ScriptFileCreate], direction="write"+ "timeout": timeout,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=CreateBrowserSessionRequestProxyLocation, direction="write"),+ "proxy_session_id": proxy_session_id,+ "extensions": extensions,+ "browser_type": browser_type,+ "browser_profile_id": browser_profile_id,+ "generate_browser_profile": generate_browser_profile,},headers={"content-type": "application/json",@@ -3698,13 +3293,35 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- CreateScriptResponse,+ BrowserSessionResponse,parse_obj_as(- type_=CreateScriptResponse, # type: ignore+ type_=BrowserSessionResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3721,42 +3338,44 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_script(- self, script_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[Script]:+ def close_browser_session(+ self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[typing.Optional[typing.Any]]:"""- Retrieves a specific script by its ID+ Close a session. Once closed, the session cannot be used again.Parameters----------- script_id : str- The unique identifier of the script+ browser_session_id : str+ The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[Script]- Successful Response+ HttpResponse[typing.Optional[typing.Any]]+ Successfully closed browser session"""_response = self._client_wrapper.httpx_client.request(- f"v1/scripts/{jsonable_encoder(script_id)}",- method="GET",+ f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}/close",+ method="POST",request_options=request_options,)try:+ if _response is None or not _response.text.strip():+ return HttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- Script,+ typing.Optional[typing.Any],parse_obj_as(- type_=Script, # type: ignore+ type_=typing.Optional[typing.Any], # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 422:- raise UnprocessableEntityError(+ if _response.status_code == 403:+ raise ForbiddenError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -3766,61 +3385,17 @@ class RawSkyvern:),),)- _response_json = _response.json()- except JSONDecodeError:- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)- raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)-- def deploy_script(- self,- script_id: str,- *,- files: typing.Sequence[ScriptFileCreate],- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[CreateScriptResponse]:- """- Deploy a script with updated files, creating a new version-- Parameters- ----------- script_id : str- The unique identifier of the script-- files : typing.Sequence[ScriptFileCreate]- Array of files to include in the script-- request_options : typing.Optional[RequestOptions]- Request-specific configuration.-- Returns- -------- HttpResponse[CreateScriptResponse]- Successful Response- """- _response = self._client_wrapper.httpx_client.request(- f"v1/scripts/{jsonable_encoder(script_id)}/deploy",- method="POST",- json={- "files": convert_and_respect_annotation_metadata(- object_=files, annotation=typing.Sequence[ScriptFileCreate], direction="write"- ),- },- headers={- "content-type": "application/json",- },- request_options=request_options,- omit=OMIT,- )- try:- if 200 <= _response.status_code < 300:- _data = typing.cast(- CreateScriptResponse,- parse_obj_as(- type_=CreateScriptResponse, # type: ignore- object_=_response.json(),+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),),)- return HttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3837,72 +3412,62 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def run_sdk_action(- self,- *,- url: str,- action: RunSdkActionRequestAction,- browser_session_id: typing.Optional[str] = OMIT,- browser_address: typing.Optional[str] = OMIT,- workflow_run_id: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[RunSdkActionResponse]:+ def get_browser_session(+ self, browser_session_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[BrowserSessionResponse]:"""- Execute a single SDK action with the specified parameters+ Get details about a specific browser session, including the browser address for cdp connection.Parameters----------- url : str- The URL where the action should be executed-- action : RunSdkActionRequestAction- The action to execute with its specific parameters-- browser_session_id : typing.Optional[str]- The browser session ID-- browser_address : typing.Optional[str]- The browser address-- workflow_run_id : typing.Optional[str]- Optional workflow run ID to continue an existing workflow run+ browser_session_id : str+ The ID of the browser session. browser_session_id starts with `pbs_`request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[RunSdkActionResponse]- Successful Response+ HttpResponse[BrowserSessionResponse]+ Successfully retrieved browser session details"""_response = self._client_wrapper.httpx_client.request(- "v1/sdk/run_action",- method="POST",- json={- "url": url,- "browser_session_id": browser_session_id,- "browser_address": browser_address,- "workflow_run_id": workflow_run_id,- "action": convert_and_respect_annotation_metadata(- object_=action, annotation=RunSdkActionRequestAction, direction="write"- ),- },- headers={- "content-type": "application/json",- },+ f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- RunSdkActionResponse,+ BrowserSessionResponse,parse_obj_as(- type_=RunSdkActionResponse, # type: ignore+ type_=BrowserSessionResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -3919,37 +3484,37 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def update_workflow_folder(+ def update_browser_session(self,- workflow_permanent_id: str,+ browser_session_id: str,*,- folder_id: typing.Optional[str] = OMIT,+ generate_browser_profile: bool,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[Workflow]:+ ) -> HttpResponse[BrowserSessionResponse]:"""- Update a workflow's folder assignment for the latest version+ Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.Parameters----------- workflow_permanent_id : str- Workflow permanent ID+ browser_session_id : str+ The ID of the browser session. browser_session_id starts with `pbs_`- folder_id : typing.Optional[str]- Folder ID to assign workflow to. Set to null to remove from folder.+ generate_browser_profile : bool+ Enable or disable saving this session's browser profile when it ends. Can be toggled while the session is still alive; the value is read at session teardown.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[Workflow]- Successfully updated workflow folder+ HttpResponse[BrowserSessionResponse]+ Successfully updated browser session"""_response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/folder",- method="PUT",+ f"v1/browser_sessions/{jsonable_encoder(browser_session_id)}",+ method="PATCH",json={- "folder_id": folder_id,+ "generate_browser_profile": generate_browser_profile,},headers={"content-type": "application/json",@@ -3960,15 +3525,15 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- Workflow,+ BrowserSessionResponse,parse_obj_as(- type_=Workflow, # type: ignore+ type_=BrowserSessionResponse, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(+ if _response.status_code == 403:+ raise ForbiddenError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -3989,6 +3554,17 @@ class RawSkyvern:),),)+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4005,42 +3581,87 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow_tags(- self, workflow_permanent_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[TagsResponse]:+ def send_totp_code(+ self,+ *,+ totp_identifier: str,+ content: str,+ task_id: typing.Optional[str] = OMIT,+ workflow_id: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ source: typing.Optional[str] = OMIT,+ expired_at: typing.Optional[dt.datetime] = OMIT,+ type: typing.Optional[OtpType] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[TotpCode]:"""- Get the current tag state for a workflow.+ Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.Parameters----------- workflow_permanent_id : str- Workflow permanent ID+ totp_identifier : str+ The identifier of the TOTP code. It can be the email address, phone number, or the identifier of the user.++ content : str+ The content of the TOTP code. It can be the email content that contains the TOTP code, or the sms message that contains the TOTP code. Skyvern will automatically extract the TOTP code from the content.++ task_id : typing.Optional[str]+ The task_id the totp code is for. It can be the task_id of the task that the TOTP code is for.++ workflow_id : typing.Optional[str]+ The workflow ID the TOTP code is for. It can be the workflow ID of the workflow that the TOTP code is for.++ workflow_run_id : typing.Optional[str]+ The workflow run id that the TOTP code is for. It can be the workflow run id of the workflow run that the TOTP code is for.++ source : typing.Optional[str]+ An optional field. The source of the TOTP code. e.g. email, sms, etc.++ expired_at : typing.Optional[dt.datetime]+ The timestamp when the TOTP code expires++ type : typing.Optional[OtpType]+ Optional. If provided, forces extraction of this specific OTP type (totp or magic_link). Use this when the content contains multiple OTP types and you want to specify which one to extract.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagsResponse]- Successfully retrieved tags+ HttpResponse[TotpCode]+ Successful Response"""_response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags",- method="GET",+ "v1/credentials/totp",+ method="POST",+ json={+ "totp_identifier": totp_identifier,+ "task_id": task_id,+ "workflow_id": workflow_id,+ "workflow_run_id": workflow_run_id,+ "source": source,+ "content": content,+ "expired_at": expired_at,+ "type": type,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagsResponse,+ TotpCode,parse_obj_as(- type_=TagsResponse, # type: ignore+ type_=TotpCode, # type: ignoreobject_=_response.json(),),)return HttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(+ if _response.status_code == 422:+ raise UnprocessableEntityError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -4050,9 +3671,2220 @@ class RawSkyvern:),),)- if _response.status_code == 422:- raise UnprocessableEntityError(- headers=dict(_response.headers),+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_credentials(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ vault_type: typing.Optional[CredentialVaultType] = None,+ credential_type: typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType] = None,+ search: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[typing.List[CredentialResponse]]:+ """+ Retrieves a paginated list of credentials for the current organization++ Parameters+ ----------+ page : typing.Optional[int]+ Page number for pagination++ page_size : typing.Optional[int]+ Number of items per page++ vault_type : typing.Optional[CredentialVaultType]+ Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')++ credential_type : typing.Optional[SkyvernForgeSdkSchemasCredentialsCredentialType]+ Filter credentials by type (e.g. 'password', 'credit_card', 'secret')++ search : typing.Optional[str]+ Case-insensitive search across credential name, username, secret label, and card details++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[typing.List[CredentialResponse]]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/credentials",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ "vault_type": vault_type,+ "credential_type": credential_type,+ "search": search,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ typing.List[CredentialResponse],+ parse_obj_as(+ type_=typing.List[CredentialResponse], # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_credential(+ self,+ *,+ name: str,+ credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,+ credential: CreateCredentialRequestCredential,+ vault_type: typing.Optional[CredentialVaultType] = OMIT,+ proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[CredentialResponse]:+ """+ Creates a new credential for the current organization++ Parameters+ ----------+ name : str+ Name of the credential++ credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType+ Type of credential to create++ credential : CreateCredentialRequestCredential+ The credential data to store++ vault_type : typing.Optional[CredentialVaultType]+ Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.++ proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]+ Optional proxy location for this credential's pinned proxy identity.++ proxy_session_id : typing.Optional[str]+ Optional advanced reuse key for this credential's pinned proxy identity.++ rotate_proxy_session_id : typing.Optional[bool]+ Rotate the Skyvern-managed proxy sticky-session id when updating this credential.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CredentialResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/credentials",+ method="POST",+ json={+ "name": name,+ "credential_type": credential_type,+ "credential": convert_and_respect_annotation_metadata(+ object_=credential, annotation=CreateCredentialRequestCredential, direction="write"+ ),+ "vault_type": vault_type,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=CreateCredentialRequestProxyLocation, direction="write"+ ),+ "proxy_session_id": proxy_session_id,+ "rotate_proxy_session_id": rotate_proxy_session_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CredentialResponse,+ parse_obj_as(+ type_=CredentialResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update_credential(+ self,+ credential_id: str,+ *,+ name: str,+ credential_type: SkyvernForgeSdkSchemasCredentialsCredentialType,+ credential: CreateCredentialRequestCredential,+ vault_type: typing.Optional[CredentialVaultType] = OMIT,+ proxy_location: typing.Optional[CreateCredentialRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,+ rotate_proxy_session_id: typing.Optional[bool] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[CredentialResponse]:+ """+ Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.++ Parameters+ ----------+ credential_id : str+ The unique identifier of the credential to update++ name : str+ Name of the credential++ credential_type : SkyvernForgeSdkSchemasCredentialsCredentialType+ Type of credential to create++ credential : CreateCredentialRequestCredential+ The credential data to store++ vault_type : typing.Optional[CredentialVaultType]+ Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.++ proxy_location : typing.Optional[CreateCredentialRequestProxyLocation]+ Optional proxy location for this credential's pinned proxy identity.++ proxy_session_id : typing.Optional[str]+ Optional advanced reuse key for this credential's pinned proxy identity.++ rotate_proxy_session_id : typing.Optional[bool]+ Rotate the Skyvern-managed proxy sticky-session id when updating this credential.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CredentialResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/credentials/{jsonable_encoder(credential_id)}/update",+ method="POST",+ json={+ "name": name,+ "credential_type": credential_type,+ "credential": convert_and_respect_annotation_metadata(+ object_=credential, annotation=CreateCredentialRequestCredential, direction="write"+ ),+ "vault_type": vault_type,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=CreateCredentialRequestProxyLocation, direction="write"+ ),+ "proxy_session_id": proxy_session_id,+ "rotate_proxy_session_id": rotate_proxy_session_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CredentialResponse,+ parse_obj_as(+ type_=CredentialResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete_credential(+ self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[None]:+ """+ Deletes a specific credential by its ID++ Parameters+ ----------+ credential_id : str+ The unique identifier of the credential to delete++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[None]+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/credentials/{jsonable_encoder(credential_id)}/delete",+ method="POST",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ return HttpResponse(response=_response, data=None)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_credential(+ self, credential_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CredentialResponse]:+ """+ Retrieves a specific credential by its ID++ Parameters+ ----------+ credential_id : str+ The unique identifier of the credential++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CredentialResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/credentials/{jsonable_encoder(credential_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CredentialResponse,+ parse_obj_as(+ type_=CredentialResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_custom_llms(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CustomLlmListResponse]:+ """+ List the custom LLM configurations available to the current organization.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CustomLlmListResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/custom-llms",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmListResponse,+ parse_obj_as(+ type_=CustomLlmListResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_custom_llm(+ self, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CustomLlmResponse]:+ """+ Create a custom LLM configuration for the current organization.++ Parameters+ ----------+ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CustomLlmResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/custom-llms",+ method="POST",+ json={+ "config": convert_and_respect_annotation_metadata(+ object_=config, annotation=CustomLlmConfig, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmResponse,+ parse_obj_as(+ type_=CustomLlmResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update_custom_llm(+ self, custom_llm_id: str, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CustomLlmResponse]:+ """+ Update a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CustomLlmResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/custom-llms/{jsonable_encoder(custom_llm_id)}",+ method="PUT",+ json={+ "config": convert_and_respect_annotation_metadata(+ object_=config, annotation=CustomLlmConfig, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmResponse,+ parse_obj_as(+ type_=CustomLlmResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete_custom_llm(+ self, custom_llm_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ClearOrganizationAuthTokenResponse]:+ """+ Delete a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ClearOrganizationAuthTokenResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/custom-llms/{jsonable_encoder(custom_llm_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ClearOrganizationAuthTokenResponse,+ parse_obj_as(+ type_=ClearOrganizationAuthTokenResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def login(+ self,+ *,+ credential_type: SkyvernSchemasCredentialTypeCredentialType,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[ProxyLocation] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_screenshot_scrolling_times: typing.Optional[int] = OMIT,+ prompt: typing.Optional[str] = OMIT,+ credential_id: typing.Optional[str] = OMIT,+ bitwarden_collection_id: typing.Optional[str] = OMIT,+ bitwarden_item_id: typing.Optional[str] = OMIT,+ onepassword_vault_id: typing.Optional[str] = OMIT,+ onepassword_item_id: typing.Optional[str] = OMIT,+ azure_vault_name: typing.Optional[str] = OMIT,+ azure_vault_username_key: typing.Optional[str] = OMIT,+ azure_vault_password_key: typing.Optional[str] = OMIT,+ azure_vault_totp_secret_key: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[WorkflowRunResponse]:+ """+ Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure Vault++ Parameters+ ----------+ credential_type : SkyvernSchemasCredentialTypeCredentialType+ Where to get the credential from++ user_agent : typing.Optional[str]++ url : typing.Optional[str]+ Website URL++ webhook_url : typing.Optional[str]+ Webhook URL to send status updates++ proxy_location : typing.Optional[ProxyLocation]+ Proxy location to use++ totp_identifier : typing.Optional[str]+ Identifier for TOTP (Time-based One-Time Password) if required++ totp_url : typing.Optional[str]+ TOTP URL to fetch one-time passwords++ browser_session_id : typing.Optional[str]+ ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this run++ browser_address : typing.Optional[str]+ The CDP address for the task.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Additional HTTP headers to include in requests++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.++ max_screenshot_scrolling_times : typing.Optional[int]+ Maximum number of times to scroll for screenshots++ prompt : typing.Optional[str]+ Login instructions. Skyvern has default prompt/instruction for login if this field is not provided.++ credential_id : typing.Optional[str]+ ID of the Skyvern credential to use for login.++ bitwarden_collection_id : typing.Optional[str]+ Bitwarden collection ID. You can find it in the Bitwarden collection URL. e.g. `https://vault.bitwarden.com/vaults/collection_id/items`++ bitwarden_item_id : typing.Optional[str]+ Bitwarden item ID++ onepassword_vault_id : typing.Optional[str]+ 1Password vault ID++ onepassword_item_id : typing.Optional[str]+ 1Password item ID++ azure_vault_name : typing.Optional[str]+ Azure Vault Name++ azure_vault_username_key : typing.Optional[str]+ Azure Vault username key++ azure_vault_password_key : typing.Optional[str]+ Azure Vault password key++ azure_vault_totp_secret_key : typing.Optional[str]+ Azure Vault TOTP secret key++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[WorkflowRunResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/run/tasks/login",+ method="POST",+ json={+ "url": url,+ "webhook_url": webhook_url,+ "proxy_location": proxy_location,+ "totp_identifier": totp_identifier,+ "totp_url": totp_url,+ "browser_session_id": browser_session_id,+ "browser_profile_id": browser_profile_id,+ "browser_address": browser_address,+ "extra_http_headers": extra_http_headers,+ "cdp_connect_headers": cdp_connect_headers,+ "max_screenshot_scrolling_times": max_screenshot_scrolling_times,+ "credential_type": credential_type,+ "prompt": prompt,+ "credential_id": credential_id,+ "bitwarden_collection_id": bitwarden_collection_id,+ "bitwarden_item_id": bitwarden_item_id,+ "onepassword_vault_id": onepassword_vault_id,+ "onepassword_item_id": onepassword_item_id,+ "azure_vault_name": azure_vault_name,+ "azure_vault_username_key": azure_vault_username_key,+ "azure_vault_password_key": azure_vault_password_key,+ "azure_vault_totp_secret_key": azure_vault_totp_secret_key,+ },+ headers={+ "content-type": "application/json",+ "x-user-agent": str(user_agent) if user_agent is not None else None,+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ WorkflowRunResponse,+ parse_obj_as(+ type_=WorkflowRunResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def download_files(+ self,+ *,+ navigation_goal: str,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[ProxyLocation] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_screenshot_scrolling_times: typing.Optional[int] = OMIT,+ download_suffix: typing.Optional[str] = OMIT,+ download_timeout: typing.Optional[float] = OMIT,+ max_steps_per_run: typing.Optional[int] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[WorkflowRunResponse]:+ """+ Download a file from a website by navigating and clicking download buttons++ Parameters+ ----------+ navigation_goal : str+ Instructions for navigating to and downloading the file++ user_agent : typing.Optional[str]++ url : typing.Optional[str]+ Website URL++ webhook_url : typing.Optional[str]+ Webhook URL to send status updates++ proxy_location : typing.Optional[ProxyLocation]+ Proxy location to use++ totp_identifier : typing.Optional[str]+ Identifier for TOTP (Time-based One-Time Password) if required++ totp_url : typing.Optional[str]+ TOTP URL to fetch one-time passwords++ browser_session_id : typing.Optional[str]+ ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this run++ browser_address : typing.Optional[str]+ The CDP address for the task.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Additional HTTP headers to include in requests++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites.++ max_screenshot_scrolling_times : typing.Optional[int]+ Maximum number of times to scroll for screenshots++ download_suffix : typing.Optional[str]+ Suffix or complete filename for the downloaded file++ download_timeout : typing.Optional[float]+ Timeout in seconds for the download operation++ max_steps_per_run : typing.Optional[int]+ Maximum number of steps to execute++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[WorkflowRunResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/run/tasks/download_files",+ method="POST",+ json={+ "url": url,+ "webhook_url": webhook_url,+ "proxy_location": proxy_location,+ "totp_identifier": totp_identifier,+ "totp_url": totp_url,+ "browser_session_id": browser_session_id,+ "browser_profile_id": browser_profile_id,+ "browser_address": browser_address,+ "extra_http_headers": extra_http_headers,+ "cdp_connect_headers": cdp_connect_headers,+ "max_screenshot_scrolling_times": max_screenshot_scrolling_times,+ "navigation_goal": navigation_goal,+ "download_suffix": download_suffix,+ "download_timeout": download_timeout,+ "max_steps_per_run": max_steps_per_run,+ },+ headers={+ "content-type": "application/json",+ "x-user-agent": str(user_agent) if user_agent is not None else None,+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ WorkflowRunResponse,+ parse_obj_as(+ type_=WorkflowRunResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_scripts(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[typing.List[Script]]:+ """+ Retrieves a paginated list of scripts for the current organization++ Parameters+ ----------+ page : typing.Optional[int]+ Page number for pagination++ page_size : typing.Optional[int]+ Number of items per page++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[typing.List[Script]]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/scripts",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ typing.List[Script],+ parse_obj_as(+ type_=typing.List[Script], # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_script(+ self,+ *,+ workflow_id: typing.Optional[str] = OMIT,+ run_id: typing.Optional[str] = OMIT,+ files: typing.Optional[typing.Sequence[ScriptFileCreate]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[CreateScriptResponse]:+ """+ Create a new script with optional files and metadata++ Parameters+ ----------+ workflow_id : typing.Optional[str]+ Associated workflow ID++ run_id : typing.Optional[str]+ Associated run ID++ files : typing.Optional[typing.Sequence[ScriptFileCreate]]+ Array of files to include in the script++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CreateScriptResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/scripts",+ method="POST",+ json={+ "workflow_id": workflow_id,+ "run_id": run_id,+ "files": convert_and_respect_annotation_metadata(+ object_=files, annotation=typing.Sequence[ScriptFileCreate], direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateScriptResponse,+ parse_obj_as(+ type_=CreateScriptResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_script(+ self, script_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[Script]:+ """+ Retrieves a specific script by its ID++ Parameters+ ----------+ script_id : str+ The unique identifier of the script++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[Script]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/scripts/{jsonable_encoder(script_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ Script,+ parse_obj_as(+ type_=Script, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def deploy_script(+ self,+ script_id: str,+ *,+ files: typing.Sequence[ScriptFileCreate],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[CreateScriptResponse]:+ """+ Deploy a script with updated files, creating a new version++ Parameters+ ----------+ script_id : str+ The unique identifier of the script++ files : typing.Sequence[ScriptFileCreate]+ Array of files to include in the script++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CreateScriptResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/scripts/{jsonable_encoder(script_id)}/deploy",+ method="POST",+ json={+ "files": convert_and_respect_annotation_metadata(+ object_=files, annotation=typing.Sequence[ScriptFileCreate], direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateScriptResponse,+ parse_obj_as(+ type_=CreateScriptResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def run_sdk_action(+ self,+ *,+ url: str,+ action: RunSdkActionRequestAction,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ workflow_run_id: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[RunSdkActionResponse]:+ """+ Execute a single SDK action with the specified parameters++ Parameters+ ----------+ url : str+ The URL where the action should be executed++ action : RunSdkActionRequestAction+ The action to execute with its specific parameters++ browser_session_id : typing.Optional[str]+ The browser session ID++ browser_address : typing.Optional[str]+ The browser address++ workflow_run_id : typing.Optional[str]+ Optional workflow run ID to continue an existing workflow run++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[RunSdkActionResponse]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/sdk/run_action",+ method="POST",+ json={+ "url": url,+ "browser_session_id": browser_session_id,+ "browser_address": browser_address,+ "workflow_run_id": workflow_run_id,+ "action": convert_and_respect_annotation_metadata(+ object_=action, annotation=RunSdkActionRequestAction, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ RunSdkActionResponse,+ parse_obj_as(+ type_=RunSdkActionResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update_workflow_folder(+ self,+ workflow_permanent_id: str,+ *,+ folder_id: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[Workflow]:+ """+ Update a workflow's folder assignment for the latest version++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ folder_id : typing.Optional[str]+ Folder ID to assign workflow to. Set to null to remove from folder.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[Workflow]+ Successfully updated workflow folder+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/folder",+ method="PUT",+ json={+ "folder_id": folder_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ Workflow,+ parse_obj_as(+ type_=Workflow, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow_tags(+ self, workflow_permanent_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagsResponse]:+ """+ Get the current tag state for a workflow.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[TagsResponse]+ Successfully retrieved tags+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ TagsResponse,+ parse_obj_as(+ type_=TagsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def apply_workflow_tags(+ self,+ workflow_permanent_id: str,+ *,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[TagsResponse]:+ """+ Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.++ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.++ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[TagsResponse]+ Successfully applied tag changes+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags",+ method="POST",+ json={+ "tags": convert_and_respect_annotation_metadata(+ object_=tags, annotation=typing.Sequence[TagInput], direction="write"+ ),+ "tags_to_delete": convert_and_respect_annotation_metadata(+ object_=tags_to_delete, annotation=typing.Sequence[TagDeleteInput], direction="write"+ ),+ "colors": colors,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ TagsResponse,+ parse_obj_as(+ type_=TagsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete_workflow_tag(+ self, workflow_permanent_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[TagsResponse]:+ """+ Soft-delete a single tag from a workflow. Writes a DELETE event row.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ key : str+ Tag key to delete++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[TagsResponse]+ Successfully deleted tag (or no-op if absent)+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags/{jsonable_encoder(key)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ TagsResponse,+ parse_obj_as(+ type_=TagsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow_tag_history(+ self,+ workflow_permanent_id: str,+ *,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[TagHistoryResponse]:+ """+ Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.++ Parameters+ ----------+ workflow_permanent_id : str+ Workflow permanent ID++ limit : typing.Optional[int]+ Max events to return++ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag key++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[TagHistoryResponse]+ Successfully retrieved tag history+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags/history",+ method="GET",+ params={+ "limit": limit,+ "since": serialize_datetime(since) if since is not None else None,+ "key": key,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ TagHistoryResponse,+ parse_obj_as(+ type_=TagHistoryResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def retry_workflow_run(+ self,+ workflow_run_id: str,+ *,+ max_steps_override: typing.Optional[int] = None,+ user_agent: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[WorkflowRunResponse]:+ """+ Retry a workflow run using the original run parameters.++ Parameters+ ----------+ workflow_run_id : str+ The id of the workflow run to retry.++ max_steps_override : typing.Optional[int]++ user_agent : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[WorkflowRunResponse]+ Successfully retried workflow run+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/runs/{jsonable_encoder(workflow_run_id)}/retry",+ method="POST",+ headers={+ "x-max-steps-override": str(max_steps_override) if max_steps_override is not None else None,+ "x-user-agent": str(user_agent) if user_agent is not None else None,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ WorkflowRunResponse,+ parse_obj_as(+ type_=WorkflowRunResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow_runs(+ self,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ error_code: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[typing.List[WorkflowRun]]:+ """+ List workflow runs across all workflows for the current organization.++ Results are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.++ ### search_key++ A case-insensitive substring search that matches against **any** of the following fields:++ | Searched field | Description |+ |---|---|+ | `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |+ | Parameter **key** | The `key` of any workflow parameter definition associated with the run |+ | Parameter **description** | The `description` of any workflow parameter definition |+ | Run parameter **value** | The actual value supplied for any parameter when the run was created |+ | `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |++ Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.++ ### error_code++ An **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).++ ### Combining filters++ All query parameters use AND logic:+ - `?status=failed` — only failed runs+ - `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error+ - `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match++ Parameters+ ----------+ page : typing.Optional[int]+ Page number for pagination.++ page_size : typing.Optional[int]+ Number of runs to return per page.++ status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]+ Filter by one or more run statuses.++ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.++ error_code : typing.Optional[str]+ Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[typing.List[WorkflowRun]]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ "v1/agents/runs",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ "status": status,+ "search_key": search_key,+ "error_code": error_code,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ typing.List[WorkflowRun],+ parse_obj_as(+ type_=typing.List[WorkflowRun], # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow_runs_by_id(+ self,+ workflow_id: str,+ *,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,+ search_key: typing.Optional[str] = None,+ error_code: typing.Optional[str] = None,+ created_at_start: typing.Optional[dt.datetime] = None,+ created_at_end: typing.Optional[dt.datetime] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[typing.List[WorkflowRun]]:+ """+ List runs for a specific workflow.++ Supports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.++ ### search_key++ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.++ ### error_code++ Exact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.++ Parameters+ ----------+ workflow_id : str++ page : typing.Optional[int]+ Page number for pagination.++ page_size : typing.Optional[int]+ Number of runs to return per page.++ status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]+ Filter by one or more run statuses.++ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.++ error_code : typing.Optional[str]+ Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.++ created_at_start : typing.Optional[dt.datetime]+ Only include runs created at or after this UTC timestamp (ISO 8601).++ created_at_end : typing.Optional[dt.datetime]+ Only include runs created strictly before this UTC timestamp (ISO 8601).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[typing.List[WorkflowRun]]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_id)}/runs",+ method="GET",+ params={+ "page": page,+ "page_size": page_size,+ "status": status,+ "search_key": search_key,+ "error_code": error_code,+ "created_at_start": serialize_datetime(created_at_start) if created_at_start is not None else None,+ "created_at_end": serialize_datetime(created_at_end) if created_at_end is not None else None,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ typing.List[WorkflowRun],+ parse_obj_as(+ type_=typing.List[WorkflowRun], # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow(+ self,+ workflow_permanent_id: str,+ *,+ version: typing.Optional[int] = None,+ template: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[Workflow]:+ """+ Parameters+ ----------+ workflow_permanent_id : str++ version : typing.Optional[int]++ template : typing.Optional[bool]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[Workflow]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}",+ method="GET",+ params={+ "version": version,+ "template": template,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ Workflow,+ parse_obj_as(+ type_=Workflow, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_workflow_versions(+ self,+ workflow_permanent_id: str,+ *,+ template: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[typing.List[Workflow]]:+ """+ Get all versions of a workflow by its permanent ID.++ Parameters+ ----------+ workflow_permanent_id : str++ template : typing.Optional[bool]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[typing.List[Workflow]]+ Successful Response+ """+ _response = self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/versions",+ method="GET",+ params={+ "template": template,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ typing.List[Workflow],+ parse_obj_as(+ type_=typing.List[Workflow], # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSkyvern:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def run_task(+ self,+ *,+ prompt: str,+ user_agent: typing.Optional[str] = None,+ url: typing.Optional[str] = OMIT,+ engine: typing.Optional[RunEngine] = OMIT,+ title: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[TaskRunRequestInputProxyLocation] = OMIT,+ data_extraction_schema: typing.Optional[TaskRunRequestInputDataExtractionSchema] = OMIT,+ error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ max_steps: typing.Optional[int] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ publish_workflow: typing.Optional[bool] = OMIT,+ include_action_history_in_verification: typing.Optional[bool] = OMIT,+ max_screenshot_scrolls: typing.Optional[int] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ run_with: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[TaskRunResponse]:+ """+ Run a task++ Parameters+ ----------+ prompt : str++ The goal or task description for Skyvern to accomplish++ user_agent : typing.Optional[str]++ url : typing.Optional[str]++ The starting URL for the task. If not provided, Skyvern will attempt to determine an appropriate URL++ engine : typing.Optional[RunEngine]++ The engine that powers the agent task. The default value is `skyvern-1.0`, which is good for simple tasks like filling a form, or searching for information on Google. `skyvern-2.0` remains available for existing V2 workflows and explicitly requested V2 task runs. The `openai-cua` engine uses OpenAI's CUA model. The `anthropic-cua` uses Anthropic's Claude Sonnet 3.7 model with the computer use tool.++ title : typing.Optional[str]+ The title for the task++ proxy_location : typing.Optional[TaskRunRequestInputProxyLocation]++ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.++ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy++ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}++ data_extraction_schema : typing.Optional[TaskRunRequestInputDataExtractionSchema]++ The schema for data to be extracted from the webpage. If you're looking for consistent data schema being returned by the agent, it's highly recommended to use https://json-schema.org/.++ error_code_mapping : typing.Optional[typing.Dict[str, typing.Optional[str]]]++ Custom mapping of error codes to error messages if Skyvern encounters an error.++ max_steps : typing.Optional[int]++ Maximum number of steps the task can take. Task will fail if it exceeds this number. Cautions: you are charged per step so please set this number to a reasonable value. Contact [email protected] for custom pricing.++ webhook_url : typing.Optional[str]++ After a run is finished, send an update to this URL. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for more details.++ totp_identifier : typing.Optional[str]++ Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.++ totp_url : typing.Optional[str]++ URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.++ browser_session_id : typing.Optional[str]++ Run the task or workflow in the specific Skyvern browser session. Having a browser session can persist the real-time state of the browser, so that the next run can continue from where the previous run left off.++ model : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]++ Optional model configuration.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ The extra HTTP headers for the requests in browser.++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.++ publish_workflow : typing.Optional[bool]+ Deprecated. Whether to publish a `skyvern-2.0` task as a reusable workflow. For backwards compatibility, this routes the request through the legacy `skyvern-2.0` publish path. Prefer creating reusable workflows through the workflow APIs.++ include_action_history_in_verification : typing.Optional[bool]+ Whether to include action history when verifying that the task is complete++ max_screenshot_scrolls : typing.Optional[int]+ The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.++ browser_address : typing.Optional[str]+ The CDP address for the task.++ run_with : typing.Optional[str]+ Whether to run the task with agent or code. Null means use the default.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[TaskRunResponse]+ Successfully run task+ """+ _response = await self._client_wrapper.httpx_client.request(+ "v1/run/tasks",+ method="POST",+ json={+ "prompt": prompt,+ "url": url,+ "engine": engine,+ "title": title,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=TaskRunRequestInputProxyLocation, direction="write"+ ),+ "data_extraction_schema": convert_and_respect_annotation_metadata(+ object_=data_extraction_schema,+ annotation=TaskRunRequestInputDataExtractionSchema,+ direction="write",+ ),+ "error_code_mapping": error_code_mapping,+ "max_steps": max_steps,+ "webhook_url": webhook_url,+ "totp_identifier": totp_identifier,+ "totp_url": totp_url,+ "browser_session_id": browser_session_id,+ "model": model,+ "extra_http_headers": extra_http_headers,+ "cdp_connect_headers": cdp_connect_headers,+ "publish_workflow": publish_workflow,+ "include_action_history_in_verification": include_action_history_in_verification,+ "max_screenshot_scrolls": max_screenshot_scrolls,+ "browser_address": browser_address,+ "run_with": run_with,+ },+ headers={+ "content-type": "application/json",+ "x-user-agent": str(user_agent) if user_agent is not None else None,+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ TaskRunResponse,+ parse_obj_as(+ type_=TaskRunResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],parse_obj_as(@@ -4066,49 +5898,168 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def apply_workflow_tags(- self,- workflow_permanent_id: str,- *,- tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,- tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[TagsResponse]:- """- Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.+ async def run_workflow(+ self,+ *,+ agent_id: str,+ template: typing.Optional[bool] = None,+ max_steps_override: typing.Optional[int] = None,+ user_agent: typing.Optional[str] = None,+ parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,+ title: typing.Optional[str] = OMIT,+ proxy_location: typing.Optional[WorkflowRunRequestInputProxyLocation] = OMIT,+ webhook_url: typing.Optional[str] = OMIT,+ totp_url: typing.Optional[str] = OMIT,+ totp_identifier: typing.Optional[str] = OMIT,+ browser_session_id: typing.Optional[str] = OMIT,+ browser_profile_id: typing.Optional[str] = OMIT,+ max_screenshot_scrolls: typing.Optional[int] = OMIT,+ max_elapsed_time_minutes: typing.Optional[int] = OMIT,+ extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ browser_address: typing.Optional[str] = OMIT,+ ai_fallback: typing.Optional[bool] = OMIT,+ run_with: typing.Optional[str] = OMIT,+ run_metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[WorkflowRunResponse]:+ """+ Run an agent++ Parameters+ ----------+ agent_id : str+ ID of the agent to run. Starts with `wpid_`. `workflow_id` is accepted as an alias.++ template : typing.Optional[bool]++ max_steps_override : typing.Optional[int]++ user_agent : typing.Optional[str]++ parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]+ Parameters to pass to the workflow++ title : typing.Optional[str]+ The title for this workflow run++ proxy_location : typing.Optional[WorkflowRunRequestInputProxyLocation]++ Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.++ Available geotargeting options:+ - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.+ - RESIDENTIAL_ES: Spain+ - RESIDENTIAL_IE: Ireland+ - RESIDENTIAL_GB: United Kingdom+ - RESIDENTIAL_IN: India+ - RESIDENTIAL_JP: Japan+ - RESIDENTIAL_FR: France+ - RESIDENTIAL_DE: Germany+ - RESIDENTIAL_NZ: New Zealand+ - RESIDENTIAL_PH: Philippines+ - RESIDENTIAL_KR: South Korea+ - RESIDENTIAL_SA: Saudi Arabia+ - RESIDENTIAL_ZA: South Africa+ - RESIDENTIAL_AR: Argentina+ - RESIDENTIAL_AU: Australia+ - RESIDENTIAL_BR: Brazil+ - RESIDENTIAL_TR: Turkey+ - RESIDENTIAL_CA: Canada+ - RESIDENTIAL_MX: Mexico+ - RESIDENTIAL_IT: Italy+ - RESIDENTIAL_NL: Netherlands+ - RESIDENTIAL_ISP: ISP proxy+ - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)+ - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)+ - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)+ - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)+ - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)+ - NONE: No proxy++ For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.+ Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}++ webhook_url : typing.Optional[str]+ URL to send workflow status updates to after a run is finished. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for webhook questions.++ totp_url : typing.Optional[str]- Parameters- ----------- workflow_permanent_id : str- Workflow permanent ID+ URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.- tags : typing.Optional[typing.Sequence[TagInput]]- Tags to set (overwrite). List of {key?, value} objects.+ totp_identifier : typing.Optional[str]- tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]- Tags to soft-delete. List of {key?, value?} targets.+ Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.++ browser_session_id : typing.Optional[str]+ ID of a Skyvern browser session to reuse, having it continue from the current screen state++ browser_profile_id : typing.Optional[str]+ ID of a browser profile to reuse for this workflow run++ max_screenshot_scrolls : typing.Optional[int]+ The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.++ max_elapsed_time_minutes : typing.Optional[int]+ Timeout this workflow run after the configured elapsed runtime in minutes. When omitted, the platform default is 240 minutes. The maximum configurable value is 480 minutes.++ extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ The extra HTTP headers for the requests in browser.++ cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.++ browser_address : typing.Optional[str]+ The CDP address for the workflow run.++ ai_fallback : typing.Optional[bool]+ Whether to fallback to AI if the workflow run fails.++ run_with : typing.Optional[str]+ Whether to run the workflow with agent or code. Null inherits from the workflow setting.++ run_metadata : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ String key/value metadata to attach to this workflow run for analytics tag filtering.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagsResponse]- Successfully applied tag changes+ AsyncHttpResponse[WorkflowRunResponse]+ Successfully ran agent"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags",+ _response = await self._client_wrapper.httpx_client.request(+ "v1/run/agents",method="POST",+ params={+ "template": template,+ },json={- "tags": convert_and_respect_annotation_metadata(- object_=tags, annotation=typing.Sequence[TagInput], direction="write"- ),- "tags_to_delete": convert_and_respect_annotation_metadata(- object_=tags_to_delete, annotation=typing.Sequence[TagDeleteInput], direction="write"+ "agent_id": agent_id,+ "parameters": parameters,+ "title": title,+ "proxy_location": convert_and_respect_annotation_metadata(+ object_=proxy_location, annotation=WorkflowRunRequestInputProxyLocation, direction="write"),+ "webhook_url": webhook_url,+ "totp_url": totp_url,+ "totp_identifier": totp_identifier,+ "browser_session_id": browser_session_id,+ "browser_profile_id": browser_profile_id,+ "max_screenshot_scrolls": max_screenshot_scrolls,+ "max_elapsed_time_minutes": max_elapsed_time_minutes,+ "extra_http_headers": extra_http_headers,+ "cdp_connect_headers": cdp_connect_headers,+ "browser_address": browser_address,+ "ai_fallback": ai_fallback,+ "run_with": run_with,+ "run_metadata": run_metadata,},headers={"content-type": "application/json",+ "x-max-steps-override": str(max_steps_override) if max_steps_override is not None else None,+ "x-user-agent": str(user_agent) if user_agent is not None else None,},request_options=request_options,omit=OMIT,@@ -4116,15 +6067,15 @@ class RawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagsResponse,+ WorkflowRunResponse,parse_obj_as(- type_=TagsResponse, # type: ignore+ type_=WorkflowRunResponse, # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -4150,43 +6101,40 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def delete_workflow_tag(- self, workflow_permanent_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> HttpResponse[TagsResponse]:+ async def get_run(+ self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetRunResponse]:"""- Soft-delete a single tag from a workflow. Writes a DELETE event row.+ Get run information (task run, workflow run)Parameters----------- workflow_permanent_id : str- Workflow permanent ID-- key : str- Tag key to delete+ run_id : str+ The id of the task run or the workflow run.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagsResponse]- Successfully deleted tag (or no-op if absent)+ AsyncHttpResponse[GetRunResponse]+ Successfully got run"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags/{jsonable_encoder(key)}",- method="DELETE",+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/runs/{jsonable_encoder(run_id)}",+ method="GET",request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagsResponse,+ GetRunResponse,parse_obj_as(- type_=TagsResponse, # type: ignore+ type_=GetRunResponse, # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 404:raise NotFoundError(headers=dict(_response.headers),@@ -4214,71 +6162,42 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow_tag_history(- self,- workflow_permanent_id: str,- *,- limit: typing.Optional[int] = None,- since: typing.Optional[dt.datetime] = None,- key: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[TagHistoryResponse]:+ async def cancel_run(+ self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:"""- Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.+ Cancel a run (task or workflow)Parameters----------- workflow_permanent_id : str- Workflow permanent ID-- limit : typing.Optional[int]- Max events to return-- since : typing.Optional[dt.datetime]- Only return events at or after this timestamp-- key : typing.Optional[str]- Filter to events for a single tag key+ run_id : str+ The id of the task run or the workflow run to cancel.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[TagHistoryResponse]- Successfully retrieved tag history+ AsyncHttpResponse[typing.Optional[typing.Any]]+ Successful Response"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/tags/history",- method="GET",- params={- "limit": limit,- "since": serialize_datetime(since) if since is not None else None,- "key": key,- },+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/runs/{jsonable_encoder(run_id)}/cancel",+ method="POST",request_options=request_options,)try:+ if _response is None or not _response.text.strip():+ return AsyncHttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- TagHistoryResponse,+ typing.Optional[typing.Any],parse_obj_as(- type_=TagHistoryResponse, # type: ignore+ type_=typing.Optional[typing.Any], # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4295,75 +6214,47 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def retry_workflow_run(- self,- workflow_run_id: str,- *,- max_steps_override: typing.Optional[int] = None,- user_agent: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[WorkflowRunResponse]:+ async def bulk_cancel_runs(+ self, *, run_ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[BulkCancelRunsResponse]:"""- Retry a workflow run using the original run parameters.+ Cancel multiple runs (tasks or workflows) in a single requestParameters----------- workflow_run_id : str- The id of the workflow run to retry.-- max_steps_override : typing.Optional[int]-- user_agent : typing.Optional[str]+ run_ids : typing.Sequence[str]+ List of run IDs to cancelrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[WorkflowRunResponse]- Successfully retried workflow run+ AsyncHttpResponse[BulkCancelRunsResponse]+ Successful Response"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/runs/{jsonable_encoder(workflow_run_id)}/retry",- method="POST",- headers={- "x-max-steps-override": str(max_steps_override) if max_steps_override is not None else None,- "x-user-agent": str(user_agent) if user_agent is not None else None,- },- request_options=request_options,- )- try:- if 200 <= _response.status_code < 300:- _data = typing.cast(- WorkflowRunResponse,- parse_obj_as(- type_=WorkflowRunResponse, # type: ignore- object_=_response.json(),- ),- )- return HttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),+ _response = await self._client_wrapper.httpx_client.request(+ "v1/runs/cancel",+ method="POST",+ json={+ "run_ids": run_ids,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ BulkCancelRunsResponse,+ parse_obj_as(+ type_=BulkCancelRunsResponse, # type: ignore+ object_=_response.json(),),)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4380,93 +6271,96 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow_runs(+ async def get_workflows(self,*,page: typing.Optional[int] = None,page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,+ only_saved_tasks: typing.Optional[bool] = None,+ only_workflows: typing.Optional[bool] = None,+ only_templates: typing.Optional[bool] = None,search_key: typing.Optional[str] = None,- error_code: typing.Optional[str] = None,+ title: typing.Optional[str] = None,+ folder_id: typing.Optional[str] = None,+ status: typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]] = None,+ tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,+ template: typing.Optional[bool] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[WorkflowRun]]:+ ) -> AsyncHttpResponse[typing.List[Workflow]]:"""- List workflow runs across all workflows for the current organization.-- Results are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.-- ### search_key+ Get all workflows with the latest version for the organization.- A case-insensitive substring search that matches against **any** of the following fields:+ Search semantics:+ - If `search_key` is provided, its value is used as a unified search term for+ `workflows.title`, `folders.title`, and workflow parameter metadata (key, description, and default_value for+ `WorkflowParameterModel`).+ - Falls back to deprecated `title` (title-only search) if `search_key` is not provided.+ - Parameter metadata search excludes soft-deleted parameter rows across all parameter tables.- | Searched field | Description |- |---|---|- | `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |- | Parameter **key** | The `key` of any workflow parameter definition associated with the run |- | Parameter **description** | The `description` of any workflow parameter definition |- | Run parameter **value** | The actual value supplied for any parameter when the run was created |- | `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |+ Parameters+ ----------+ page : typing.Optional[int]- Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.+ page_size : typing.Optional[int]- ### error_code+ only_saved_tasks : typing.Optional[bool]- An **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).+ only_workflows : typing.Optional[bool]- ### Combining filters+ only_templates : typing.Optional[bool]- All query parameters use AND logic:- - `?status=failed` — only failed runs- - `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error- - `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match+ search_key : typing.Optional[str]+ Case-insensitive substring search across: workflow title, folder name, and parameter metadata (key, description, default_value). A workflow is returned if any of these fields match. Soft-deleted parameter definitions are excluded. Takes precedence over the deprecated `title` parameter.- Parameters- ----------- page : typing.Optional[int]- Page number for pagination.+ title : typing.Optional[str]+ Deprecated: use search_key instead. Falls back to title-only search if search_key is not provided.- page_size : typing.Optional[int]- Number of runs to return per page.+ folder_id : typing.Optional[str]+ Filter workflows by folder ID- status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]- Filter by one or more run statuses.+ status : typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]]- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.+ tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]+ Filter by tags. Each term is a label (`production`), a group (`env:*`), or a group:label (`env:prod`). Repeat the param or comma-separate (`?tags=env:prod,env:staging`). AND across distinct terms, OR within a group's labels (`?tags=customer:acme,env:prod,env:staging` -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only. Not supported with `template=true`.- error_code : typing.Optional[str]- Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ template : typing.Optional[bool]request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[WorkflowRun]]+ AsyncHttpResponse[typing.List[Workflow]]Successful Response"""- _response = self._client_wrapper.httpx_client.request(- "v1/agents/runs",+ _response = await self._client_wrapper.httpx_client.request(+ "v1/agents",method="GET",params={"page": page,"page_size": page_size,- "status": status,+ "only_saved_tasks": only_saved_tasks,+ "only_workflows": only_workflows,+ "only_templates": only_templates,"search_key": search_key,- "error_code": error_code,+ "title": title,+ "folder_id": folder_id,+ "status": status,+ "tags": tags,+ "template": template,},request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[WorkflowRun],+ typing.List[Workflow],parse_obj_as(- type_=typing.List[WorkflowRun], # type: ignore+ type_=typing.List[Workflow], # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4483,79 +6377,64 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow_runs_by_id(+ async def create_workflow(self,- workflow_id: str,*,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,- search_key: typing.Optional[str] = None,- error_code: typing.Optional[str] = None,+ folder_id: typing.Optional[str] = None,+ json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,+ yaml_definition: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[WorkflowRun]]:+ ) -> AsyncHttpResponse[Workflow]:"""- List runs for a specific workflow.-- Supports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.-- ### search_key-- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.-- ### error_code-- Exact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.+ Create a new agentParameters----------- workflow_id : str-- page : typing.Optional[int]- Page number for pagination.-- page_size : typing.Optional[int]- Number of runs to return per page.-- status : typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]]- Filter by one or more run statuses.+ folder_id : typing.Optional[str]+ Optional folder ID to assign the workflow to- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.+ json_definition : typing.Optional[WorkflowCreateYamlRequest]+ Workflow definition in JSON format- error_code : typing.Optional[str]- Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ yaml_definition : typing.Optional[str]+ Workflow definition in YAML formatrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[WorkflowRun]]- Successful Response+ AsyncHttpResponse[Workflow]+ Successfully created agent"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_id)}/runs",- method="GET",+ _response = await self._client_wrapper.httpx_client.request(+ "v1/agents",+ method="POST",params={- "page": page,- "page_size": page_size,- "status": status,- "search_key": search_key,- "error_code": error_code,+ "folder_id": folder_id,+ },+ json={+ "json_definition": convert_and_respect_annotation_metadata(+ object_=json_definition, annotation=WorkflowCreateYamlRequest, direction="write"+ ),+ "yaml_definition": yaml_definition,+ },+ headers={+ "content-type": "application/json",},request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[WorkflowRun],+ Workflow,parse_obj_as(- type_=typing.List[WorkflowRun], # type: ignore+ type_=Workflow, # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4572,50 +6451,113 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow(+ async def update_workflow(self,- workflow_permanent_id: str,+ workflow_id: str,*,- version: typing.Optional[int] = None,- template: typing.Optional[bool] = None,+ json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,+ yaml_definition: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[Workflow]:+ ) -> AsyncHttpResponse[Workflow]:+ """+ Update an agent++ Parameters+ ----------+ workflow_id : str+ The ID of the agent to update. Starts with `wpid_`.++ json_definition : typing.Optional[WorkflowCreateYamlRequest]+ Workflow definition in JSON format++ yaml_definition : typing.Optional[str]+ Workflow definition in YAML format++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[Workflow]+ Successfully updated agent+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_id)}",+ method="POST",+ json={+ "json_definition": convert_and_respect_annotation_metadata(+ object_=json_definition, annotation=WorkflowCreateYamlRequest, direction="write"+ ),+ "yaml_definition": yaml_definition,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ Workflow,+ parse_obj_as(+ type_=Workflow, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete_workflow(+ self, workflow_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:"""+ Delete an agent+Parameters----------- workflow_permanent_id : str-- version : typing.Optional[int]-- template : typing.Optional[bool]+ workflow_id : str+ The ID of the agent to delete. Starts with `wpid_`.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[Workflow]- Successful Response+ AsyncHttpResponse[typing.Optional[typing.Any]]+ Successfully deleted agent"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}",- method="GET",- params={- "version": version,- "template": template,- },+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/agents/{jsonable_encoder(workflow_id)}/delete",+ method="POST",request_options=request_options,)try:+ if _response is None or not _response.text.strip():+ return AsyncHttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- Workflow,+ typing.Optional[typing.Any],parse_obj_as(- type_=Workflow, # type: ignore+ type_=typing.Optional[typing.Any], # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4632,48 +6574,56 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- def get_workflow_versions(+ async def get_folders(self,- workflow_permanent_id: str,*,- template: typing.Optional[bool] = None,+ page: typing.Optional[int] = None,+ page_size: typing.Optional[int] = None,+ search: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> HttpResponse[typing.List[Workflow]]:+ ) -> AsyncHttpResponse[typing.List[Folder]]:"""- Get all versions of a workflow by its permanent ID.+ Get all folders for the organizationParameters----------- workflow_permanent_id : str+ page : typing.Optional[int]+ Page number- template : typing.Optional[bool]+ page_size : typing.Optional[int]+ Number of folders per page++ search : typing.Optional[str]+ Search folders by title or descriptionrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- HttpResponse[typing.List[Workflow]]- Successful Response+ AsyncHttpResponse[typing.List[Folder]]+ Successfully retrieved folders"""- _response = self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_permanent_id)}/versions",+ _response = await self._client_wrapper.httpx_client.request(+ "v1/folders",method="GET",params={- "template": template,+ "page": page,+ "page_size": page_size,+ "search": search,},request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[Workflow],+ typing.List[Folder],parse_obj_as(- type_=typing.List[Workflow], # type: ignore+ type_=typing.List[Folder], # type: ignoreobject_=_response.json(),),)- return HttpResponse(response=_response, data=_data)+ return AsyncHttpResponse(response=_response, data=_data)if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -4690,191 +6640,41 @@ class RawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)--class AsyncRawSkyvern:- def __init__(self, *, client_wrapper: AsyncClientWrapper):- self._client_wrapper = client_wrapper-- async def run_task(+ async def create_folder(self,*,- prompt: str,- user_agent: typing.Optional[str] = None,- url: typing.Optional[str] = OMIT,- engine: typing.Optional[RunEngine] = OMIT,- title: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[TaskRunRequestInputProxyLocation] = OMIT,- data_extraction_schema: typing.Optional[TaskRunRequestInputDataExtractionSchema] = OMIT,- error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- max_steps: typing.Optional[int] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- publish_workflow: typing.Optional[bool] = OMIT,- include_action_history_in_verification: typing.Optional[bool] = OMIT,- max_screenshot_scrolls: typing.Optional[int] = OMIT,- browser_address: typing.Optional[str] = OMIT,- run_with: typing.Optional[str] = OMIT,+ title: str,+ description: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[TaskRunResponse]:+ ) -> AsyncHttpResponse[Folder]:"""- Run a task+ Create a new folder to organize workflowsParameters----------- prompt : str-- The goal or task description for Skyvern to accomplish-- user_agent : typing.Optional[str]-- url : typing.Optional[str]-- The starting URL for the task. If not provided, Skyvern will attempt to determine an appropriate URL-- engine : typing.Optional[RunEngine]-- The engine that powers the agent task. The default value is `skyvern-1.0`, which is good for simple tasks like filling a form, or searching for information on Google. `skyvern-2.0` remains available for existing V2 workflows and explicitly requested V2 task runs. The `openai-cua` engine uses OpenAI's CUA model. The `anthropic-cua` uses Anthropic's Claude Sonnet 3.7 model with the computer use tool.-- title : typing.Optional[str]- The title for the task-- proxy_location : typing.Optional[TaskRunRequestInputProxyLocation]-- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.-- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy-- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}-- data_extraction_schema : typing.Optional[TaskRunRequestInputDataExtractionSchema]-- The schema for data to be extracted from the webpage. If you're looking for consistent data schema being returned by the agent, it's highly recommended to use https://json-schema.org/.-- error_code_mapping : typing.Optional[typing.Dict[str, typing.Optional[str]]]-- Custom mapping of error codes to error messages if Skyvern encounters an error.-- max_steps : typing.Optional[int]-- Maximum number of steps the task can take. Task will fail if it exceeds this number. Cautions: you are charged per step so please set this number to a reasonable value. Contact [email protected] for custom pricing.-- webhook_url : typing.Optional[str]-- After a run is finished, send an update to this URL. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for more details.-- totp_identifier : typing.Optional[str]-- Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.-- totp_url : typing.Optional[str]-- URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.-- browser_session_id : typing.Optional[str]-- Run the task or workflow in the specific Skyvern browser session. Having a browser session can persist the real-time state of the browser, so that the next run can continue from where the previous run left off.-- model : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]-- Optional model configuration.-- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- The extra HTTP headers for the requests in browser.-- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.-- publish_workflow : typing.Optional[bool]- Deprecated. Whether to publish a `skyvern-2.0` task as a reusable workflow. For backwards compatibility, this routes the request through the legacy `skyvern-2.0` publish path. Prefer creating reusable workflows through the workflow APIs.-- include_action_history_in_verification : typing.Optional[bool]- Whether to include action history when verifying that the task is complete-- max_screenshot_scrolls : typing.Optional[int]- The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.-- browser_address : typing.Optional[str]- The CDP address for the task.+ title : str+ Folder title- run_with : typing.Optional[str]- Whether to run the task with agent or code. Null means use the default.+ description : typing.Optional[str]+ Folder descriptionrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[TaskRunResponse]- Successfully run task- """- _response = await self._client_wrapper.httpx_client.request(- "v1/run/tasks",- method="POST",- json={- "prompt": prompt,- "url": url,- "engine": engine,- "title": title,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=TaskRunRequestInputProxyLocation, direction="write"- ),- "data_extraction_schema": convert_and_respect_annotation_metadata(- object_=data_extraction_schema,- annotation=TaskRunRequestInputDataExtractionSchema,- direction="write",- ),- "error_code_mapping": error_code_mapping,- "max_steps": max_steps,- "webhook_url": webhook_url,- "totp_identifier": totp_identifier,- "totp_url": totp_url,- "browser_session_id": browser_session_id,- "model": model,- "extra_http_headers": extra_http_headers,- "cdp_connect_headers": cdp_connect_headers,- "publish_workflow": publish_workflow,- "include_action_history_in_verification": include_action_history_in_verification,- "max_screenshot_scrolls": max_screenshot_scrolls,- "browser_address": browser_address,- "run_with": run_with,+ AsyncHttpResponse[Folder]+ Successfully created folder+ """+ _response = await self._client_wrapper.httpx_client.request(+ "v1/folders",+ method="POST",+ json={+ "title": title,+ "description": description,},headers={"content-type": "application/json",- "x-user-agent": str(user_agent) if user_agent is not None else None,},request_options=request_options,omit=OMIT,@@ -4882,9 +6682,9 @@ class AsyncRawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- TaskRunResponse,+ Folder,parse_obj_as(- type_=TaskRunResponse, # type: ignore+ type_=Folder, # type: ignoreobject_=_response.json(),),)@@ -4916,184 +6716,42 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def run_workflow(- self,- *,- agent_id: str,- template: typing.Optional[bool] = None,- max_steps_override: typing.Optional[int] = None,- user_agent: typing.Optional[str] = None,- parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,- title: typing.Optional[str] = OMIT,- proxy_location: typing.Optional[WorkflowRunRequestInputProxyLocation] = OMIT,- webhook_url: typing.Optional[str] = OMIT,- totp_url: typing.Optional[str] = OMIT,- totp_identifier: typing.Optional[str] = OMIT,- browser_session_id: typing.Optional[str] = OMIT,- browser_profile_id: typing.Optional[str] = OMIT,- max_screenshot_scrolls: typing.Optional[int] = OMIT,- max_elapsed_time_minutes: typing.Optional[int] = OMIT,- extra_http_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- cdp_connect_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- browser_address: typing.Optional[str] = OMIT,- ai_fallback: typing.Optional[bool] = OMIT,- run_with: typing.Optional[str] = OMIT,- run_metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[WorkflowRunResponse]:+ async def get_folder(+ self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[Folder]:"""- Run an agent+ Get a specific folder by IDParameters----------- agent_id : str- ID of the agent to run. Starts with `wpid_`. `workflow_id` is accepted as an alias.-- template : typing.Optional[bool]-- max_steps_override : typing.Optional[int]-- user_agent : typing.Optional[str]-- parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]- Parameters to pass to the workflow-- title : typing.Optional[str]- The title for this workflow run-- proxy_location : typing.Optional[WorkflowRunRequestInputProxyLocation]-- Geographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.-- Available geotargeting options:- - RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.- - RESIDENTIAL_ES: Spain- - RESIDENTIAL_IE: Ireland- - RESIDENTIAL_GB: United Kingdom- - RESIDENTIAL_IN: India- - RESIDENTIAL_JP: Japan- - RESIDENTIAL_FR: France- - RESIDENTIAL_DE: Germany- - RESIDENTIAL_NZ: New Zealand- - RESIDENTIAL_PH: Philippines- - RESIDENTIAL_KR: South Korea- - RESIDENTIAL_SA: Saudi Arabia- - RESIDENTIAL_ZA: South Africa- - RESIDENTIAL_AR: Argentina- - RESIDENTIAL_AU: Australia- - RESIDENTIAL_BR: Brazil- - RESIDENTIAL_TR: Turkey- - RESIDENTIAL_CA: Canada- - RESIDENTIAL_MX: Mexico- - RESIDENTIAL_IT: Italy- - RESIDENTIAL_NL: Netherlands- - RESIDENTIAL_ISP: ISP proxy- - US-CA: California (deprecated, routes through RESIDENTIAL_ISP)- - US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)- - US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)- - US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)- - US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)- - NONE: No proxy-- For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.- Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}-- webhook_url : typing.Optional[str]- URL to send workflow status updates to after a run is finished. Refer to https://www.skyvern.com/docs/running-tasks/webhooks-faq for webhook questions.-- totp_url : typing.Optional[str]-- URL that serves TOTP/2FA/MFA codes for Skyvern to use during the workflow run. Refer to https://www.skyvern.com/docs/credentials/totp#option-2-get-code-from-your-endpoint for more details.-- totp_identifier : typing.Optional[str]-- Identifier for the TOTP/2FA/MFA code when the code is pushed to Skyvern. Refer to https://www.skyvern.com/docs/credentials/totp#option-3-push-code-to-skyvern for more details.-- browser_session_id : typing.Optional[str]- ID of a Skyvern browser session to reuse, having it continue from the current screen state-- browser_profile_id : typing.Optional[str]- ID of a browser profile to reuse for this workflow run-- max_screenshot_scrolls : typing.Optional[int]- The maximum number of scrolls for the post action screenshot. When it's None or 0, it takes the current viewpoint screenshot.-- max_elapsed_time_minutes : typing.Optional[int]- Timeout this workflow run after the configured elapsed runtime in minutes. When omitted, the platform default is 240 minutes. The maximum configurable value is 480 minutes.-- extra_http_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- The extra HTTP headers for the requests in browser.-- cdp_connect_headers : typing.Optional[typing.Dict[str, typing.Optional[str]]]- HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Use this for browser-provider auth (e.g., x-api-key for Skyvern Cloud, Browserless, or similar). These headers are NEVER forwarded to target websites.-- browser_address : typing.Optional[str]- The CDP address for the workflow run.-- ai_fallback : typing.Optional[bool]- Whether to fallback to AI if the workflow run fails.-- run_with : typing.Optional[str]- Whether to run the workflow with agent or code. Null inherits from the workflow setting.-- run_metadata : typing.Optional[typing.Dict[str, typing.Optional[str]]]- String key/value metadata to attach to this workflow run for analytics tag filtering.+ folder_id : str+ Folder IDrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[WorkflowRunResponse]- Successfully ran agent+ AsyncHttpResponse[Folder]+ Successfully retrieved folder"""_response = await self._client_wrapper.httpx_client.request(- "v1/run/agents",- method="POST",- params={- "template": template,- },- json={- "agent_id": agent_id,- "parameters": parameters,- "title": title,- "proxy_location": convert_and_respect_annotation_metadata(- object_=proxy_location, annotation=WorkflowRunRequestInputProxyLocation, direction="write"- ),- "webhook_url": webhook_url,- "totp_url": totp_url,- "totp_identifier": totp_identifier,- "browser_session_id": browser_session_id,- "browser_profile_id": browser_profile_id,- "max_screenshot_scrolls": max_screenshot_scrolls,- "max_elapsed_time_minutes": max_elapsed_time_minutes,- "extra_http_headers": extra_http_headers,- "cdp_connect_headers": cdp_connect_headers,- "browser_address": browser_address,- "ai_fallback": ai_fallback,- "run_with": run_with,- "run_metadata": run_metadata,- },- headers={- "content-type": "application/json",- "x-max-steps-override": str(max_steps_override) if max_steps_override is not None else None,- "x-user-agent": str(user_agent) if user_agent is not None else None,- },+ f"v1/folders/{jsonable_encoder(folder_id)}",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowRunResponse,+ Folder,parse_obj_as(- type_=WorkflowRunResponse, # type: ignore+ type_=Folder, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(+ if _response.status_code == 404:+ raise NotFoundError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -5119,36 +6777,55 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def get_run(- self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[GetRunResponse]:+ async def update_folder(+ self,+ folder_id: str,+ *,+ title: typing.Optional[str] = OMIT,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[Folder]:"""- Get run information (task run, workflow run)+ Update a folder's title or descriptionParameters----------- run_id : str- The id of the task run or the workflow run.+ folder_id : str+ Folder ID++ title : typing.Optional[str]+ Folder title++ description : typing.Optional[str]+ Folder descriptionrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[GetRunResponse]- Successfully got run+ AsyncHttpResponse[Folder]+ Successfully updated folder"""_response = await self._client_wrapper.httpx_client.request(- f"v1/runs/{jsonable_encoder(run_id)}",- method="GET",+ f"v1/folders/{jsonable_encoder(folder_id)}",+ method="PUT",+ json={+ "title": title,+ "description": description,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- GetRunResponse,+ Folder,parse_obj_as(- type_=GetRunResponse, # type: ignore+ type_=Folder, # type: ignoreobject_=_response.json(),),)@@ -5180,42 +6857,61 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def cancel_run(- self, run_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:+ async def delete_folder(+ self,+ folder_id: str,+ *,+ delete_workflows: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[typing.Dict[str, typing.Optional[typing.Any]]]:"""- Cancel a run (task or workflow)+ Delete a folder. Optionally delete all workflows in the folder.Parameters----------- run_id : str- The id of the task run or the workflow run to cancel.+ folder_id : str+ Folder ID++ delete_workflows : typing.Optional[bool]+ If true, also delete all workflows in this folderrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.Optional[typing.Any]]- Successful Response+ AsyncHttpResponse[typing.Dict[str, typing.Optional[typing.Any]]]+ Successfully deleted folder"""_response = await self._client_wrapper.httpx_client.request(- f"v1/runs/{jsonable_encoder(run_id)}/cancel",- method="POST",+ f"v1/folders/{jsonable_encoder(folder_id)}",+ method="DELETE",+ params={+ "delete_workflows": delete_workflows,+ },request_options=request_options,)try:- if _response is None or not _response.text.strip():- return AsyncHttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- typing.Optional[typing.Any],+ typing.Dict[str, typing.Optional[typing.Any]],parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore+ type_=typing.Dict[str, typing.Optional[typing.Any]], # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5232,47 +6928,51 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def bulk_cancel_runs(- self, *, run_ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[BulkCancelRunsResponse]:+ async def get_run_tags(+ self, workflow_run_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[RunTagsResponse]:"""- Cancel multiple runs (tasks or workflows) in a single request+ Get the current tag state for a workflow run.Parameters----------- run_ids : typing.Sequence[str]- List of run IDs to cancel+ workflow_run_id : str+ Workflow run IDrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[BulkCancelRunsResponse]- Successful Response+ AsyncHttpResponse[RunTagsResponse]+ Successfully retrieved tags"""_response = await self._client_wrapper.httpx_client.request(- "v1/runs/cancel",- method="POST",- json={- "run_ids": run_ids,- },- headers={- "content-type": "application/json",- },+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags",+ method="GET",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- BulkCancelRunsResponse,+ RunTagsResponse,parse_obj_as(- type_=BulkCancelRunsResponse, # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5289,96 +6989,79 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def get_workflows(+ async def apply_run_tags(self,+ workflow_run_id: str,*,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- only_saved_tasks: typing.Optional[bool] = None,- only_workflows: typing.Optional[bool] = None,- only_templates: typing.Optional[bool] = None,- search_key: typing.Optional[str] = None,- title: typing.Optional[str] = None,- folder_id: typing.Optional[str] = None,- status: typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]] = None,- tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,- template: typing.Optional[bool] = None,+ tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,+ tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[typing.List[Workflow]]:+ ) -> AsyncHttpResponse[RunTagsResponse]:"""- Get all workflows with the latest version for the organization.-- Search semantics:- - If `search_key` is provided, its value is used as a unified search term for- `workflows.title`, `folders.title`, and workflow parameter metadata (key, description, and default_value for- `WorkflowParameterModel`).- - Falls back to deprecated `title` (title-only search) if `search_key` is not provided.- - Parameter metadata search excludes soft-deleted parameter rows across all parameter tables.+ Atomically apply tag changes to a workflow run. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.Parameters----------- page : typing.Optional[int]-- page_size : typing.Optional[int]-- only_saved_tasks : typing.Optional[bool]-- only_workflows : typing.Optional[bool]-- only_templates : typing.Optional[bool]-- search_key : typing.Optional[str]- Case-insensitive substring search across: workflow title, folder name, and parameter metadata (key, description, default_value). A workflow is returned if any of these fields match. Soft-deleted parameter definitions are excluded. Takes precedence over the deprecated `title` parameter.-- title : typing.Optional[str]- Deprecated: use search_key instead. Falls back to title-only search if search_key is not provided.-- folder_id : typing.Optional[str]- Filter workflows by folder ID+ workflow_run_id : str+ Workflow run ID- status : typing.Optional[typing.Union[WorkflowStatus, typing.Sequence[WorkflowStatus]]]+ tags : typing.Optional[typing.Sequence[TagInput]]+ Tags to set (overwrite). List of {key?, value} objects.- tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]- Filter by tags. Each term is a label (`production`), a group (`env:*`), or a group:label (`env:prod`). Repeat the param or comma-separate (`?tags=env:prod,env:staging`). AND across distinct terms, OR within a group's labels (`?tags=customer:acme,env:prod,env:staging` -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only. Not supported with `template=true`.+ tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]+ Tags to soft-delete. List of {key?, value?} targets.- template : typing.Optional[bool]+ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.List[Workflow]]- Successful Response+ AsyncHttpResponse[RunTagsResponse]+ Successfully applied tag changes"""_response = await self._client_wrapper.httpx_client.request(- "v1/agents",- method="GET",- params={- "page": page,- "page_size": page_size,- "only_saved_tasks": only_saved_tasks,- "only_workflows": only_workflows,- "only_templates": only_templates,- "search_key": search_key,- "title": title,- "folder_id": folder_id,- "status": status,- "tags": tags,- "template": template,+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags",+ method="POST",+ json={+ "tags": convert_and_respect_annotation_metadata(+ object_=tags, annotation=typing.Sequence[TagInput], direction="write"+ ),+ "tags_to_delete": convert_and_respect_annotation_metadata(+ object_=tags_to_delete, annotation=typing.Sequence[TagDeleteInput], direction="write"+ ),+ "colors": colors,+ },+ headers={+ "content-type": "application/json",},request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[Workflow],+ RunTagsResponse,parse_obj_as(- type_=typing.List[Workflow], # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5395,64 +7078,54 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def create_workflow(- self,- *,- folder_id: typing.Optional[str] = None,- json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,- yaml_definition: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[Workflow]:+ async def delete_run_tag(+ self, workflow_run_id: str, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[RunTagsResponse]:"""- Create a new agent+ Soft-delete a single grouped tag from a workflow run. Writes a DELETE event row.Parameters----------- folder_id : typing.Optional[str]- Optional folder ID to assign the workflow to-- json_definition : typing.Optional[WorkflowCreateYamlRequest]- Workflow definition in JSON format+ workflow_run_id : str+ Workflow run ID- yaml_definition : typing.Optional[str]- Workflow definition in YAML format+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[Workflow]- Successfully created agent+ AsyncHttpResponse[RunTagsResponse]+ Successfully deleted tag (or no-op if absent)"""_response = await self._client_wrapper.httpx_client.request(- "v1/agents",- method="POST",- params={- "folder_id": folder_id,- },- json={- "json_definition": convert_and_respect_annotation_metadata(- object_=json_definition, annotation=WorkflowCreateYamlRequest, direction="write"- ),- "yaml_definition": yaml_definition,- },- headers={- "content-type": "application/json",- },+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags/{jsonable_encoder(key)}",+ method="DELETE",request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- Workflow,+ RunTagsResponse,parse_obj_as(- type_=Workflow, # type: ignore+ type_=RunTagsResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5469,61 +7142,71 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def update_workflow(+ async def get_run_tag_history(self,- workflow_id: str,+ workflow_run_id: str,*,- json_definition: typing.Optional[WorkflowCreateYamlRequest] = OMIT,- yaml_definition: typing.Optional[str] = OMIT,+ limit: typing.Optional[int] = None,+ since: typing.Optional[dt.datetime] = None,+ key: typing.Optional[str] = None,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[Workflow]:+ ) -> AsyncHttpResponse[RunTagHistoryResponse]:"""- Update an agent+ Chronological tag-event log for a workflow run (newest first). Includes SET and DELETE events.Parameters----------- workflow_id : str- The ID of the agent to update. Starts with `wpid_`.+ workflow_run_id : str+ Workflow run ID- json_definition : typing.Optional[WorkflowCreateYamlRequest]- Workflow definition in JSON format+ limit : typing.Optional[int]+ Max events to return- yaml_definition : typing.Optional[str]- Workflow definition in YAML format+ since : typing.Optional[dt.datetime]+ Only return events at or after this timestamp++ key : typing.Optional[str]+ Filter to events for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[Workflow]- Successfully updated agent+ AsyncHttpResponse[RunTagHistoryResponse]+ Successfully retrieved tag history"""_response = await self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_id)}",- method="POST",- json={- "json_definition": convert_and_respect_annotation_metadata(- object_=json_definition, annotation=WorkflowCreateYamlRequest, direction="write"- ),- "yaml_definition": yaml_definition,- },- headers={- "content-type": "application/json",+ f"v1/runs/{jsonable_encoder(workflow_run_id)}/tags/history",+ method="GET",+ params={+ "limit": limit,+ "since": serialize_datetime(since) if since is not None else None,+ "key": key,},request_options=request_options,- omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- Workflow,+ RunTagHistoryResponse,parse_obj_as(- type_=Workflow, # type: ignore+ type_=RunTagHistoryResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5540,38 +7223,33 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def delete_workflow(- self, workflow_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:+ async def list_tag_keys(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[typing.List[TagKey]]:"""- Delete an agent+ List all tag keys registered for the organization with their descriptions.Parameters----------- workflow_id : str- The ID of the agent to delete. Starts with `wpid_`.-request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.Optional[typing.Any]]- Successfully deleted agent+ AsyncHttpResponse[typing.List[TagKey]]+ Successfully retrieved tag keys"""_response = await self._client_wrapper.httpx_client.request(- f"v1/agents/{jsonable_encoder(workflow_id)}/delete",- method="POST",+ "v1/tag-keys",+ method="GET",request_options=request_options,)try:- if _response is None or not _response.text.strip():- return AsyncHttpResponse(response=_response, data=None)if 200 <= _response.status_code < 300:_data = typing.cast(- typing.Optional[typing.Any],+ typing.List[TagKey],parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore+ type_=typing.List[TagKey], # type: ignoreobject_=_response.json(),),)@@ -5592,56 +7270,51 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def get_folders(- self,- *,- page: typing.Optional[int] = None,- page_size: typing.Optional[int] = None,- search: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[typing.List[Folder]]:+ async def delete_tag_key(+ self, key: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[TagKeyDeleteResponse]:"""- Get all folders for the organization+ Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.Parameters----------- page : typing.Optional[int]- Page number-- page_size : typing.Optional[int]- Number of folders per page-- search : typing.Optional[str]- Search folders by title or description+ key : str+ Tag key to deleterequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.List[Folder]]- Successfully retrieved folders+ AsyncHttpResponse[TagKeyDeleteResponse]+ Successfully deleted tag key"""_response = await self._client_wrapper.httpx_client.request(- "v1/folders",- method="GET",- params={- "page": page,- "page_size": page_size,- "search": search,- },+ f"v1/tag-keys/{jsonable_encoder(key)}",+ method="DELETE",request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[Folder],+ TagKeyDeleteResponse,parse_obj_as(- type_=typing.List[Folder], # type: ignore+ type_=TagKeyDeleteResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5658,37 +7331,36 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def create_folder(+ async def update_tag_key(self,+ key: str,*,- title: str,description: typing.Optional[str] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[Folder]:+ ) -> AsyncHttpResponse[TagKey]:"""- Create a new folder to organize workflows+ Update the description for a tag key.Parameters----------- title : str- Folder title+ key : str+ Tag key to updatedescription : typing.Optional[str]- Folder description+ Free-form description (max 500 chars). Pass null to clear.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[Folder]- Successfully created folder+ AsyncHttpResponse[TagKey]+ Successfully updated tag key"""_response = await self._client_wrapper.httpx_client.request(- "v1/folders",- method="POST",+ f"v1/tag-keys/{jsonable_encoder(key)}",+ method="PATCH",json={- "title": title,"description": description,},headers={@@ -5700,15 +7372,15 @@ class AsyncRawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- Folder,+ TagKey,parse_obj_as(- type_=Folder, # type: ignore+ type_=TagKey, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)- if _response.status_code == 400:- raise BadRequestError(+ if _response.status_code == 404:+ raise NotFoundError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -5734,51 +7406,43 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def get_folder(- self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[Folder]:+ async def list_tag_values(+ self, *, key: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[typing.List[TagValue]]:"""- Get a specific folder by ID+ List the palette color and current workflow usage count for each grouped tag (key, value) for the organization. The frontend joins these onto tags by (key, value); workflow_count is the number of non-deleted workflows carrying the label and powers the per-label usage and delete blast-radius warnings.Parameters----------- folder_id : str- Folder ID+ key : typing.Optional[str]+ Filter to values for a single tag keyrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[Folder]- Successfully retrieved folder+ AsyncHttpResponse[typing.List[TagValue]]+ Successfully retrieved tag values"""_response = await self._client_wrapper.httpx_client.request(- f"v1/folders/{jsonable_encoder(folder_id)}",+ "v1/tag-values",method="GET",+ params={+ "key": key,+ },request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- Folder,+ typing.List[TagValue],parse_obj_as(- type_=Folder, # type: ignore+ type_=typing.List[TagValue], # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(- headers=dict(_response.headers),- body=typing.cast(- typing.Optional[typing.Any],- parse_obj_as(- type_=typing.Optional[typing.Any], # type: ignore- object_=_response.json(),- ),- ),- )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5795,42 +7459,33 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def update_folder(- self,- folder_id: str,- *,- title: typing.Optional[str] = OMIT,- description: typing.Optional[str] = OMIT,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[Folder]:+ async def delete_tag_value(+ self, key: str, *, value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[TagValueDeleteResponse]:"""- Update a folder's title or description+ Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.Parameters----------- folder_id : str- Folder ID-- title : typing.Optional[str]- Folder title+ key : str+ Tag key (group)- description : typing.Optional[str]- Folder description+ value : str+ Tag value (label) under the key to soft-delete.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[Folder]- Successfully updated folder+ AsyncHttpResponse[TagValueDeleteResponse]+ Successfully deleted tag value"""_response = await self._client_wrapper.httpx_client.request(- f"v1/folders/{jsonable_encoder(folder_id)}",- method="PUT",+ f"v1/tag-values/{jsonable_encoder(key)}",+ method="DELETE",json={- "title": title,- "description": description,+ "value": value,},headers={"content-type": "application/json",@@ -5841,9 +7496,9 @@ class AsyncRawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- Folder,+ TagValueDeleteResponse,parse_obj_as(- type_=Folder, # type: ignore+ type_=TagValueDeleteResponse, # type: ignoreobject_=_response.json(),),)@@ -5875,46 +7530,50 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def delete_folder(- self,- folder_id: str,- *,- delete_workflows: typing.Optional[bool] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[typing.Dict[str, typing.Optional[typing.Any]]]:+ async def update_tag_value(+ self, key: str, *, value: str, color: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[TagValue]:"""- Delete a folder. Optionally delete all workflows in the folder.+ Recolor a grouped tag (key, value). The value is supplied in the body so values containing '/' stay addressable. The new color must be a palette name.Parameters----------- folder_id : str- Folder ID+ key : str+ Tag key (group)- delete_workflows : typing.Optional[bool]- If true, also delete all workflows in this folder+ value : str+ Tag value (label) under the key to recolor.++ color : str+ Palette color name to assign to this (key, value).request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.Dict[str, typing.Optional[typing.Any]]]- Successfully deleted folder+ AsyncHttpResponse[TagValue]+ Successfully recolored tag value"""_response = await self._client_wrapper.httpx_client.request(- f"v1/folders/{jsonable_encoder(folder_id)}",- method="DELETE",- params={- "delete_workflows": delete_workflows,+ f"v1/tag-values/{jsonable_encoder(key)}",+ method="PATCH",+ json={+ "value": value,+ "color": color,+ },+ headers={+ "content-type": "application/json",},request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.Dict[str, typing.Optional[typing.Any]],+ TagValue,parse_obj_as(- type_=typing.Dict[str, typing.Optional[typing.Any]], # type: ignore+ type_=TagValue, # type: ignoreobject_=_response.json(),),)@@ -5946,37 +7605,76 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def list_tag_keys(- self, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[typing.List[TagKey]]:+ async def rename_tag_value(+ self, key: str, *, value: str, new_value: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[TagValueRenameResponse]:"""- List all tag keys registered for the organization with their descriptions.+ Rename a grouped tag (key, value) to (key, new_value). The cascade re-tags every workflow carrying the old label; the new label inherits the old color. Both values ride in the body so values containing '/' stay addressable. Rejects with 409 when the new value already exists for the key.Parameters----------+ key : str+ Tag key (group)++ value : str+ Current tag value (label) under the key to rename.++ new_value : str+ New tag value (label) to rename it to.+request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[typing.List[TagKey]]- Successfully retrieved tag keys+ AsyncHttpResponse[TagValueRenameResponse]+ Successfully renamed tag value"""_response = await self._client_wrapper.httpx_client.request(- "v1/tag-keys",- method="GET",+ f"v1/tag-values/{jsonable_encoder(key)}/rename",+ method="PATCH",+ json={+ "value": value,+ "new_value": new_value,+ },+ headers={+ "content-type": "application/json",+ },request_options=request_options,+ omit=OMIT,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- typing.List[TagKey],+ TagValueRenameResponse,parse_obj_as(- type_=typing.List[TagKey], # type: ignore+ type_=TagValueRenameResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -5993,42 +7691,48 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def delete_tag_key(- self, key: str, *, request_options: typing.Optional[RequestOptions] = None- ) -> AsyncHttpResponse[TagKeyDeleteResponse]:+ async def batch_get_workflow_tags(+ self,+ *,+ workflow_permanent_ids: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[WorkflowTagsBatchResponse]:"""- Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.+ Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.Parameters----------- key : str- Tag key to delete+ workflow_permanent_ids : typing.Optional[str]+ Comma-separated workflow permanent IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[TagKeyDeleteResponse]- Successfully deleted tag key+ AsyncHttpResponse[WorkflowTagsBatchResponse]+ Successfully retrieved tags"""_response = await self._client_wrapper.httpx_client.request(- f"v1/tag-keys/{jsonable_encoder(key)}",- method="DELETE",+ "v1/workflow-tags",+ method="GET",+ params={+ "workflow_permanent_ids": workflow_permanent_ids,+ },request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagKeyDeleteResponse,+ WorkflowTagsBatchResponse,parse_obj_as(- type_=TagKeyDeleteResponse, # type: ignore+ type_=WorkflowTagsBatchResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -6054,37 +7758,33 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def update_tag_key(+ async def batch_get_workflow_tags_post(self,- key: str,*,- description: typing.Optional[str] = OMIT,+ workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[TagKey]:+ ) -> AsyncHttpResponse[WorkflowTagsBatchResponse]:"""- Update the description for a tag key.+ Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).Parameters----------- key : str- Tag key to update-- description : typing.Optional[str]- Free-form description (max 500 chars). Pass null to clear.+ workflow_permanent_ids : typing.Optional[typing.Sequence[str]]+ Workflow permanent IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[TagKey]- Successfully updated tag key+ AsyncHttpResponse[WorkflowTagsBatchResponse]+ Successfully retrieved tags"""_response = await self._client_wrapper.httpx_client.request(- f"v1/tag-keys/{jsonable_encoder(key)}",- method="PATCH",+ "v1/workflow-tags",+ method="POST",json={- "description": description,+ "workflow_permanent_ids": workflow_permanent_ids,},headers={"content-type": "application/json",@@ -6095,15 +7795,15 @@ class AsyncRawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- TagKey,+ WorkflowTagsBatchResponse,parse_obj_as(- type_=TagKey, # type: ignore+ type_=WorkflowTagsBatchResponse, # type: ignoreobject_=_response.json(),),)return AsyncHttpResponse(response=_response, data=_data)- if _response.status_code == 404:- raise NotFoundError(+ if _response.status_code == 400:+ raise BadRequestError(headers=dict(_response.headers),body=typing.cast(typing.Optional[typing.Any],@@ -6129,42 +7829,39 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def batch_get_workflow_tags(- self,- *,- workflow_permanent_ids: typing.Optional[str] = None,- request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[WorkflowTagsBatchResponse]:+ async def batch_get_run_tags(+ self, *, workflow_run_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[RunTagsBatchResponse]:"""- Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.+ Batch fetch current tags for many workflow runs. Avoids N+1 on run-list pages.Parameters----------- workflow_permanent_ids : typing.Optional[str]- Comma-separated workflow permanent IDs+ workflow_run_ids : typing.Optional[str]+ Comma-separated workflow run IDsrequest_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[WorkflowTagsBatchResponse]+ AsyncHttpResponse[RunTagsBatchResponse]Successfully retrieved tags"""_response = await self._client_wrapper.httpx_client.request(- "v1/workflow-tags",+ "v1/run-tags",method="GET",params={- "workflow_permanent_ids": workflow_permanent_ids,+ "workflow_run_ids": workflow_run_ids,},request_options=request_options,)try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowTagsBatchResponse,+ RunTagsBatchResponse,parse_obj_as(- type_=WorkflowTagsBatchResponse, # type: ignore+ type_=RunTagsBatchResponse, # type: ignoreobject_=_response.json(),),)@@ -6196,33 +7893,33 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)- async def batch_get_workflow_tags_post(+ async def batch_get_run_tags_post(self,*,- workflow_permanent_ids: typing.Optional[typing.Sequence[str]] = OMIT,+ workflow_run_ids: typing.Optional[typing.Sequence[str]] = OMIT,request_options: typing.Optional[RequestOptions] = None,- ) -> AsyncHttpResponse[WorkflowTagsBatchResponse]:+ ) -> AsyncHttpResponse[RunTagsBatchResponse]:"""- Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).+ Batch fetch current tags for many workflow runs (POST variant for id lists exceeding URL length).Parameters----------- workflow_permanent_ids : typing.Optional[typing.Sequence[str]]- Workflow permanent IDs to fetch tags for.+ workflow_run_ids : typing.Optional[typing.Sequence[str]]+ Workflow run IDs to fetch tags for.request_options : typing.Optional[RequestOptions]Request-specific configuration.Returns-------- AsyncHttpResponse[WorkflowTagsBatchResponse]+ AsyncHttpResponse[RunTagsBatchResponse]Successfully retrieved tags"""_response = await self._client_wrapper.httpx_client.request(- "v1/workflow-tags",+ "v1/run-tags",method="POST",json={- "workflow_permanent_ids": workflow_permanent_ids,+ "workflow_run_ids": workflow_run_ids,},headers={"content-type": "application/json",@@ -6233,9 +7930,9 @@ class AsyncRawSkyvern:try:if 200 <= _response.status_code < 300:_data = typing.cast(- WorkflowTagsBatchResponse,+ RunTagsBatchResponse,parse_obj_as(- type_=WorkflowTagsBatchResponse, # type: ignore+ type_=RunTagsBatchResponse, # type: ignoreobject_=_response.json(),),)@@ -6504,6 +8201,7 @@ class AsyncRawSkyvern:page_size: typing.Optional[int] = None,status: typing.Optional[typing.Union[RunStatus, typing.Sequence[RunStatus]]] = None,search_key: typing.Optional[str] = None,+ run_type: typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]] = None,request_options: typing.Optional[RequestOptions] = None,) -> AsyncHttpResponse[typing.List[TaskRunListItem]]:"""@@ -6518,6 +8216,8 @@ class AsyncRawSkyvern:search_key : typing.Optional[str]Case-insensitive substring search (min 3 chars for trigram index).+ run_type : typing.Optional[typing.Union[RunType, typing.Sequence[RunType]]]+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -6534,6 +8234,7 @@ class AsyncRawSkyvern:"page_size": page_size,"status": status,"search_key": search_key,+ "run_type": run_type,},request_options=request_options,)@@ -6623,6 +8324,7 @@ class AsyncRawSkyvern:page_size: typing.Optional[int] = None,include_deleted: typing.Optional[bool] = None,search_key: typing.Optional[str] = None,+ managed: typing.Optional[bool] = None,request_options: typing.Optional[RequestOptions] = None,) -> AsyncHttpResponse[typing.List[BrowserProfile]]:"""@@ -6640,6 +8342,9 @@ class AsyncRawSkyvern:search_key : typing.Optional[str]Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.+ managed : typing.Optional[bool]+ Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -6656,6 +8361,7 @@ class AsyncRawSkyvern:"page_size": page_size,"include_deleted": include_deleted,"search_key": search_key,+ "managed": managed,},request_options=request_options,)@@ -7079,6 +8785,7 @@ class AsyncRawSkyvern:*,timeout: typing.Optional[int] = OMIT,proxy_location: typing.Optional[CreateBrowserSessionRequestProxyLocation] = OMIT,+ proxy_session_id: typing.Optional[str] = OMIT,extensions: typing.Optional[typing.Sequence[Extensions]] = OMIT,browser_type: typing.Optional[PersistentBrowserType] = OMIT,browser_profile_id: typing.Optional[str] = OMIT,@@ -7130,6 +8837,9 @@ class AsyncRawSkyvern:For self-hosted deployments, you can pass a custom proxy URL as a dict: {"url": "http://user:[email protected]:8080"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.Can also be a GeoTarget object for granular city/state targeting: {"country": "US", "subdivision": "CA", "city": "San Francisco"}, or a custom proxy URL dict for self-hosted deployments: {"url": "http://user:[email protected]:8080"}+ proxy_session_id : typing.Optional[str]+ Opaque Skyvern-managed proxy sticky-session id for pinned Residential ISP sessions.+extensions : typing.Optional[typing.Sequence[Extensions]]A list of extensions to install in the browser session.@@ -7158,6 +8868,7 @@ class AsyncRawSkyvern:"proxy_location": convert_and_respect_annotation_metadata(object_=proxy_location, annotation=CreateBrowserSessionRequestProxyLocation, direction="write"),+ "proxy_session_id": proxy_session_id,"extensions": extensions,"browser_type": browser_type,"browser_profile_id": browser_profile_id,@@ -7264,6 +8975,17 @@ class AsyncRawSkyvern:),),)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )if _response.status_code == 422:raise UnprocessableEntityError(headers=dict(_response.headers),@@ -7904,6 +9626,222 @@ class AsyncRawSkyvern:raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+ async def list_custom_llms(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[CustomLlmListResponse]:+ """+ List the custom LLM configurations available to the current organization.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CustomLlmListResponse]+ Successful Response+ """+ _response = await self._client_wrapper.httpx_client.request(+ "v1/custom-llms",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmListResponse,+ parse_obj_as(+ type_=CustomLlmListResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_custom_llm(+ self, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[CustomLlmResponse]:+ """+ Create a custom LLM configuration for the current organization.++ Parameters+ ----------+ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CustomLlmResponse]+ Successful Response+ """+ _response = await self._client_wrapper.httpx_client.request(+ "v1/custom-llms",+ method="POST",+ json={+ "config": convert_and_respect_annotation_metadata(+ object_=config, annotation=CustomLlmConfig, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmResponse,+ parse_obj_as(+ type_=CustomLlmResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def update_custom_llm(+ self, custom_llm_id: str, *, config: CustomLlmConfig, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[CustomLlmResponse]:+ """+ Update a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ config : CustomLlmConfig++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CustomLlmResponse]+ Successful Response+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/custom-llms/{jsonable_encoder(custom_llm_id)}",+ method="PUT",+ json={+ "config": convert_and_respect_annotation_metadata(+ object_=config, annotation=CustomLlmConfig, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CustomLlmResponse,+ parse_obj_as(+ type_=CustomLlmResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete_custom_llm(+ self, custom_llm_id: str, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ClearOrganizationAuthTokenResponse]:+ """+ Delete a custom LLM configuration for the current organization.++ Parameters+ ----------+ custom_llm_id : str+ The custom LLM id.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ClearOrganizationAuthTokenResponse]+ Successful Response+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"v1/custom-llms/{jsonable_encoder(custom_llm_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ClearOrganizationAuthTokenResponse,+ parse_obj_as(+ type_=ClearOrganizationAuthTokenResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ typing.Optional[typing.Any],+ parse_obj_as(+ type_=typing.Optional[typing.Any], # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+async def login(self,*,@@ -8691,6 +10629,7 @@ class AsyncRawSkyvern:*,tags: typing.Optional[typing.Sequence[TagInput]] = OMIT,tags_to_delete: typing.Optional[typing.Sequence[TagDeleteInput]] = OMIT,+ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,request_options: typing.Optional[RequestOptions] = None,) -> AsyncHttpResponse[TagsResponse]:"""@@ -8707,6 +10646,9 @@ class AsyncRawSkyvern:tags_to_delete : typing.Optional[typing.Sequence[TagDeleteInput]]Tags to soft-delete. List of {key?, value?} targets.+ colors : typing.Optional[typing.Dict[str, typing.Optional[str]]]+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -8725,6 +10667,7 @@ class AsyncRawSkyvern:"tags_to_delete": convert_and_respect_annotation_metadata(object_=tags_to_delete, annotation=typing.Sequence[TagDeleteInput], direction="write"),+ "colors": colors,},headers={"content-type": "application/json",@@ -9111,6 +11054,8 @@ class AsyncRawSkyvern:status: typing.Optional[typing.Union[WorkflowRunStatus, typing.Sequence[WorkflowRunStatus]]] = None,search_key: typing.Optional[str] = None,error_code: typing.Optional[str] = None,+ created_at_start: typing.Optional[dt.datetime] = None,+ created_at_end: typing.Optional[dt.datetime] = None,request_options: typing.Optional[RequestOptions] = None,) -> AsyncHttpResponse[typing.List[WorkflowRun]]:"""@@ -9145,6 +11090,12 @@ class AsyncRawSkyvern:error_code : typing.Optional[str]Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.+ created_at_start : typing.Optional[dt.datetime]+ Only include runs created at or after this UTC timestamp (ISO 8601).++ created_at_end : typing.Optional[dt.datetime]+ Only include runs created strictly before this UTC timestamp (ISO 8601).+request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -9162,6 +11113,8 @@ class AsyncRawSkyvern:"status": status,"search_key": search_key,"error_code": error_code,+ "created_at_start": serialize_datetime(created_at_start) if created_at_start is not None else None,+ "created_at_end": serialize_datetime(created_at_end) if created_at_end is not None else None,},request_options=request_options,)diff --git a/skyvern/client/types/__init__.py b/skyvern/client/types/__init__.pyindex ae34a4694..68752a4ab 100644--- a/skyvern/client/types/__init__.py+++ b/skyvern/client/types/__init__.py@@ -57,6 +57,7 @@ if typing.TYPE_CHECKING:from .browser_profile_proxy_location import BrowserProfileProxyLocationfrom .browser_session_response import BrowserSessionResponsefrom .bulk_cancel_runs_response import BulkCancelRunsResponse+ from .clear_organization_auth_token_response import ClearOrganizationAuthTokenResponsefrom .click_action import ClickActionfrom .click_action_data import ClickActionDatafrom .click_context import ClickContext@@ -75,6 +76,8 @@ if typing.TYPE_CHECKING:CodeBlockParametersItem_Output,CodeBlockParametersItem_Workflow,)+ from .code_block_step import CodeBlockStep+ from .code_block_step_yaml import CodeBlockStepYamlfrom .code_block_yaml import CodeBlockYamlfrom .conditional_block import ConditionalBlockfrom .conditional_block_yaml import ConditionalBlockYaml@@ -105,12 +108,37 @@ if typing.TYPE_CHECKING:from .credential_parameter_yaml import CredentialParameterYamlfrom .credential_response import CredentialResponsefrom .credential_response_credential import CredentialResponseCredential+ from .credential_response_proxy_location import CredentialResponseProxyLocationfrom .credential_type_output import CredentialTypeOutputfrom .credential_vault_type import CredentialVaultType+ from .credit_card_billing_address import CreditCardBillingAddressfrom .credit_card_credential_response import CreditCardCredentialResponse+ from .custom_llm import CustomLlm+ from .custom_llm_config import CustomLlmConfig+ from .custom_llm_list_response import CustomLlmListResponse+ from .custom_llm_provider import CustomLlmProvider+ from .custom_llm_response import CustomLlmResponsefrom .delete_schedule_response import DeleteScheduleResponsefrom .download_to_s3block import DownloadToS3Blockfrom .download_to_s3block_yaml import DownloadToS3BlockYaml+ from .email_inbox_block import EmailInboxBlock+ from .email_inbox_block_email_client import EmailInboxBlockEmailClient+ from .email_inbox_block_parameters_item import (+ EmailInboxBlockParametersItem,+ EmailInboxBlockParametersItem_AwsSecret,+ EmailInboxBlockParametersItem_AzureSecret,+ EmailInboxBlockParametersItem_AzureVaultCredential,+ EmailInboxBlockParametersItem_BitwardenCreditCardData,+ EmailInboxBlockParametersItem_BitwardenLoginCredential,+ EmailInboxBlockParametersItem_BitwardenSensitiveInformation,+ EmailInboxBlockParametersItem_Context,+ EmailInboxBlockParametersItem_Credential,+ EmailInboxBlockParametersItem_Onepassword,+ EmailInboxBlockParametersItem_Output,+ EmailInboxBlockParametersItem_Workflow,+ )+ from .email_inbox_block_yaml import EmailInboxBlockYaml+ from .email_inbox_block_yaml_email_client import EmailInboxBlockYamlEmailClientfrom .extensions import Extensionsfrom .extract_action import ExtractActionfrom .extract_action_data import ExtractActionData@@ -168,6 +196,7 @@ if typing.TYPE_CHECKING:ForLoopBlockLoopBlocksItem_Code,ForLoopBlockLoopBlocksItem_Conditional,ForLoopBlockLoopBlocksItem_DownloadToS3,+ ForLoopBlockLoopBlocksItem_EmailInbox,ForLoopBlockLoopBlocksItem_Extraction,ForLoopBlockLoopBlocksItem_FileDownload,ForLoopBlockLoopBlocksItem_FileUpload,@@ -180,9 +209,11 @@ if typing.TYPE_CHECKING:ForLoopBlockLoopBlocksItem_HumanInteraction,ForLoopBlockLoopBlocksItem_Login,ForLoopBlockLoopBlocksItem_Navigation,+ ForLoopBlockLoopBlocksItem_PdfFill,ForLoopBlockLoopBlocksItem_PdfParser,ForLoopBlockLoopBlocksItem_PrintPage,ForLoopBlockLoopBlocksItem_SendEmail,+ ForLoopBlockLoopBlocksItem_SplitPdf,ForLoopBlockLoopBlocksItem_Task,ForLoopBlockLoopBlocksItem_TaskV2,ForLoopBlockLoopBlocksItem_TextPrompt,@@ -214,6 +245,7 @@ if typing.TYPE_CHECKING:ForLoopBlockYamlLoopBlocksItem_Code,ForLoopBlockYamlLoopBlocksItem_Conditional,ForLoopBlockYamlLoopBlocksItem_DownloadToS3,+ ForLoopBlockYamlLoopBlocksItem_EmailInbox,ForLoopBlockYamlLoopBlocksItem_Extraction,ForLoopBlockYamlLoopBlocksItem_FileDownload,ForLoopBlockYamlLoopBlocksItem_FileUpload,@@ -226,9 +258,11 @@ if typing.TYPE_CHECKING:ForLoopBlockYamlLoopBlocksItem_HumanInteraction,ForLoopBlockYamlLoopBlocksItem_Login,ForLoopBlockYamlLoopBlocksItem_Navigation,+ ForLoopBlockYamlLoopBlocksItem_PdfFill,ForLoopBlockYamlLoopBlocksItem_PdfParser,ForLoopBlockYamlLoopBlocksItem_PrintPage,ForLoopBlockYamlLoopBlocksItem_SendEmail,+ ForLoopBlockYamlLoopBlocksItem_SplitPdf,ForLoopBlockYamlLoopBlocksItem_Task,ForLoopBlockYamlLoopBlocksItem_TaskV2,ForLoopBlockYamlLoopBlocksItem_TextPrompt,@@ -366,6 +400,24 @@ if typing.TYPE_CHECKING:from .output_parameter import OutputParameterfrom .output_parameter_yaml import OutputParameterYamlfrom .password_credential_response import PasswordCredentialResponse+ from .pdf_fill_block import PdfFillBlock+ from .pdf_fill_block_parameters_item import (+ PdfFillBlockParametersItem,+ PdfFillBlockParametersItem_AwsSecret,+ PdfFillBlockParametersItem_AzureSecret,+ PdfFillBlockParametersItem_AzureVaultCredential,+ PdfFillBlockParametersItem_BitwardenCreditCardData,+ PdfFillBlockParametersItem_BitwardenLoginCredential,+ PdfFillBlockParametersItem_BitwardenSensitiveInformation,+ PdfFillBlockParametersItem_Context,+ PdfFillBlockParametersItem_Credential,+ PdfFillBlockParametersItem_Onepassword,+ PdfFillBlockParametersItem_Output,+ PdfFillBlockParametersItem_Workflow,+ )+ from .pdf_fill_block_payload import PdfFillBlockPayload+ from .pdf_fill_block_yaml import PdfFillBlockYaml+ from .pdf_fill_block_yaml_payload import PdfFillBlockYamlPayloadfrom .pdf_format import PdfFormatfrom .pdf_parser_block import PdfParserBlockfrom .pdf_parser_block_yaml import PdfParserBlockYaml@@ -405,6 +457,10 @@ if typing.TYPE_CHECKING:)from .run_sdk_action_response import RunSdkActionResponsefrom .run_status import RunStatus+ from .run_tag_history_response import RunTagHistoryResponse+ from .run_tags_batch_response import RunTagsBatchResponse+ from .run_tags_response import RunTagsResponse+ from .run_type import RunTypefrom .run_webhook_replay_response import RunWebhookReplayResponsefrom .script import Scriptfrom .script_file_create import ScriptFileCreate@@ -418,6 +474,23 @@ if typing.TYPE_CHECKING:from .send_email_block_yaml import SendEmailBlockYamlfrom .skyvern_forge_sdk_schemas_credentials_credential_type import SkyvernForgeSdkSchemasCredentialsCredentialTypefrom .skyvern_schemas_credential_type_credential_type import SkyvernSchemasCredentialTypeCredentialType+ from .split_pdf_block import SplitPdfBlock+ from .split_pdf_block_parameters_item import (+ SplitPdfBlockParametersItem,+ SplitPdfBlockParametersItem_AwsSecret,+ SplitPdfBlockParametersItem_AzureSecret,+ SplitPdfBlockParametersItem_AzureVaultCredential,+ SplitPdfBlockParametersItem_BitwardenCreditCardData,+ SplitPdfBlockParametersItem_BitwardenLoginCredential,+ SplitPdfBlockParametersItem_BitwardenSensitiveInformation,+ SplitPdfBlockParametersItem_Context,+ SplitPdfBlockParametersItem_Credential,+ SplitPdfBlockParametersItem_Onepassword,+ SplitPdfBlockParametersItem_Output,+ SplitPdfBlockParametersItem_Workflow,+ )+ from .split_pdf_block_yaml import SplitPdfBlockYaml+ from .tag_apply_request import TagApplyRequestfrom .tag_delete_input import TagDeleteInputfrom .tag_history_item import TagHistoryItemfrom .tag_history_response import TagHistoryResponse@@ -426,6 +499,9 @@ if typing.TYPE_CHECKING:from .tag_key import TagKeyfrom .tag_key_delete_response import TagKeyDeleteResponsefrom .tag_response import TagResponse+ from .tag_value import TagValue+ from .tag_value_delete_response import TagValueDeleteResponse+ from .tag_value_rename_response import TagValueRenameResponsefrom .tags_response import TagsResponsefrom .task_block import TaskBlockfrom .task_block_data_schema import TaskBlockDataSchema@@ -548,6 +624,7 @@ if typing.TYPE_CHECKING:WhileLoopBlockLoopBlocksItem_Code,WhileLoopBlockLoopBlocksItem_Conditional,WhileLoopBlockLoopBlocksItem_DownloadToS3,+ WhileLoopBlockLoopBlocksItem_EmailInbox,WhileLoopBlockLoopBlocksItem_Extraction,WhileLoopBlockLoopBlocksItem_FileDownload,WhileLoopBlockLoopBlocksItem_FileUpload,@@ -560,9 +637,11 @@ if typing.TYPE_CHECKING:WhileLoopBlockLoopBlocksItem_HumanInteraction,WhileLoopBlockLoopBlocksItem_Login,WhileLoopBlockLoopBlocksItem_Navigation,+ WhileLoopBlockLoopBlocksItem_PdfFill,WhileLoopBlockLoopBlocksItem_PdfParser,WhileLoopBlockLoopBlocksItem_PrintPage,WhileLoopBlockLoopBlocksItem_SendEmail,+ WhileLoopBlockLoopBlocksItem_SplitPdf,WhileLoopBlockLoopBlocksItem_Task,WhileLoopBlockLoopBlocksItem_TaskV2,WhileLoopBlockLoopBlocksItem_TextPrompt,@@ -579,6 +658,7 @@ if typing.TYPE_CHECKING:WhileLoopBlockYamlLoopBlocksItem_Code,WhileLoopBlockYamlLoopBlocksItem_Conditional,WhileLoopBlockYamlLoopBlocksItem_DownloadToS3,+ WhileLoopBlockYamlLoopBlocksItem_EmailInbox,WhileLoopBlockYamlLoopBlocksItem_Extraction,WhileLoopBlockYamlLoopBlocksItem_FileDownload,WhileLoopBlockYamlLoopBlocksItem_FileUpload,@@ -591,9 +671,11 @@ if typing.TYPE_CHECKING:WhileLoopBlockYamlLoopBlocksItem_HumanInteraction,WhileLoopBlockYamlLoopBlocksItem_Login,WhileLoopBlockYamlLoopBlocksItem_Navigation,+ WhileLoopBlockYamlLoopBlocksItem_PdfFill,WhileLoopBlockYamlLoopBlocksItem_PdfParser,WhileLoopBlockYamlLoopBlocksItem_PrintPage,WhileLoopBlockYamlLoopBlocksItem_SendEmail,+ WhileLoopBlockYamlLoopBlocksItem_SplitPdf,WhileLoopBlockYamlLoopBlocksItem_Task,WhileLoopBlockYamlLoopBlocksItem_TaskV2,WhileLoopBlockYamlLoopBlocksItem_TextPrompt,@@ -613,6 +695,7 @@ if typing.TYPE_CHECKING:WorkflowDefinitionBlocksItem_Code,WorkflowDefinitionBlocksItem_Conditional,WorkflowDefinitionBlocksItem_DownloadToS3,+ WorkflowDefinitionBlocksItem_EmailInbox,WorkflowDefinitionBlocksItem_Extraction,WorkflowDefinitionBlocksItem_FileDownload,WorkflowDefinitionBlocksItem_FileUpload,@@ -625,9 +708,11 @@ if typing.TYPE_CHECKING:WorkflowDefinitionBlocksItem_HumanInteraction,WorkflowDefinitionBlocksItem_Login,WorkflowDefinitionBlocksItem_Navigation,+ WorkflowDefinitionBlocksItem_PdfFill,WorkflowDefinitionBlocksItem_PdfParser,WorkflowDefinitionBlocksItem_PrintPage,WorkflowDefinitionBlocksItem_SendEmail,+ WorkflowDefinitionBlocksItem_SplitPdf,WorkflowDefinitionBlocksItem_Task,WorkflowDefinitionBlocksItem_TaskV2,WorkflowDefinitionBlocksItem_TextPrompt,@@ -658,6 +743,7 @@ if typing.TYPE_CHECKING:WorkflowDefinitionYamlBlocksItem_Code,WorkflowDefinitionYamlBlocksItem_Conditional,WorkflowDefinitionYamlBlocksItem_DownloadToS3,+ WorkflowDefinitionYamlBlocksItem_EmailInbox,WorkflowDefinitionYamlBlocksItem_Extraction,WorkflowDefinitionYamlBlocksItem_FileDownload,WorkflowDefinitionYamlBlocksItem_FileUpload,@@ -670,9 +756,11 @@ if typing.TYPE_CHECKING:WorkflowDefinitionYamlBlocksItem_HumanInteraction,WorkflowDefinitionYamlBlocksItem_Login,WorkflowDefinitionYamlBlocksItem_Navigation,+ WorkflowDefinitionYamlBlocksItem_PdfFill,WorkflowDefinitionYamlBlocksItem_PdfParser,WorkflowDefinitionYamlBlocksItem_PrintPage,WorkflowDefinitionYamlBlocksItem_SendEmail,+ WorkflowDefinitionYamlBlocksItem_SplitPdf,WorkflowDefinitionYamlBlocksItem_Task,WorkflowDefinitionYamlBlocksItem_TaskV2,WorkflowDefinitionYamlBlocksItem_TextPrompt,@@ -787,6 +875,7 @@ _dynamic_imports: typing.Dict[str, str] = {"BrowserProfileProxyLocation": ".browser_profile_proxy_location","BrowserSessionResponse": ".browser_session_response","BulkCancelRunsResponse": ".bulk_cancel_runs_response",+ "ClearOrganizationAuthTokenResponse": ".clear_organization_auth_token_response","ClickAction": ".click_action","ClickActionData": ".click_action_data","ClickContext": ".click_context",@@ -803,6 +892,8 @@ _dynamic_imports: typing.Dict[str, str] = {"CodeBlockParametersItem_Onepassword": ".code_block_parameters_item","CodeBlockParametersItem_Output": ".code_block_parameters_item","CodeBlockParametersItem_Workflow": ".code_block_parameters_item",+ "CodeBlockStep": ".code_block_step",+ "CodeBlockStepYaml": ".code_block_step_yaml","CodeBlockYaml": ".code_block_yaml","ConditionalBlock": ".conditional_block","ConditionalBlockYaml": ".conditional_block_yaml",@@ -831,12 +922,35 @@ _dynamic_imports: typing.Dict[str, str] = {"CredentialParameterYaml": ".credential_parameter_yaml","CredentialResponse": ".credential_response","CredentialResponseCredential": ".credential_response_credential",+ "CredentialResponseProxyLocation": ".credential_response_proxy_location","CredentialTypeOutput": ".credential_type_output","CredentialVaultType": ".credential_vault_type",+ "CreditCardBillingAddress": ".credit_card_billing_address","CreditCardCredentialResponse": ".credit_card_credential_response",+ "CustomLlm": ".custom_llm",+ "CustomLlmConfig": ".custom_llm_config",+ "CustomLlmListResponse": ".custom_llm_list_response",+ "CustomLlmProvider": ".custom_llm_provider",+ "CustomLlmResponse": ".custom_llm_response","DeleteScheduleResponse": ".delete_schedule_response","DownloadToS3Block": ".download_to_s3block","DownloadToS3BlockYaml": ".download_to_s3block_yaml",+ "EmailInboxBlock": ".email_inbox_block",+ "EmailInboxBlockEmailClient": ".email_inbox_block_email_client",+ "EmailInboxBlockParametersItem": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_AwsSecret": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_AzureSecret": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_AzureVaultCredential": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_BitwardenCreditCardData": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_BitwardenLoginCredential": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_BitwardenSensitiveInformation": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_Context": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_Credential": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_Onepassword": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_Output": ".email_inbox_block_parameters_item",+ "EmailInboxBlockParametersItem_Workflow": ".email_inbox_block_parameters_item",+ "EmailInboxBlockYaml": ".email_inbox_block_yaml",+ "EmailInboxBlockYamlEmailClient": ".email_inbox_block_yaml_email_client","Extensions": ".extensions","ExtractAction": ".extract_action","ExtractActionData": ".extract_action_data",@@ -889,6 +1003,7 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockLoopBlocksItem_Code": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_Conditional": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_DownloadToS3": ".for_loop_block_loop_blocks_item",+ "ForLoopBlockLoopBlocksItem_EmailInbox": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_Extraction": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_FileDownload": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_FileUpload": ".for_loop_block_loop_blocks_item",@@ -901,9 +1016,11 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockLoopBlocksItem_HumanInteraction": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_Login": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_Navigation": ".for_loop_block_loop_blocks_item",+ "ForLoopBlockLoopBlocksItem_PdfFill": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_PdfParser": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_PrintPage": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_SendEmail": ".for_loop_block_loop_blocks_item",+ "ForLoopBlockLoopBlocksItem_SplitPdf": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_Task": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_TaskV2": ".for_loop_block_loop_blocks_item","ForLoopBlockLoopBlocksItem_TextPrompt": ".for_loop_block_loop_blocks_item",@@ -931,6 +1048,7 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockYamlLoopBlocksItem_Code": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_Conditional": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_DownloadToS3": ".for_loop_block_yaml_loop_blocks_item",+ "ForLoopBlockYamlLoopBlocksItem_EmailInbox": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_Extraction": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_FileDownload": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_FileUpload": ".for_loop_block_yaml_loop_blocks_item",@@ -943,9 +1061,11 @@ _dynamic_imports: typing.Dict[str, str] = {"ForLoopBlockYamlLoopBlocksItem_HumanInteraction": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_Login": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_Navigation": ".for_loop_block_yaml_loop_blocks_item",+ "ForLoopBlockYamlLoopBlocksItem_PdfFill": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_PdfParser": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_PrintPage": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_SendEmail": ".for_loop_block_yaml_loop_blocks_item",+ "ForLoopBlockYamlLoopBlocksItem_SplitPdf": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_Task": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_TaskV2": ".for_loop_block_yaml_loop_blocks_item","ForLoopBlockYamlLoopBlocksItem_TextPrompt": ".for_loop_block_yaml_loop_blocks_item",@@ -1068,6 +1188,22 @@ _dynamic_imports: typing.Dict[str, str] = {"OutputParameter": ".output_parameter","OutputParameterYaml": ".output_parameter_yaml","PasswordCredentialResponse": ".password_credential_response",+ "PdfFillBlock": ".pdf_fill_block",+ "PdfFillBlockParametersItem": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_AwsSecret": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_AzureSecret": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_AzureVaultCredential": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_BitwardenCreditCardData": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_BitwardenLoginCredential": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_BitwardenSensitiveInformation": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_Context": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_Credential": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_Onepassword": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_Output": ".pdf_fill_block_parameters_item",+ "PdfFillBlockParametersItem_Workflow": ".pdf_fill_block_parameters_item",+ "PdfFillBlockPayload": ".pdf_fill_block_payload",+ "PdfFillBlockYaml": ".pdf_fill_block_yaml",+ "PdfFillBlockYamlPayload": ".pdf_fill_block_yaml_payload","PdfFormat": ".pdf_format","PdfParserBlock": ".pdf_parser_block","PdfParserBlockYaml": ".pdf_parser_block_yaml",@@ -1103,6 +1239,10 @@ _dynamic_imports: typing.Dict[str, str] = {"RunSdkActionRequestAction_Validate": ".run_sdk_action_request_action","RunSdkActionResponse": ".run_sdk_action_response","RunStatus": ".run_status",+ "RunTagHistoryResponse": ".run_tag_history_response",+ "RunTagsBatchResponse": ".run_tags_batch_response",+ "RunTagsResponse": ".run_tags_response",+ "RunType": ".run_type","RunWebhookReplayResponse": ".run_webhook_replay_response","Script": ".script","ScriptFileCreate": ".script_file_create",@@ -1116,6 +1256,21 @@ _dynamic_imports: typing.Dict[str, str] = {"SendEmailBlockYaml": ".send_email_block_yaml","SkyvernForgeSdkSchemasCredentialsCredentialType": ".skyvern_forge_sdk_schemas_credentials_credential_type","SkyvernSchemasCredentialTypeCredentialType": ".skyvern_schemas_credential_type_credential_type",+ "SplitPdfBlock": ".split_pdf_block",+ "SplitPdfBlockParametersItem": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_AwsSecret": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_AzureSecret": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_AzureVaultCredential": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_BitwardenCreditCardData": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_BitwardenLoginCredential": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_BitwardenSensitiveInformation": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_Context": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_Credential": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_Onepassword": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_Output": ".split_pdf_block_parameters_item",+ "SplitPdfBlockParametersItem_Workflow": ".split_pdf_block_parameters_item",+ "SplitPdfBlockYaml": ".split_pdf_block_yaml",+ "TagApplyRequest": ".tag_apply_request","TagDeleteInput": ".tag_delete_input","TagHistoryItem": ".tag_history_item","TagHistoryResponse": ".tag_history_response",@@ -1124,6 +1279,9 @@ _dynamic_imports: typing.Dict[str, str] = {"TagKey": ".tag_key","TagKeyDeleteResponse": ".tag_key_delete_response","TagResponse": ".tag_response",+ "TagValue": ".tag_value",+ "TagValueDeleteResponse": ".tag_value_delete_response",+ "TagValueRenameResponse": ".tag_value_rename_response","TagsResponse": ".tags_response","TaskBlock": ".task_block","TaskBlockDataSchema": ".task_block_data_schema",@@ -1233,6 +1391,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockLoopBlocksItem_Code": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_Conditional": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_DownloadToS3": ".while_loop_block_loop_blocks_item",+ "WhileLoopBlockLoopBlocksItem_EmailInbox": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_Extraction": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_FileDownload": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_FileUpload": ".while_loop_block_loop_blocks_item",@@ -1245,9 +1404,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockLoopBlocksItem_HumanInteraction": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_Login": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_Navigation": ".while_loop_block_loop_blocks_item",+ "WhileLoopBlockLoopBlocksItem_PdfFill": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_PdfParser": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_PrintPage": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_SendEmail": ".while_loop_block_loop_blocks_item",+ "WhileLoopBlockLoopBlocksItem_SplitPdf": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_Task": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_TaskV2": ".while_loop_block_loop_blocks_item","WhileLoopBlockLoopBlocksItem_TextPrompt": ".while_loop_block_loop_blocks_item",@@ -1262,6 +1423,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockYamlLoopBlocksItem_Code": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_Conditional": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_DownloadToS3": ".while_loop_block_yaml_loop_blocks_item",+ "WhileLoopBlockYamlLoopBlocksItem_EmailInbox": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_Extraction": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_FileDownload": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_FileUpload": ".while_loop_block_yaml_loop_blocks_item",@@ -1274,9 +1436,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WhileLoopBlockYamlLoopBlocksItem_HumanInteraction": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_Login": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_Navigation": ".while_loop_block_yaml_loop_blocks_item",+ "WhileLoopBlockYamlLoopBlocksItem_PdfFill": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_PdfParser": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_PrintPage": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_SendEmail": ".while_loop_block_yaml_loop_blocks_item",+ "WhileLoopBlockYamlLoopBlocksItem_SplitPdf": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_Task": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_TaskV2": ".while_loop_block_yaml_loop_blocks_item","WhileLoopBlockYamlLoopBlocksItem_TextPrompt": ".while_loop_block_yaml_loop_blocks_item",@@ -1294,6 +1458,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionBlocksItem_Code": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_Conditional": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_DownloadToS3": ".workflow_definition_blocks_item",+ "WorkflowDefinitionBlocksItem_EmailInbox": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_Extraction": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_FileDownload": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_FileUpload": ".workflow_definition_blocks_item",@@ -1306,9 +1471,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionBlocksItem_HumanInteraction": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_Login": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_Navigation": ".workflow_definition_blocks_item",+ "WorkflowDefinitionBlocksItem_PdfFill": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_PdfParser": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_PrintPage": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_SendEmail": ".workflow_definition_blocks_item",+ "WorkflowDefinitionBlocksItem_SplitPdf": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_Task": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_TaskV2": ".workflow_definition_blocks_item","WorkflowDefinitionBlocksItem_TextPrompt": ".workflow_definition_blocks_item",@@ -1335,6 +1502,7 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionYamlBlocksItem_Code": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_Conditional": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_DownloadToS3": ".workflow_definition_yaml_blocks_item",+ "WorkflowDefinitionYamlBlocksItem_EmailInbox": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_Extraction": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_FileDownload": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_FileUpload": ".workflow_definition_yaml_blocks_item",@@ -1347,9 +1515,11 @@ _dynamic_imports: typing.Dict[str, str] = {"WorkflowDefinitionYamlBlocksItem_HumanInteraction": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_Login": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_Navigation": ".workflow_definition_yaml_blocks_item",+ "WorkflowDefinitionYamlBlocksItem_PdfFill": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_PdfParser": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_PrintPage": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_SendEmail": ".workflow_definition_yaml_blocks_item",+ "WorkflowDefinitionYamlBlocksItem_SplitPdf": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_Task": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_TaskV2": ".workflow_definition_yaml_blocks_item","WorkflowDefinitionYamlBlocksItem_TextPrompt": ".workflow_definition_yaml_blocks_item",@@ -1483,6 +1653,7 @@ __all__ = ["BrowserProfileProxyLocation","BrowserSessionResponse","BulkCancelRunsResponse",+ "ClearOrganizationAuthTokenResponse","ClickAction","ClickActionData","ClickContext",@@ -1499,6 +1670,8 @@ __all__ = ["CodeBlockParametersItem_Onepassword","CodeBlockParametersItem_Output","CodeBlockParametersItem_Workflow",+ "CodeBlockStep",+ "CodeBlockStepYaml","CodeBlockYaml","ConditionalBlock","ConditionalBlockYaml",@@ -1527,12 +1700,35 @@ __all__ = ["CredentialParameterYaml","CredentialResponse","CredentialResponseCredential",+ "CredentialResponseProxyLocation","CredentialTypeOutput","CredentialVaultType",+ "CreditCardBillingAddress","CreditCardCredentialResponse",+ "CustomLlm",+ "CustomLlmConfig",+ "CustomLlmListResponse",+ "CustomLlmProvider",+ "CustomLlmResponse","DeleteScheduleResponse","DownloadToS3Block","DownloadToS3BlockYaml",+ "EmailInboxBlock",+ "EmailInboxBlockEmailClient",+ "EmailInboxBlockParametersItem",+ "EmailInboxBlockParametersItem_AwsSecret",+ "EmailInboxBlockParametersItem_AzureSecret",+ "EmailInboxBlockParametersItem_AzureVaultCredential",+ "EmailInboxBlockParametersItem_BitwardenCreditCardData",+ "EmailInboxBlockParametersItem_BitwardenLoginCredential",+ "EmailInboxBlockParametersItem_BitwardenSensitiveInformation",+ "EmailInboxBlockParametersItem_Context",+ "EmailInboxBlockParametersItem_Credential",+ "EmailInboxBlockParametersItem_Onepassword",+ "EmailInboxBlockParametersItem_Output",+ "EmailInboxBlockParametersItem_Workflow",+ "EmailInboxBlockYaml",+ "EmailInboxBlockYamlEmailClient","Extensions","ExtractAction","ExtractActionData",@@ -1585,6 +1781,7 @@ __all__ = ["ForLoopBlockLoopBlocksItem_Code","ForLoopBlockLoopBlocksItem_Conditional","ForLoopBlockLoopBlocksItem_DownloadToS3",+ "ForLoopBlockLoopBlocksItem_EmailInbox","ForLoopBlockLoopBlocksItem_Extraction","ForLoopBlockLoopBlocksItem_FileDownload","ForLoopBlockLoopBlocksItem_FileUpload",@@ -1597,9 +1794,11 @@ __all__ = ["ForLoopBlockLoopBlocksItem_HumanInteraction","ForLoopBlockLoopBlocksItem_Login","ForLoopBlockLoopBlocksItem_Navigation",+ "ForLoopBlockLoopBlocksItem_PdfFill","ForLoopBlockLoopBlocksItem_PdfParser","ForLoopBlockLoopBlocksItem_PrintPage","ForLoopBlockLoopBlocksItem_SendEmail",+ "ForLoopBlockLoopBlocksItem_SplitPdf","ForLoopBlockLoopBlocksItem_Task","ForLoopBlockLoopBlocksItem_TaskV2","ForLoopBlockLoopBlocksItem_TextPrompt",@@ -1627,6 +1826,7 @@ __all__ = ["ForLoopBlockYamlLoopBlocksItem_Code","ForLoopBlockYamlLoopBlocksItem_Conditional","ForLoopBlockYamlLoopBlocksItem_DownloadToS3",+ "ForLoopBlockYamlLoopBlocksItem_EmailInbox","ForLoopBlockYamlLoopBlocksItem_Extraction","ForLoopBlockYamlLoopBlocksItem_FileDownload","ForLoopBlockYamlLoopBlocksItem_FileUpload",@@ -1639,9 +1839,11 @@ __all__ = ["ForLoopBlockYamlLoopBlocksItem_HumanInteraction","ForLoopBlockYamlLoopBlocksItem_Login","ForLoopBlockYamlLoopBlocksItem_Navigation",+ "ForLoopBlockYamlLoopBlocksItem_PdfFill","ForLoopBlockYamlLoopBlocksItem_PdfParser","ForLoopBlockYamlLoopBlocksItem_PrintPage","ForLoopBlockYamlLoopBlocksItem_SendEmail",+ "ForLoopBlockYamlLoopBlocksItem_SplitPdf","ForLoopBlockYamlLoopBlocksItem_Task","ForLoopBlockYamlLoopBlocksItem_TaskV2","ForLoopBlockYamlLoopBlocksItem_TextPrompt",@@ -1764,6 +1966,22 @@ __all__ = ["OutputParameter","OutputParameterYaml","PasswordCredentialResponse",+ "PdfFillBlock",+ "PdfFillBlockParametersItem",+ "PdfFillBlockParametersItem_AwsSecret",+ "PdfFillBlockParametersItem_AzureSecret",+ "PdfFillBlockParametersItem_AzureVaultCredential",+ "PdfFillBlockParametersItem_BitwardenCreditCardData",+ "PdfFillBlockParametersItem_BitwardenLoginCredential",+ "PdfFillBlockParametersItem_BitwardenSensitiveInformation",+ "PdfFillBlockParametersItem_Context",+ "PdfFillBlockParametersItem_Credential",+ "PdfFillBlockParametersItem_Onepassword",+ "PdfFillBlockParametersItem_Output",+ "PdfFillBlockParametersItem_Workflow",+ "PdfFillBlockPayload",+ "PdfFillBlockYaml",+ "PdfFillBlockYamlPayload","PdfFormat","PdfParserBlock","PdfParserBlockYaml",@@ -1799,6 +2017,10 @@ __all__ = ["RunSdkActionRequestAction_Validate","RunSdkActionResponse","RunStatus",+ "RunTagHistoryResponse",+ "RunTagsBatchResponse",+ "RunTagsResponse",+ "RunType","RunWebhookReplayResponse","Script","ScriptFileCreate",@@ -1812,6 +2034,21 @@ __all__ = ["SendEmailBlockYaml","SkyvernForgeSdkSchemasCredentialsCredentialType","SkyvernSchemasCredentialTypeCredentialType",+ "SplitPdfBlock",+ "SplitPdfBlockParametersItem",+ "SplitPdfBlockParametersItem_AwsSecret",+ "SplitPdfBlockParametersItem_AzureSecret",+ "SplitPdfBlockParametersItem_AzureVaultCredential",+ "SplitPdfBlockParametersItem_BitwardenCreditCardData",+ "SplitPdfBlockParametersItem_BitwardenLoginCredential",+ "SplitPdfBlockParametersItem_BitwardenSensitiveInformation",+ "SplitPdfBlockParametersItem_Context",+ "SplitPdfBlockParametersItem_Credential",+ "SplitPdfBlockParametersItem_Onepassword",+ "SplitPdfBlockParametersItem_Output",+ "SplitPdfBlockParametersItem_Workflow",+ "SplitPdfBlockYaml",+ "TagApplyRequest","TagDeleteInput","TagHistoryItem","TagHistoryResponse",@@ -1820,6 +2057,9 @@ __all__ = ["TagKey","TagKeyDeleteResponse","TagResponse",+ "TagValue",+ "TagValueDeleteResponse",+ "TagValueRenameResponse","TagsResponse","TaskBlock","TaskBlockDataSchema",@@ -1929,6 +2169,7 @@ __all__ = ["WhileLoopBlockLoopBlocksItem_Code","WhileLoopBlockLoopBlocksItem_Conditional","WhileLoopBlockLoopBlocksItem_DownloadToS3",+ "WhileLoopBlockLoopBlocksItem_EmailInbox","WhileLoopBlockLoopBlocksItem_Extraction","WhileLoopBlockLoopBlocksItem_FileDownload","WhileLoopBlockLoopBlocksItem_FileUpload",@@ -1941,9 +2182,11 @@ __all__ = ["WhileLoopBlockLoopBlocksItem_HumanInteraction","WhileLoopBlockLoopBlocksItem_Login","WhileLoopBlockLoopBlocksItem_Navigation",+ "WhileLoopBlockLoopBlocksItem_PdfFill","WhileLoopBlockLoopBlocksItem_PdfParser","WhileLoopBlockLoopBlocksItem_PrintPage","WhileLoopBlockLoopBlocksItem_SendEmail",+ "WhileLoopBlockLoopBlocksItem_SplitPdf","WhileLoopBlockLoopBlocksItem_Task","WhileLoopBlockLoopBlocksItem_TaskV2","WhileLoopBlockLoopBlocksItem_TextPrompt",@@ -1958,6 +2201,7 @@ __all__ = ["WhileLoopBlockYamlLoopBlocksItem_Code","WhileLoopBlockYamlLoopBlocksItem_Conditional","WhileLoopBlockYamlLoopBlocksItem_DownloadToS3",+ "WhileLoopBlockYamlLoopBlocksItem_EmailInbox","WhileLoopBlockYamlLoopBlocksItem_Extraction","WhileLoopBlockYamlLoopBlocksItem_FileDownload","WhileLoopBlockYamlLoopBlocksItem_FileUpload",@@ -1970,9 +2214,11 @@ __all__ = ["WhileLoopBlockYamlLoopBlocksItem_HumanInteraction","WhileLoopBlockYamlLoopBlocksItem_Login","WhileLoopBlockYamlLoopBlocksItem_Navigation",+ "WhileLoopBlockYamlLoopBlocksItem_PdfFill","WhileLoopBlockYamlLoopBlocksItem_PdfParser","WhileLoopBlockYamlLoopBlocksItem_PrintPage","WhileLoopBlockYamlLoopBlocksItem_SendEmail",+ "WhileLoopBlockYamlLoopBlocksItem_SplitPdf","WhileLoopBlockYamlLoopBlocksItem_Task","WhileLoopBlockYamlLoopBlocksItem_TaskV2","WhileLoopBlockYamlLoopBlocksItem_TextPrompt",@@ -1990,6 +2236,7 @@ __all__ = ["WorkflowDefinitionBlocksItem_Code","WorkflowDefinitionBlocksItem_Conditional","WorkflowDefinitionBlocksItem_DownloadToS3",+ "WorkflowDefinitionBlocksItem_EmailInbox","WorkflowDefinitionBlocksItem_Extraction","WorkflowDefinitionBlocksItem_FileDownload","WorkflowDefinitionBlocksItem_FileUpload",@@ -2002,9 +2249,11 @@ __all__ = ["WorkflowDefinitionBlocksItem_HumanInteraction","WorkflowDefinitionBlocksItem_Login","WorkflowDefinitionBlocksItem_Navigation",+ "WorkflowDefinitionBlocksItem_PdfFill","WorkflowDefinitionBlocksItem_PdfParser","WorkflowDefinitionBlocksItem_PrintPage","WorkflowDefinitionBlocksItem_SendEmail",+ "WorkflowDefinitionBlocksItem_SplitPdf","WorkflowDefinitionBlocksItem_Task","WorkflowDefinitionBlocksItem_TaskV2","WorkflowDefinitionBlocksItem_TextPrompt",@@ -2031,6 +2280,7 @@ __all__ = ["WorkflowDefinitionYamlBlocksItem_Code","WorkflowDefinitionYamlBlocksItem_Conditional","WorkflowDefinitionYamlBlocksItem_DownloadToS3",+ "WorkflowDefinitionYamlBlocksItem_EmailInbox","WorkflowDefinitionYamlBlocksItem_Extraction","WorkflowDefinitionYamlBlocksItem_FileDownload","WorkflowDefinitionYamlBlocksItem_FileUpload",@@ -2043,9 +2293,11 @@ __all__ = ["WorkflowDefinitionYamlBlocksItem_HumanInteraction","WorkflowDefinitionYamlBlocksItem_Login","WorkflowDefinitionYamlBlocksItem_Navigation",+ "WorkflowDefinitionYamlBlocksItem_PdfFill","WorkflowDefinitionYamlBlocksItem_PdfParser","WorkflowDefinitionYamlBlocksItem_PrintPage","WorkflowDefinitionYamlBlocksItem_SendEmail",+ "WorkflowDefinitionYamlBlocksItem_SplitPdf","WorkflowDefinitionYamlBlocksItem_Task","WorkflowDefinitionYamlBlocksItem_TaskV2","WorkflowDefinitionYamlBlocksItem_TextPrompt",diff --git a/skyvern/client/types/action_block_parameters_item.py b/skyvern/client/types/action_block_parameters_item.pyindex d2662830e..3009ac670 100644--- a/skyvern/client/types/action_block_parameters_item.py+++ b/skyvern/client/types/action_block_parameters_item.py@@ -183,6 +183,8 @@ class ActionBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/block_type.py b/skyvern/client/types/block_type.pyindex 8aacc37a1..aeb0d83c5 100644--- a/skyvern/client/types/block_type.py+++ b/skyvern/client/types/block_type.py@@ -31,6 +31,9 @@ BlockType = typing.Union["workflow_trigger","google_sheets_read","google_sheets_write",+ "pdf_fill",+ "split_pdf",+ "email_inbox",],typing.Any,]diff --git a/skyvern/client/types/clear_organization_auth_token_response.py b/skyvern/client/types/clear_organization_auth_token_response.pynew file mode 100644index 000000000..2d37d1eeb--- /dev/null+++ b/skyvern/client/types/clear_organization_auth_token_response.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class ClearOrganizationAuthTokenResponse(UniversalBaseModel):+ """+ Response model for clearing an organization auth token.+ """++ success: bool = pydantic.Field()+ """+ Whether the token was cleared successfully+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/code_block.py b/skyvern/client/types/code_block.pyindex ca9857bb6..7c1294d0b 100644--- a/skyvern/client/types/code_block.py+++ b/skyvern/client/types/code_block.py@@ -7,6 +7,7 @@ import typingimport pydanticfrom ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refsfrom .code_block_parameters_item import CodeBlockParametersItem+from .code_block_step import CodeBlockStepfrom .output_parameter import OutputParameter@@ -29,6 +30,8 @@ class CodeBlock(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameters: typing.Optional[typing.List[CodeBlockParametersItem]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStep]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/code_block_parameters_item.py b/skyvern/client/types/code_block_parameters_item.pyindex 9124c170b..56f97a9f5 100644--- a/skyvern/client/types/code_block_parameters_item.py+++ b/skyvern/client/types/code_block_parameters_item.py@@ -183,6 +183,8 @@ class CodeBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/code_block_step.py b/skyvern/client/types/code_block_step.pynew file mode 100644index 000000000..43bd300b2--- /dev/null+++ b/skyvern/client/types/code_block_step.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .action_type import ActionType+++class CodeBlockStep(UniversalBaseModel):+ title: typing.Optional[str] = None+ description: typing.Optional[str] = None+ action_type: typing.Optional[ActionType] = None+ line_start: typing.Optional[int] = None+ line_end: typing.Optional[int] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/code_block_step_yaml.py b/skyvern/client/types/code_block_step_yaml.pynew file mode 100644index 000000000..cfb742c29--- /dev/null+++ b/skyvern/client/types/code_block_step_yaml.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class CodeBlockStepYaml(UniversalBaseModel):+ title: typing.Optional[str] = None+ description: typing.Optional[str] = None+ action_type: typing.Optional[str] = None+ line_start: typing.Optional[int] = None+ line_end: typing.Optional[int] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/code_block_yaml.py b/skyvern/client/types/code_block_yaml.pyindex 0cea41310..b6d7f2f52 100644--- a/skyvern/client/types/code_block_yaml.py+++ b/skyvern/client/types/code_block_yaml.py@@ -4,6 +4,7 @@ import typingimport pydanticfrom ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .code_block_step_yaml import CodeBlockStepYamlclass CodeBlockYaml(UniversalBaseModel):@@ -23,6 +24,8 @@ class CodeBlockYaml(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameter_keys: typing.Optional[typing.List[str]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStepYaml]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/context_parameter_source.py b/skyvern/client/types/context_parameter_source.pyindex 3240a6b82..bf629f7d1 100644--- a/skyvern/client/types/context_parameter_source.py+++ b/skyvern/client/types/context_parameter_source.py@@ -246,6 +246,8 @@ class ContextParameterSource_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/credential_parameter.py b/skyvern/client/types/credential_parameter.pyindex 6d4705bdf..e06bb2d75 100644--- a/skyvern/client/types/credential_parameter.py+++ b/skyvern/client/types/credential_parameter.py@@ -13,6 +13,8 @@ class CredentialParameter(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/credential_parameter_yaml.py b/skyvern/client/types/credential_parameter_yaml.pyindex aa8a22e10..bc5ca5ecf 100644--- a/skyvern/client/types/credential_parameter_yaml.py+++ b/skyvern/client/types/credential_parameter_yaml.py@@ -10,6 +10,8 @@ class CredentialParameterYaml(UniversalBaseModel):key: strdescription: typing.Optional[str] = Nonecredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/credential_response.py b/skyvern/client/types/credential_response.pyindex ceeb22370..6e534b482 100644--- a/skyvern/client/types/credential_response.py+++ b/skyvern/client/types/credential_response.py@@ -5,6 +5,7 @@ import typingimport pydanticfrom ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModelfrom .credential_response_credential import CredentialResponseCredential+from .credential_response_proxy_location import CredentialResponseProxyLocationfrom .credential_type_output import CredentialTypeOutputfrom .credential_vault_type import CredentialVaultType@@ -64,6 +65,16 @@ class CredentialResponse(UniversalBaseModel):ID of the credential folder this credential belongs to, if any"""+ proxy_location: typing.Optional[CredentialResponseProxyLocation] = pydantic.Field(default=None)+ """+ Optional proxy location used for the credential's pinned proxy identity.+ """++ proxy_session_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Opaque Skyvern-managed proxy sticky-session id.+ """+if IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2else:diff --git a/skyvern/client/types/credential_response_proxy_location.py b/skyvern/client/types/credential_response_proxy_location.pynew file mode 100644index 000000000..8856473ba--- /dev/null+++ b/skyvern/client/types/credential_response_proxy_location.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .geo_target import GeoTarget+from .proxy_location import ProxyLocation++CredentialResponseProxyLocation = typing.Union[ProxyLocation, GeoTarget, typing.Dict[str, typing.Optional[typing.Any]]]diff --git a/skyvern/client/types/credit_card_billing_address.py b/skyvern/client/types/credit_card_billing_address.pynew file mode 100644index 000000000..0e10b245e--- /dev/null+++ b/skyvern/client/types/credit_card_billing_address.py@@ -0,0 +1,61 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class CreditCardBillingAddress(UniversalBaseModel):+ """+ Optional billing address fields associated with a credit card credential.+ """++ line1: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing address line 1+ """++ line2: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing address line 2+ """++ city: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing city+ """++ state: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing state or region+ """++ state_code: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing state or region code+ """++ postal_code: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing postal code+ """++ country: typing.Optional[str] = pydantic.Field(default=None)+ """+ Billing country+ """++ country_code: typing.Optional[str] = pydantic.Field(default=None)+ """+ ISO 3166-1 alpha-2 billing country code+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/credit_card_credential_response.py b/skyvern/client/types/credit_card_credential_response.pyindex 33c487039..3b812074b 100644--- a/skyvern/client/types/credit_card_credential_response.py+++ b/skyvern/client/types/credit_card_credential_response.py@@ -10,7 +10,8 @@ class CreditCardCredentialResponse(UniversalBaseModel):"""Response model for credit card credentials — non-sensitive fields only.- SECURITY: Must NEVER include full card number, CVV, expiration date, or card holder name.+ SECURITY: Must NEVER include full card number, CVV, expiration date, card holder name,+ billing fields, or metadata."""last_four: str = pydantic.Field()diff --git a/skyvern/client/types/custom_llm.py b/skyvern/client/types/custom_llm.pynew file mode 100644index 000000000..02623127d--- /dev/null+++ b/skyvern/client/types/custom_llm.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .custom_llm_config import CustomLlmConfig+++class CustomLlm(UniversalBaseModel):+ id: str+ organization_id: str+ config: CustomLlmConfig+ created_at: str+ modified_at: str+ valid: bool++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/custom_llm_config.py b/skyvern/client/types/custom_llm_config.pynew file mode 100644index 000000000..b6fe4ad14--- /dev/null+++ b/skyvern/client/types/custom_llm_config.py@@ -0,0 +1,30 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .custom_llm_provider import CustomLlmProvider+++class CustomLlmConfig(UniversalBaseModel):+ display_name: str+ provider: CustomLlmProvider+ model_name: str+ api_base: typing.Optional[str] = None+ api_key: typing.Optional[str] = None+ api_version: typing.Optional[str] = None+ supports_vision: typing.Optional[bool] = None+ add_assistant_prefix: typing.Optional[bool] = None+ max_completion_tokens: typing.Optional[int] = None+ temperature: typing.Optional[float] = None+ reasoning_effort: typing.Optional[str] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/custom_llm_list_response.py b/skyvern/client/types/custom_llm_list_response.pynew file mode 100644index 000000000..f634764e0--- /dev/null+++ b/skyvern/client/types/custom_llm_list_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .custom_llm import CustomLlm+++class CustomLlmListResponse(UniversalBaseModel):+ custom_llms: typing.List[CustomLlm]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/custom_llm_provider.py b/skyvern/client/types/custom_llm_provider.pynew file mode 100644index 000000000..a87d7fb3f--- /dev/null+++ b/skyvern/client/types/custom_llm_provider.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++CustomLlmProvider = typing.Union[typing.Literal["openai_compatible", "ollama", "openrouter"], typing.Any]diff --git a/skyvern/client/types/custom_llm_response.py b/skyvern/client/types/custom_llm_response.pynew file mode 100644index 000000000..91bd9cf78--- /dev/null+++ b/skyvern/client/types/custom_llm_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .custom_llm import CustomLlm+++class CustomLlmResponse(UniversalBaseModel):+ custom_llm: CustomLlm++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/email_inbox_block.py b/skyvern/client/types/email_inbox_block.pynew file mode 100644index 000000000..5e301ae5e--- /dev/null+++ b/skyvern/client/types/email_inbox_block.py@@ -0,0 +1,54 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .email_inbox_block_email_client import EmailInboxBlockEmailClient+from .email_inbox_block_parameters_item import EmailInboxBlockParametersItem+from .output_parameter import OutputParameter+++class EmailInboxBlock(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier for a block; unique within a workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.+ """++ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameters: typing.Optional[typing.List[EmailInboxBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001++update_forward_refs(EmailInboxBlock)diff --git a/skyvern/client/types/email_inbox_block_email_client.py b/skyvern/client/types/email_inbox_block_email_client.pynew file mode 100644index 000000000..01b84354a--- /dev/null+++ b/skyvern/client/types/email_inbox_block_email_client.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++EmailInboxBlockEmailClient = typing.Union[typing.Literal["gmail", "outlook"], typing.Any]diff --git a/skyvern/client/types/email_inbox_block_parameters_item.py b/skyvern/client/types/email_inbox_block_parameters_item.pynew file mode 100644index 000000000..0ff3c324b--- /dev/null+++ b/skyvern/client/types/email_inbox_block_parameters_item.py@@ -0,0 +1,279 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import datetime as dt+import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .context_parameter_value import ContextParameterValue+from .workflow_parameter_default_value import WorkflowParameterDefaultValue+from .workflow_parameter_type import WorkflowParameterType+++class EmailInboxBlockParametersItem_AwsSecret(UniversalBaseModel):+ parameter_type: typing.Literal["aws_secret"] = "aws_secret"+ key: str+ description: typing.Optional[str] = None+ aws_secret_parameter_id: str+ workflow_id: str+ aws_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_AzureSecret(UniversalBaseModel):+ parameter_type: typing.Literal["azure_secret"] = "azure_secret"+ key: str+ description: typing.Optional[str] = None+ azure_secret_parameter_id: str+ workflow_id: str+ azure_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_AzureVaultCredential(UniversalBaseModel):+ parameter_type: typing.Literal["azure_vault_credential"] = "azure_vault_credential"+ key: str+ description: typing.Optional[str] = None+ azure_vault_credential_parameter_id: str+ workflow_id: str+ vault_name: str+ username_key: str+ password_key: str+ totp_secret_key: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_BitwardenCreditCardData(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_credit_card_data"] = "bitwarden_credit_card_data"+ key: str+ description: typing.Optional[str] = None+ bitwarden_credit_card_data_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_BitwardenLoginCredential(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_login_credential"] = "bitwarden_login_credential"+ key: str+ description: typing.Optional[str] = None+ bitwarden_login_credential_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ url_parameter_key: typing.Optional[str] = None+ bitwarden_collection_id: typing.Optional[str] = None+ bitwarden_item_id: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_BitwardenSensitiveInformation(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_sensitive_information"] = "bitwarden_sensitive_information"+ key: str+ description: typing.Optional[str] = None+ bitwarden_sensitive_information_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_identity_key: str+ bitwarden_identity_fields: typing.List[str]+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_Context(UniversalBaseModel):+ parameter_type: typing.Literal["context"] = "context"+ key: str+ description: typing.Optional[str] = None+ source: "ContextParameterSource"+ value: typing.Optional[ContextParameterValue] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001+from .context_parameter_source import ContextParameterSource # noqa: E402, F401, I001+++class EmailInboxBlockParametersItem_Credential(UniversalBaseModel):+ parameter_type: typing.Literal["credential"] = "credential"+ key: str+ description: typing.Optional[str] = None+ credential_parameter_id: str+ workflow_id: str+ credential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_Onepassword(UniversalBaseModel):+ parameter_type: typing.Literal["onepassword"] = "onepassword"+ key: str+ description: typing.Optional[str] = None+ onepassword_credential_parameter_id: str+ workflow_id: str+ vault_id: str+ item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_Output(UniversalBaseModel):+ parameter_type: typing.Literal["output"] = "output"+ key: str+ description: typing.Optional[str] = None+ output_parameter_id: str+ workflow_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class EmailInboxBlockParametersItem_Workflow(UniversalBaseModel):+ parameter_type: typing.Literal["workflow"] = "workflow"+ key: str+ description: typing.Optional[str] = None+ workflow_parameter_id: str+ workflow_parameter_type: WorkflowParameterType+ workflow_id: str+ default_value: typing.Optional[WorkflowParameterDefaultValue] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++EmailInboxBlockParametersItem = typing.Union[+ EmailInboxBlockParametersItem_AwsSecret,+ EmailInboxBlockParametersItem_AzureSecret,+ EmailInboxBlockParametersItem_AzureVaultCredential,+ EmailInboxBlockParametersItem_BitwardenCreditCardData,+ EmailInboxBlockParametersItem_BitwardenLoginCredential,+ EmailInboxBlockParametersItem_BitwardenSensitiveInformation,+ EmailInboxBlockParametersItem_Context,+ EmailInboxBlockParametersItem_Credential,+ EmailInboxBlockParametersItem_Onepassword,+ EmailInboxBlockParametersItem_Output,+ EmailInboxBlockParametersItem_Workflow,+]+update_forward_refs(EmailInboxBlockParametersItem_Context)diff --git a/skyvern/client/types/email_inbox_block_yaml.py b/skyvern/client/types/email_inbox_block_yaml.pynew file mode 100644index 000000000..bb5f958b2--- /dev/null+++ b/skyvern/client/types/email_inbox_block_yaml.py@@ -0,0 +1,43 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .email_inbox_block_yaml_email_client import EmailInboxBlockYamlEmailClient+++class EmailInboxBlockYaml(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier; must be unique per workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].+ """++ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockYamlEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/email_inbox_block_yaml_email_client.py b/skyvern/client/types/email_inbox_block_yaml_email_client.pynew file mode 100644index 000000000..2df4bef1a--- /dev/null+++ b/skyvern/client/types/email_inbox_block_yaml_email_client.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++EmailInboxBlockYamlEmailClient = typing.Union[typing.Literal["gmail", "outlook"], typing.Any]diff --git a/skyvern/client/types/extraction_block_parameters_item.py b/skyvern/client/types/extraction_block_parameters_item.pyindex 437380f4a..a0c6d5ed2 100644--- a/skyvern/client/types/extraction_block_parameters_item.py+++ b/skyvern/client/types/extraction_block_parameters_item.py@@ -183,6 +183,8 @@ class ExtractionBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/file_download_block_parameters_item.py b/skyvern/client/types/file_download_block_parameters_item.pyindex 07e4b0425..bab25d011 100644--- a/skyvern/client/types/file_download_block_parameters_item.py+++ b/skyvern/client/types/file_download_block_parameters_item.py@@ -183,6 +183,8 @@ class FileDownloadBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/file_type.py b/skyvern/client/types/file_type.pyindex 619ce5455..6575b7e3a 100644--- a/skyvern/client/types/file_type.py+++ b/skyvern/client/types/file_type.py@@ -2,4 +2,4 @@import typing-FileType = typing.Union[typing.Literal["auto_detect", "csv", "excel", "pdf", "image", "docx"], typing.Any]+FileType = typing.Union[typing.Literal["auto_detect", "csv", "excel", "pdf", "image", "docx", "zip"], typing.Any]diff --git a/skyvern/client/types/file_upload_block.py b/skyvern/client/types/file_upload_block.pyindex 79a16e8cc..9cc020147 100644--- a/skyvern/client/types/file_upload_block.py+++ b/skyvern/client/types/file_upload_block.py@@ -45,8 +45,16 @@ class FileUploadBlock(UniversalBaseModel):sftp_private_key_passphrase: typing.Optional[str] = Nonesftp_remote_path: typing.Optional[str] = Nonesftp_host_key: typing.Optional[str] = None- prompt: typing.Optional[str] = None+ prompt: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional natural-language control over which downloaded files are uploaded; empty means upload all.+ """+path: typing.Optional[str] = None+ continue_on_empty: typing.Optional[bool] = pydantic.Field(default=None)+ """+ When the run download directory has no files, allow the empty upload only after confirming no registered, browser-session, or alternate candidate downloads exist (False, default). Set True to always allow an empty upload.+ """if IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/file_upload_block_yaml.py b/skyvern/client/types/file_upload_block_yaml.pyindex fe6d4efb1..e03b20255 100644--- a/skyvern/client/types/file_upload_block_yaml.py+++ b/skyvern/client/types/file_upload_block_yaml.py@@ -43,7 +43,11 @@ class FileUploadBlockYaml(UniversalBaseModel):sftp_private_key_passphrase: typing.Optional[str] = Nonesftp_remote_path: typing.Optional[str] = Nonesftp_host_key: typing.Optional[str] = None- prompt: typing.Optional[str] = None+ prompt: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional natural-language control over which downloaded files are uploaded; empty means upload all.+ """+path: typing.Optional[str] = Noneif IS_PYDANTIC_V2:diff --git a/skyvern/client/types/for_loop_block_loop_blocks_item.py b/skyvern/client/types/for_loop_block_loop_blocks_item.pyindex ff67f4bda..86d8d112f 100644--- a/skyvern/client/types/for_loop_block_loop_blocks_item.py+++ b/skyvern/client/types/for_loop_block_loop_blocks_item.py@@ -14,6 +14,9 @@ from .ai_fallback_mode import AiFallbackModefrom .aws_secret_parameter import AwsSecretParameterfrom .branch_condition import BranchConditionfrom .code_block_parameters_item import CodeBlockParametersItem+from .code_block_step import CodeBlockStep+from .email_inbox_block_email_client import EmailInboxBlockEmailClient+from .email_inbox_block_parameters_item import EmailInboxBlockParametersItemfrom .extraction_block_data_schema import ExtractionBlockDataSchemafrom .extraction_block_parameters_item import ExtractionBlockParametersItemfrom .file_download_block_data_schema import FileDownloadBlockDataSchema@@ -33,8 +36,11 @@ from .login_block_parameters_item import LoginBlockParametersItemfrom .navigation_block_data_schema import NavigationBlockDataSchemafrom .navigation_block_parameters_item import NavigationBlockParametersItemfrom .output_parameter import OutputParameter+from .pdf_fill_block_parameters_item import PdfFillBlockParametersItem+from .pdf_fill_block_payload import PdfFillBlockPayloadfrom .print_page_block_parameters_item import PrintPageBlockParametersItemfrom .run_engine import RunEngine+from .split_pdf_block_parameters_item import SplitPdfBlockParametersItemfrom .task_block_data_schema import TaskBlockDataSchemafrom .task_block_parameters_item import TaskBlockParametersItemfrom .text_prompt_block_parameters_item import TextPromptBlockParametersItem@@ -103,6 +109,8 @@ class ForLoopBlockLoopBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameters: typing.Optional[typing.List[CodeBlockParametersItem]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStep]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -158,6 +166,37 @@ class ForLoopBlockLoopBlocksItem_DownloadToS3(UniversalBaseModel):extra = pydantic.Extra.allow+class ForLoopBlockLoopBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameters: typing.Optional[typing.List[EmailInboxBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class ForLoopBlockLoopBlocksItem_Extraction(UniversalBaseModel):block_type: typing.Literal["extraction"] = "extraction"label: str@@ -262,7 +301,17 @@ class ForLoopBlockLoopBlocksItem_FileUpload(UniversalBaseModel):azure_blob_container_name: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = None+ continue_on_empty: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -442,6 +491,7 @@ class ForLoopBlockLoopBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameters: typing.Optional[typing.List[HttpRequestBlockParametersItem]] = Noneif IS_PYDANTIC_V2:@@ -589,6 +639,32 @@ class ForLoopBlockLoopBlocksItem_Navigation(UniversalBaseModel):extra = pydantic.Extra.allow+class ForLoopBlockLoopBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockPayload] = None+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[PdfFillBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class ForLoopBlockLoopBlocksItem_PdfParser(UniversalBaseModel):block_type: typing.Literal["pdf_parser"] = "pdf_parser"label: str@@ -669,6 +745,31 @@ class ForLoopBlockLoopBlocksItem_SendEmail(UniversalBaseModel):extra = pydantic.Extra.allow+class ForLoopBlockLoopBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[SplitPdfBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class ForLoopBlockLoopBlocksItem_Task(UniversalBaseModel):block_type: typing.Literal["task"] = "task"label: str@@ -816,6 +917,7 @@ class ForLoopBlockLoopBlocksItem_Validation(UniversalBaseModel):include_action_history_in_verification: typing.Optional[bool] = Nonedownload_timeout: typing.Optional[float] = Noneinclude_extracted_text: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -911,6 +1013,7 @@ ForLoopBlockLoopBlocksItem = typing.Union[ForLoopBlockLoopBlocksItem_Code,ForLoopBlockLoopBlocksItem_Conditional,ForLoopBlockLoopBlocksItem_DownloadToS3,+ ForLoopBlockLoopBlocksItem_EmailInbox,ForLoopBlockLoopBlocksItem_Extraction,ForLoopBlockLoopBlocksItem_FileDownload,ForLoopBlockLoopBlocksItem_FileUpload,@@ -923,9 +1026,11 @@ ForLoopBlockLoopBlocksItem = typing.Union[ForLoopBlockLoopBlocksItem_HumanInteraction,ForLoopBlockLoopBlocksItem_Login,ForLoopBlockLoopBlocksItem_Navigation,+ ForLoopBlockLoopBlocksItem_PdfFill,ForLoopBlockLoopBlocksItem_PdfParser,ForLoopBlockLoopBlocksItem_PrintPage,ForLoopBlockLoopBlocksItem_SendEmail,+ ForLoopBlockLoopBlocksItem_SplitPdf,ForLoopBlockLoopBlocksItem_Task,ForLoopBlockLoopBlocksItem_TaskV2,ForLoopBlockLoopBlocksItem_TextPrompt,@@ -939,6 +1044,7 @@ from .while_loop_block_loop_blocks_item import WhileLoopBlockLoopBlocksItem # nupdate_forward_refs(ForLoopBlockLoopBlocksItem_Action)update_forward_refs(ForLoopBlockLoopBlocksItem_Code)+update_forward_refs(ForLoopBlockLoopBlocksItem_EmailInbox)update_forward_refs(ForLoopBlockLoopBlocksItem_Extraction)update_forward_refs(ForLoopBlockLoopBlocksItem_FileDownload)update_forward_refs(ForLoopBlockLoopBlocksItem_ForLoop)@@ -949,7 +1055,9 @@ update_forward_refs(ForLoopBlockLoopBlocksItem_HttpRequest)update_forward_refs(ForLoopBlockLoopBlocksItem_HumanInteraction)update_forward_refs(ForLoopBlockLoopBlocksItem_Login)update_forward_refs(ForLoopBlockLoopBlocksItem_Navigation)+update_forward_refs(ForLoopBlockLoopBlocksItem_PdfFill)update_forward_refs(ForLoopBlockLoopBlocksItem_PrintPage)+update_forward_refs(ForLoopBlockLoopBlocksItem_SplitPdf)update_forward_refs(ForLoopBlockLoopBlocksItem_Task)update_forward_refs(ForLoopBlockLoopBlocksItem_TextPrompt)update_forward_refs(ForLoopBlockLoopBlocksItem_Validation)diff --git a/skyvern/client/types/for_loop_block_loop_over.py b/skyvern/client/types/for_loop_block_loop_over.pyindex 8da93d7d1..65c6cd0d0 100644--- a/skyvern/client/types/for_loop_block_loop_over.py+++ b/skyvern/client/types/for_loop_block_loop_over.py@@ -183,6 +183,8 @@ class ForLoopBlockLoopOver_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/for_loop_block_yaml_loop_blocks_item.py b/skyvern/client/types/for_loop_block_yaml_loop_blocks_item.pyindex 428623ff4..4eaf9e12b 100644--- a/skyvern/client/types/for_loop_block_yaml_loop_blocks_item.py+++ b/skyvern/client/types/for_loop_block_yaml_loop_blocks_item.py@@ -11,11 +11,14 @@ from ..core.serialization import FieldMetadatafrom .ai_fallback_mode import AiFallbackModefrom .branch_condition_yaml import BranchConditionYamlfrom .branch_criteria_yaml import BranchCriteriaYaml+from .code_block_step_yaml import CodeBlockStepYaml+from .email_inbox_block_yaml_email_client import EmailInboxBlockYamlEmailClientfrom .extraction_block_yaml_data_schema import ExtractionBlockYamlDataSchemafrom .file_storage_type import FileStorageTypefrom .file_type import FileTypefrom .for_loop_block_yaml_data_schema import ForLoopBlockYamlDataSchemafrom .google_sheets_write_block_yaml_write_mode import GoogleSheetsWriteBlockYamlWriteMode+from .pdf_fill_block_yaml_payload import PdfFillBlockYamlPayloadfrom .pdf_format import PdfFormatfrom .run_engine import RunEnginefrom .task_block_yaml_data_schema import TaskBlockYamlDataSchema@@ -118,6 +121,8 @@ class ForLoopBlockYamlLoopBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameter_keys: typing.Optional[typing.List[str]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStepYaml]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -211,6 +216,15 @@ class ForLoopBlockYamlLoopBlocksItem_FileUpload(UniversalBaseModel):azure_folder_path: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = Noneif IS_PYDANTIC_V2:@@ -286,6 +300,7 @@ class ForLoopBlockYamlLoopBlocksItem_Validation(UniversalBaseModel):error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Nonedisable_cache: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -591,6 +606,7 @@ class ForLoopBlockYamlLoopBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Noneif IS_PYDANTIC_V2:@@ -648,6 +664,53 @@ class ForLoopBlockYamlLoopBlocksItem_PrintPage(UniversalBaseModel):extra = pydantic.Extra.allow+class ForLoopBlockYamlLoopBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockYamlPayload] = None+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class ForLoopBlockYamlLoopBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class ForLoopBlockYamlLoopBlocksItem_WorkflowTrigger(UniversalBaseModel):block_type: typing.Literal["workflow_trigger"] = "workflow_trigger"label: str@@ -698,6 +761,35 @@ class ForLoopBlockYamlLoopBlocksItem_GoogleSheetsRead(UniversalBaseModel):extra = pydantic.Extra.allow+class ForLoopBlockYamlLoopBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockYamlEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class ForLoopBlockYamlLoopBlocksItem_GoogleSheetsWrite(UniversalBaseModel):block_type: typing.Literal["google_sheets_write"] = "google_sheets_write"label: str@@ -751,8 +843,11 @@ ForLoopBlockYamlLoopBlocksItem = typing.Union[ForLoopBlockYamlLoopBlocksItem_HttpRequest,ForLoopBlockYamlLoopBlocksItem_Conditional,ForLoopBlockYamlLoopBlocksItem_PrintPage,+ ForLoopBlockYamlLoopBlocksItem_PdfFill,+ ForLoopBlockYamlLoopBlocksItem_SplitPdf,ForLoopBlockYamlLoopBlocksItem_WorkflowTrigger,ForLoopBlockYamlLoopBlocksItem_GoogleSheetsRead,+ ForLoopBlockYamlLoopBlocksItem_EmailInbox,ForLoopBlockYamlLoopBlocksItem_GoogleSheetsWrite,]from .while_loop_block_yaml_loop_blocks_item import WhileLoopBlockYamlLoopBlocksItem # noqa: E402, F401, I001diff --git a/skyvern/client/types/google_sheets_read_block_parameters_item.py b/skyvern/client/types/google_sheets_read_block_parameters_item.pyindex d06af1366..b429dd264 100644--- a/skyvern/client/types/google_sheets_read_block_parameters_item.py+++ b/skyvern/client/types/google_sheets_read_block_parameters_item.py@@ -183,6 +183,8 @@ class GoogleSheetsReadBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/google_sheets_write_block_parameters_item.py b/skyvern/client/types/google_sheets_write_block_parameters_item.pyindex 0497c61a0..221ee13c9 100644--- a/skyvern/client/types/google_sheets_write_block_parameters_item.py+++ b/skyvern/client/types/google_sheets_write_block_parameters_item.py@@ -183,6 +183,8 @@ class GoogleSheetsWriteBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/http_request_block.py b/skyvern/client/types/http_request_block.pyindex 4fc1e6e8f..f9fa26d4c 100644--- a/skyvern/client/types/http_request_block.py+++ b/skyvern/client/types/http_request_block.py@@ -36,6 +36,7 @@ class HttpRequestBlock(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameters: typing.Optional[typing.List[HttpRequestBlockParametersItem]] = Noneif IS_PYDANTIC_V2:diff --git a/skyvern/client/types/http_request_block_parameters_item.py b/skyvern/client/types/http_request_block_parameters_item.pyindex aa6bec5e6..9e74ba7ad 100644--- a/skyvern/client/types/http_request_block_parameters_item.py+++ b/skyvern/client/types/http_request_block_parameters_item.py@@ -183,6 +183,8 @@ class HttpRequestBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/http_request_block_yaml.py b/skyvern/client/types/http_request_block_yaml.pyindex b2bd6ae15..93af114f4 100644--- a/skyvern/client/types/http_request_block_yaml.py+++ b/skyvern/client/types/http_request_block_yaml.py@@ -30,6 +30,7 @@ class HttpRequestBlockYaml(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Noneif IS_PYDANTIC_V2:diff --git a/skyvern/client/types/human_interaction_block_parameters_item.py b/skyvern/client/types/human_interaction_block_parameters_item.pyindex f9e760ff0..55ff237cb 100644--- a/skyvern/client/types/human_interaction_block_parameters_item.py+++ b/skyvern/client/types/human_interaction_block_parameters_item.py@@ -183,6 +183,8 @@ class HumanInteractionBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/login_block_parameters_item.py b/skyvern/client/types/login_block_parameters_item.pyindex 37f026ceb..5159dbde7 100644--- a/skyvern/client/types/login_block_parameters_item.py+++ b/skyvern/client/types/login_block_parameters_item.py@@ -183,6 +183,8 @@ class LoginBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/navigation_block_parameters_item.py b/skyvern/client/types/navigation_block_parameters_item.pyindex ebd7d01ad..bf07f06dc 100644--- a/skyvern/client/types/navigation_block_parameters_item.py+++ b/skyvern/client/types/navigation_block_parameters_item.py@@ -183,6 +183,8 @@ class NavigationBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/non_empty_credit_card_credential.py b/skyvern/client/types/non_empty_credit_card_credential.pyindex 6f8ee4c95..44b9e4147 100644--- a/skyvern/client/types/non_empty_credit_card_credential.py+++ b/skyvern/client/types/non_empty_credit_card_credential.py@@ -4,6 +4,7 @@ import typingimport pydanticfrom ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .credit_card_billing_address import CreditCardBillingAddressclass NonEmptyCreditCardCredential(UniversalBaseModel):@@ -41,6 +42,26 @@ class NonEmptyCreditCardCredential(UniversalBaseModel):The name of the card holder (must not be empty)"""+ billing_address: typing.Optional[CreditCardBillingAddress] = pydantic.Field(default=None)+ """+ Optional billing address associated with the card+ """++ billing_email: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional billing email address+ """++ billing_phone: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional billing phone number+ """++ metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(default=None)+ """+ Optional additional credit card metadata fields+ """+if IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2else:diff --git a/skyvern/client/types/pdf_fill_block.py b/skyvern/client/types/pdf_fill_block.pynew file mode 100644index 000000000..bbc281067--- /dev/null+++ b/skyvern/client/types/pdf_fill_block.py@@ -0,0 +1,49 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .output_parameter import OutputParameter+from .pdf_fill_block_parameters_item import PdfFillBlockParametersItem+from .pdf_fill_block_payload import PdfFillBlockPayload+++class PdfFillBlock(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier for a block; unique within a workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.+ """++ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockPayload] = None+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[PdfFillBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001++update_forward_refs(PdfFillBlock)diff --git a/skyvern/client/types/pdf_fill_block_parameters_item.py b/skyvern/client/types/pdf_fill_block_parameters_item.pynew file mode 100644index 000000000..341525b84--- /dev/null+++ b/skyvern/client/types/pdf_fill_block_parameters_item.py@@ -0,0 +1,279 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import datetime as dt+import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .context_parameter_value import ContextParameterValue+from .workflow_parameter_default_value import WorkflowParameterDefaultValue+from .workflow_parameter_type import WorkflowParameterType+++class PdfFillBlockParametersItem_AwsSecret(UniversalBaseModel):+ parameter_type: typing.Literal["aws_secret"] = "aws_secret"+ key: str+ description: typing.Optional[str] = None+ aws_secret_parameter_id: str+ workflow_id: str+ aws_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_AzureSecret(UniversalBaseModel):+ parameter_type: typing.Literal["azure_secret"] = "azure_secret"+ key: str+ description: typing.Optional[str] = None+ azure_secret_parameter_id: str+ workflow_id: str+ azure_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_AzureVaultCredential(UniversalBaseModel):+ parameter_type: typing.Literal["azure_vault_credential"] = "azure_vault_credential"+ key: str+ description: typing.Optional[str] = None+ azure_vault_credential_parameter_id: str+ workflow_id: str+ vault_name: str+ username_key: str+ password_key: str+ totp_secret_key: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_BitwardenCreditCardData(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_credit_card_data"] = "bitwarden_credit_card_data"+ key: str+ description: typing.Optional[str] = None+ bitwarden_credit_card_data_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_BitwardenLoginCredential(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_login_credential"] = "bitwarden_login_credential"+ key: str+ description: typing.Optional[str] = None+ bitwarden_login_credential_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ url_parameter_key: typing.Optional[str] = None+ bitwarden_collection_id: typing.Optional[str] = None+ bitwarden_item_id: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_BitwardenSensitiveInformation(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_sensitive_information"] = "bitwarden_sensitive_information"+ key: str+ description: typing.Optional[str] = None+ bitwarden_sensitive_information_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_identity_key: str+ bitwarden_identity_fields: typing.List[str]+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_Context(UniversalBaseModel):+ parameter_type: typing.Literal["context"] = "context"+ key: str+ description: typing.Optional[str] = None+ source: "ContextParameterSource"+ value: typing.Optional[ContextParameterValue] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001+from .context_parameter_source import ContextParameterSource # noqa: E402, F401, I001+++class PdfFillBlockParametersItem_Credential(UniversalBaseModel):+ parameter_type: typing.Literal["credential"] = "credential"+ key: str+ description: typing.Optional[str] = None+ credential_parameter_id: str+ workflow_id: str+ credential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_Onepassword(UniversalBaseModel):+ parameter_type: typing.Literal["onepassword"] = "onepassword"+ key: str+ description: typing.Optional[str] = None+ onepassword_credential_parameter_id: str+ workflow_id: str+ vault_id: str+ item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_Output(UniversalBaseModel):+ parameter_type: typing.Literal["output"] = "output"+ key: str+ description: typing.Optional[str] = None+ output_parameter_id: str+ workflow_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class PdfFillBlockParametersItem_Workflow(UniversalBaseModel):+ parameter_type: typing.Literal["workflow"] = "workflow"+ key: str+ description: typing.Optional[str] = None+ workflow_parameter_id: str+ workflow_parameter_type: WorkflowParameterType+ workflow_id: str+ default_value: typing.Optional[WorkflowParameterDefaultValue] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++PdfFillBlockParametersItem = typing.Union[+ PdfFillBlockParametersItem_AwsSecret,+ PdfFillBlockParametersItem_AzureSecret,+ PdfFillBlockParametersItem_AzureVaultCredential,+ PdfFillBlockParametersItem_BitwardenCreditCardData,+ PdfFillBlockParametersItem_BitwardenLoginCredential,+ PdfFillBlockParametersItem_BitwardenSensitiveInformation,+ PdfFillBlockParametersItem_Context,+ PdfFillBlockParametersItem_Credential,+ PdfFillBlockParametersItem_Onepassword,+ PdfFillBlockParametersItem_Output,+ PdfFillBlockParametersItem_Workflow,+]+update_forward_refs(PdfFillBlockParametersItem_Context)diff --git a/skyvern/client/types/pdf_fill_block_payload.py b/skyvern/client/types/pdf_fill_block_payload.pynew file mode 100644index 000000000..8c8f5acdd--- /dev/null+++ b/skyvern/client/types/pdf_fill_block_payload.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import typing++PdfFillBlockPayload = typing.Union[+ typing.Dict[str, typing.Optional[typing.Any]], typing.List[typing.Optional[typing.Any]], str+]diff --git a/skyvern/client/types/pdf_fill_block_yaml.py b/skyvern/client/types/pdf_fill_block_yaml.pynew file mode 100644index 000000000..385ba3b14--- /dev/null+++ b/skyvern/client/types/pdf_fill_block_yaml.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .pdf_fill_block_yaml_payload import PdfFillBlockYamlPayload+++class PdfFillBlockYaml(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier; must be unique per workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].+ """++ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockYamlPayload] = None+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/pdf_fill_block_yaml_payload.py b/skyvern/client/types/pdf_fill_block_yaml_payload.pynew file mode 100644index 000000000..4bc2a4fd9--- /dev/null+++ b/skyvern/client/types/pdf_fill_block_yaml_payload.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import typing++PdfFillBlockYamlPayload = typing.Union[+ typing.Dict[str, typing.Optional[typing.Any]], typing.List[typing.Optional[typing.Any]], str+]diff --git a/skyvern/client/types/print_page_block_parameters_item.py b/skyvern/client/types/print_page_block_parameters_item.pyindex 4b50e99c2..d1a279baa 100644--- a/skyvern/client/types/print_page_block_parameters_item.py+++ b/skyvern/client/types/print_page_block_parameters_item.py@@ -183,6 +183,8 @@ class PrintPageBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/run_tag_history_response.py b/skyvern/client/types/run_tag_history_response.pynew file mode 100644index 000000000..7222c3224--- /dev/null+++ b/skyvern/client/types/run_tag_history_response.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .tag_history_item import TagHistoryItem+++class RunTagHistoryResponse(UniversalBaseModel):+ workflow_run_id: str+ events: typing.List[TagHistoryItem]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/run_tags_batch_response.py b/skyvern/client/types/run_tags_batch_response.pynew file mode 100644index 000000000..8e02ac9ab--- /dev/null+++ b/skyvern/client/types/run_tags_batch_response.py@@ -0,0 +1,28 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .tag_item import TagItem+++class RunTagsBatchResponse(UniversalBaseModel):+ """+ Response for the run-tags batch endpoint.++ Runs with no tags are present with an empty list so the frontend can+ distinguish "fetched, none set" from "not fetched" without a second call.+ Runs outside the caller's org are silently absent (no leakage).+ """++ run_tags: typing.Dict[str, typing.List[TagItem]]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/run_tags_response.py b/skyvern/client/types/run_tags_response.pynew file mode 100644index 000000000..fb43dbb50--- /dev/null+++ b/skyvern/client/types/run_tags_response.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .tag_response import TagResponse+++class RunTagsResponse(UniversalBaseModel):+ """+ Current tags for a workflow run.+ """++ workflow_run_id: str+ tags: typing.List[TagResponse]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/run_type.py b/skyvern/client/types/run_type.pynew file mode 100644index 000000000..29b8f40cb--- /dev/null+++ b/skyvern/client/types/run_type.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++RunType = typing.Union[+ typing.Literal["task_v1", "task_v2", "workflow_run", "openai_cua", "anthropic_cua", "ui_tars", "yutori_navigator"],+ typing.Any,+]diff --git a/skyvern/client/types/split_pdf_block.py b/skyvern/client/types/split_pdf_block.pynew file mode 100644index 000000000..6516bf098--- /dev/null+++ b/skyvern/client/types/split_pdf_block.py@@ -0,0 +1,47 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .output_parameter import OutputParameter+from .split_pdf_block_parameters_item import SplitPdfBlockParametersItem+++class SplitPdfBlock(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier for a block; unique within a workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.+ """++ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[SplitPdfBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001++update_forward_refs(SplitPdfBlock)diff --git a/skyvern/client/types/split_pdf_block_parameters_item.py b/skyvern/client/types/split_pdf_block_parameters_item.pynew file mode 100644index 000000000..eb61be434--- /dev/null+++ b/skyvern/client/types/split_pdf_block_parameters_item.py@@ -0,0 +1,279 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import datetime as dt+import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel, update_forward_refs+from .context_parameter_value import ContextParameterValue+from .workflow_parameter_default_value import WorkflowParameterDefaultValue+from .workflow_parameter_type import WorkflowParameterType+++class SplitPdfBlockParametersItem_AwsSecret(UniversalBaseModel):+ parameter_type: typing.Literal["aws_secret"] = "aws_secret"+ key: str+ description: typing.Optional[str] = None+ aws_secret_parameter_id: str+ workflow_id: str+ aws_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_AzureSecret(UniversalBaseModel):+ parameter_type: typing.Literal["azure_secret"] = "azure_secret"+ key: str+ description: typing.Optional[str] = None+ azure_secret_parameter_id: str+ workflow_id: str+ azure_key: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_AzureVaultCredential(UniversalBaseModel):+ parameter_type: typing.Literal["azure_vault_credential"] = "azure_vault_credential"+ key: str+ description: typing.Optional[str] = None+ azure_vault_credential_parameter_id: str+ workflow_id: str+ vault_name: str+ username_key: str+ password_key: str+ totp_secret_key: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_BitwardenCreditCardData(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_credit_card_data"] = "bitwarden_credit_card_data"+ key: str+ description: typing.Optional[str] = None+ bitwarden_credit_card_data_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_BitwardenLoginCredential(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_login_credential"] = "bitwarden_login_credential"+ key: str+ description: typing.Optional[str] = None+ bitwarden_login_credential_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ url_parameter_key: typing.Optional[str] = None+ bitwarden_collection_id: typing.Optional[str] = None+ bitwarden_item_id: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_BitwardenSensitiveInformation(UniversalBaseModel):+ parameter_type: typing.Literal["bitwarden_sensitive_information"] = "bitwarden_sensitive_information"+ key: str+ description: typing.Optional[str] = None+ bitwarden_sensitive_information_parameter_id: str+ workflow_id: str+ bitwarden_client_id_aws_secret_key: str+ bitwarden_client_secret_aws_secret_key: str+ bitwarden_master_password_aws_secret_key: str+ bitwarden_collection_id: str+ bitwarden_identity_key: str+ bitwarden_identity_fields: typing.List[str]+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_Context(UniversalBaseModel):+ parameter_type: typing.Literal["context"] = "context"+ key: str+ description: typing.Optional[str] = None+ source: "ContextParameterSource"+ value: typing.Optional[ContextParameterValue] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++from .context_parameter import ContextParameter # noqa: E402, F401, I001+from .context_parameter_source import ContextParameterSource # noqa: E402, F401, I001+++class SplitPdfBlockParametersItem_Credential(UniversalBaseModel):+ parameter_type: typing.Literal["credential"] = "credential"+ key: str+ description: typing.Optional[str] = None+ credential_parameter_id: str+ workflow_id: str+ credential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_Onepassword(UniversalBaseModel):+ parameter_type: typing.Literal["onepassword"] = "onepassword"+ key: str+ description: typing.Optional[str] = None+ onepassword_credential_parameter_id: str+ workflow_id: str+ vault_id: str+ item_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_Output(UniversalBaseModel):+ parameter_type: typing.Literal["output"] = "output"+ key: str+ description: typing.Optional[str] = None+ output_parameter_id: str+ workflow_id: str+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class SplitPdfBlockParametersItem_Workflow(UniversalBaseModel):+ parameter_type: typing.Literal["workflow"] = "workflow"+ key: str+ description: typing.Optional[str] = None+ workflow_parameter_id: str+ workflow_parameter_type: WorkflowParameterType+ workflow_id: str+ default_value: typing.Optional[WorkflowParameterDefaultValue] = None+ created_at: dt.datetime+ modified_at: dt.datetime+ deleted_at: typing.Optional[dt.datetime] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++SplitPdfBlockParametersItem = typing.Union[+ SplitPdfBlockParametersItem_AwsSecret,+ SplitPdfBlockParametersItem_AzureSecret,+ SplitPdfBlockParametersItem_AzureVaultCredential,+ SplitPdfBlockParametersItem_BitwardenCreditCardData,+ SplitPdfBlockParametersItem_BitwardenLoginCredential,+ SplitPdfBlockParametersItem_BitwardenSensitiveInformation,+ SplitPdfBlockParametersItem_Context,+ SplitPdfBlockParametersItem_Credential,+ SplitPdfBlockParametersItem_Onepassword,+ SplitPdfBlockParametersItem_Output,+ SplitPdfBlockParametersItem_Workflow,+]+update_forward_refs(SplitPdfBlockParametersItem_Context)diff --git a/skyvern/client/types/split_pdf_block_yaml.py b/skyvern/client/types/split_pdf_block_yaml.pynew file mode 100644index 000000000..e6495a2e8--- /dev/null+++ b/skyvern/client/types/split_pdf_block_yaml.py@@ -0,0 +1,36 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class SplitPdfBlockYaml(UniversalBaseModel):+ label: str = pydantic.Field()+ """+ Author-facing identifier; must be unique per workflow.+ """++ next_block_label: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].+ """++ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/tag_apply_request.py b/skyvern/client/types/tag_apply_request.pynew file mode 100644index 000000000..6929fd54b--- /dev/null+++ b/skyvern/client/types/tag_apply_request.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+from .tag_delete_input import TagDeleteInput+from .tag_input import TagInput+++class TagApplyRequest(UniversalBaseModel):+ """+ Body for ``POST /v1/workflows/{wpid}/tags``. Either field may be empty (both+ empty is a no-op). On a same-identity collision, set wins over delete.+ """++ tags: typing.Optional[typing.List[TagInput]] = pydantic.Field(default=None)+ """+ Tags to set (overwrite). List of {key?, value} objects.+ """++ tags_to_delete: typing.Optional[typing.List[TagDeleteInput]] = pydantic.Field(default=None)+ """+ Tags to soft-delete. List of {key?, value?} targets.+ """++ colors: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(default=None)+ """+ Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/tag_key_delete_response.py b/skyvern/client/types/tag_key_delete_response.pyindex 92717e45b..1f8453eb4 100644--- a/skyvern/client/types/tag_key_delete_response.py+++ b/skyvern/client/types/tag_key_delete_response.py@@ -13,6 +13,8 @@ class TagKeyDeleteResponse(UniversalBaseModel):key: strremoved_from_workflow_count: int+ removed_from_run_count: typing.Optional[int] = None+ removed_count: typing.Optional[int] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/tag_value.py b/skyvern/client/types/tag_value.pynew file mode 100644index 000000000..88215208c--- /dev/null+++ b/skyvern/client/types/tag_value.py@@ -0,0 +1,30 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class TagValue(UniversalBaseModel):+ """+ Tag-value color registry entry: the palette color assigned to a grouped+ (key, value) pair.+ """++ key: str+ value: str+ color: str+ workflow_count: typing.Optional[int] = pydantic.Field(default=None)+ """+ Number of non-deleted workflows currently carrying this (key, value) label.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/tag_value_delete_response.py b/skyvern/client/types/tag_value_delete_response.pynew file mode 100644index 000000000..0100d7088--- /dev/null+++ b/skyvern/client/types/tag_value_delete_response.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class TagValueDeleteResponse(UniversalBaseModel):+ """+ Response for ``DELETE /v1/tag-values/{key}``.+ """++ key: str+ value: str+ removed_from_workflow_count: int+ removed_from_run_count: typing.Optional[int] = None+ removed_count: typing.Optional[int] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/tag_value_rename_response.py b/skyvern/client/types/tag_value_rename_response.pynew file mode 100644index 000000000..93bdddde9--- /dev/null+++ b/skyvern/client/types/tag_value_rename_response.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel+++class TagValueRenameResponse(UniversalBaseModel):+ """+ Response for ``PATCH /v1/tag-values/{key}/rename``: the renamed label with its+ carried-over color and the number of workflows re-tagged.+ """++ key: str+ value: str+ color: str+ renamed_workflow_count: int++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/skyvern/client/types/task_block_parameters_item.py b/skyvern/client/types/task_block_parameters_item.pyindex 63ca5a120..8584652d8 100644--- a/skyvern/client/types/task_block_parameters_item.py+++ b/skyvern/client/types/task_block_parameters_item.py@@ -183,6 +183,8 @@ class TaskBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/text_prompt_block_parameters_item.py b/skyvern/client/types/text_prompt_block_parameters_item.pyindex e8bcf29d4..acda20725 100644--- a/skyvern/client/types/text_prompt_block_parameters_item.py+++ b/skyvern/client/types/text_prompt_block_parameters_item.py@@ -183,6 +183,8 @@ class TextPromptBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/url_block_parameters_item.py b/skyvern/client/types/url_block_parameters_item.pyindex 0ca3a0680..10b1be6ce 100644--- a/skyvern/client/types/url_block_parameters_item.py+++ b/skyvern/client/types/url_block_parameters_item.py@@ -183,6 +183,8 @@ class UrlBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/validation_block.py b/skyvern/client/types/validation_block.pyindex 8b9869c65..aeb8a00ad 100644--- a/skyvern/client/types/validation_block.py+++ b/skyvern/client/types/validation_block.py@@ -50,6 +50,7 @@ class ValidationBlock(UniversalBaseModel):include_action_history_in_verification: typing.Optional[bool] = Nonedownload_timeout: typing.Optional[float] = Noneinclude_extracted_text: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/validation_block_parameters_item.py b/skyvern/client/types/validation_block_parameters_item.pyindex 05b929df4..778de767d 100644--- a/skyvern/client/types/validation_block_parameters_item.py+++ b/skyvern/client/types/validation_block_parameters_item.py@@ -183,6 +183,8 @@ class ValidationBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/validation_block_yaml.py b/skyvern/client/types/validation_block_yaml.pyindex ff9ba78a4..877a8fa46 100644--- a/skyvern/client/types/validation_block_yaml.py+++ b/skyvern/client/types/validation_block_yaml.py@@ -26,6 +26,7 @@ class ValidationBlockYaml(UniversalBaseModel):error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Nonedisable_cache: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/wait_block_parameters_item.py b/skyvern/client/types/wait_block_parameters_item.pyindex 9529dba88..b50694eb7 100644--- a/skyvern/client/types/wait_block_parameters_item.py+++ b/skyvern/client/types/wait_block_parameters_item.py@@ -183,6 +183,8 @@ class WaitBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/while_loop_block_loop_blocks_item.py b/skyvern/client/types/while_loop_block_loop_blocks_item.pyindex af7560111..786dcf93a 100644--- a/skyvern/client/types/while_loop_block_loop_blocks_item.py+++ b/skyvern/client/types/while_loop_block_loop_blocks_item.py@@ -14,6 +14,9 @@ from .ai_fallback_mode import AiFallbackModefrom .aws_secret_parameter import AwsSecretParameterfrom .branch_condition import BranchConditionfrom .code_block_parameters_item import CodeBlockParametersItem+from .code_block_step import CodeBlockStep+from .email_inbox_block_email_client import EmailInboxBlockEmailClient+from .email_inbox_block_parameters_item import EmailInboxBlockParametersItemfrom .extraction_block_data_schema import ExtractionBlockDataSchemafrom .extraction_block_parameters_item import ExtractionBlockParametersItemfrom .file_download_block_data_schema import FileDownloadBlockDataSchema@@ -33,8 +36,11 @@ from .login_block_parameters_item import LoginBlockParametersItemfrom .navigation_block_data_schema import NavigationBlockDataSchemafrom .navigation_block_parameters_item import NavigationBlockParametersItemfrom .output_parameter import OutputParameter+from .pdf_fill_block_parameters_item import PdfFillBlockParametersItem+from .pdf_fill_block_payload import PdfFillBlockPayloadfrom .print_page_block_parameters_item import PrintPageBlockParametersItemfrom .run_engine import RunEngine+from .split_pdf_block_parameters_item import SplitPdfBlockParametersItemfrom .task_block_data_schema import TaskBlockDataSchemafrom .task_block_parameters_item import TaskBlockParametersItemfrom .text_prompt_block_parameters_item import TextPromptBlockParametersItem@@ -103,6 +109,8 @@ class WhileLoopBlockLoopBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameters: typing.Optional[typing.List[CodeBlockParametersItem]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStep]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -158,6 +166,37 @@ class WhileLoopBlockLoopBlocksItem_DownloadToS3(UniversalBaseModel):extra = pydantic.Extra.allow+class WhileLoopBlockLoopBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameters: typing.Optional[typing.List[EmailInboxBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WhileLoopBlockLoopBlocksItem_Extraction(UniversalBaseModel):block_type: typing.Literal["extraction"] = "extraction"label: str@@ -262,7 +301,17 @@ class WhileLoopBlockLoopBlocksItem_FileUpload(UniversalBaseModel):azure_blob_container_name: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = None+ continue_on_empty: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -442,6 +491,7 @@ class WhileLoopBlockLoopBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameters: typing.Optional[typing.List[HttpRequestBlockParametersItem]] = Noneif IS_PYDANTIC_V2:@@ -589,6 +639,32 @@ class WhileLoopBlockLoopBlocksItem_Navigation(UniversalBaseModel):extra = pydantic.Extra.allow+class WhileLoopBlockLoopBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockPayload] = None+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[PdfFillBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WhileLoopBlockLoopBlocksItem_PdfParser(UniversalBaseModel):block_type: typing.Literal["pdf_parser"] = "pdf_parser"label: str@@ -669,6 +745,31 @@ class WhileLoopBlockLoopBlocksItem_SendEmail(UniversalBaseModel):extra = pydantic.Extra.allow+class WhileLoopBlockLoopBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[SplitPdfBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WhileLoopBlockLoopBlocksItem_Task(UniversalBaseModel):block_type: typing.Literal["task"] = "task"label: str@@ -816,6 +917,7 @@ class WhileLoopBlockLoopBlocksItem_Validation(UniversalBaseModel):include_action_history_in_verification: typing.Optional[bool] = Nonedownload_timeout: typing.Optional[float] = Noneinclude_extracted_text: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -911,6 +1013,7 @@ WhileLoopBlockLoopBlocksItem = typing.Union[WhileLoopBlockLoopBlocksItem_Code,WhileLoopBlockLoopBlocksItem_Conditional,WhileLoopBlockLoopBlocksItem_DownloadToS3,+ WhileLoopBlockLoopBlocksItem_EmailInbox,WhileLoopBlockLoopBlocksItem_Extraction,WhileLoopBlockLoopBlocksItem_FileDownload,WhileLoopBlockLoopBlocksItem_FileUpload,@@ -923,9 +1026,11 @@ WhileLoopBlockLoopBlocksItem = typing.Union[WhileLoopBlockLoopBlocksItem_HumanInteraction,WhileLoopBlockLoopBlocksItem_Login,WhileLoopBlockLoopBlocksItem_Navigation,+ WhileLoopBlockLoopBlocksItem_PdfFill,WhileLoopBlockLoopBlocksItem_PdfParser,WhileLoopBlockLoopBlocksItem_PrintPage,WhileLoopBlockLoopBlocksItem_SendEmail,+ WhileLoopBlockLoopBlocksItem_SplitPdf,WhileLoopBlockLoopBlocksItem_Task,WhileLoopBlockLoopBlocksItem_TaskV2,WhileLoopBlockLoopBlocksItem_TextPrompt,@@ -939,6 +1044,7 @@ from .for_loop_block_loop_blocks_item import ForLoopBlockLoopBlocksItem # noqa:update_forward_refs(WhileLoopBlockLoopBlocksItem_Action)update_forward_refs(WhileLoopBlockLoopBlocksItem_Code)+update_forward_refs(WhileLoopBlockLoopBlocksItem_EmailInbox)update_forward_refs(WhileLoopBlockLoopBlocksItem_Extraction)update_forward_refs(WhileLoopBlockLoopBlocksItem_FileDownload)update_forward_refs(WhileLoopBlockLoopBlocksItem_ForLoop)@@ -949,7 +1055,9 @@ update_forward_refs(WhileLoopBlockLoopBlocksItem_HttpRequest)update_forward_refs(WhileLoopBlockLoopBlocksItem_HumanInteraction)update_forward_refs(WhileLoopBlockLoopBlocksItem_Login)update_forward_refs(WhileLoopBlockLoopBlocksItem_Navigation)+update_forward_refs(WhileLoopBlockLoopBlocksItem_PdfFill)update_forward_refs(WhileLoopBlockLoopBlocksItem_PrintPage)+update_forward_refs(WhileLoopBlockLoopBlocksItem_SplitPdf)update_forward_refs(WhileLoopBlockLoopBlocksItem_Task)update_forward_refs(WhileLoopBlockLoopBlocksItem_TextPrompt)update_forward_refs(WhileLoopBlockLoopBlocksItem_Validation)diff --git a/skyvern/client/types/while_loop_block_yaml_loop_blocks_item.py b/skyvern/client/types/while_loop_block_yaml_loop_blocks_item.pyindex 19604a1fc..aa16928cb 100644--- a/skyvern/client/types/while_loop_block_yaml_loop_blocks_item.py+++ b/skyvern/client/types/while_loop_block_yaml_loop_blocks_item.py@@ -11,11 +11,14 @@ from ..core.serialization import FieldMetadatafrom .ai_fallback_mode import AiFallbackModefrom .branch_condition_yaml import BranchConditionYamlfrom .branch_criteria_yaml import BranchCriteriaYaml+from .code_block_step_yaml import CodeBlockStepYaml+from .email_inbox_block_yaml_email_client import EmailInboxBlockYamlEmailClientfrom .extraction_block_yaml_data_schema import ExtractionBlockYamlDataSchemafrom .file_storage_type import FileStorageTypefrom .file_type import FileTypefrom .for_loop_block_yaml_data_schema import ForLoopBlockYamlDataSchemafrom .google_sheets_write_block_yaml_write_mode import GoogleSheetsWriteBlockYamlWriteMode+from .pdf_fill_block_yaml_payload import PdfFillBlockYamlPayloadfrom .pdf_format import PdfFormatfrom .run_engine import RunEnginefrom .task_block_yaml_data_schema import TaskBlockYamlDataSchema@@ -118,6 +121,8 @@ class WhileLoopBlockYamlLoopBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameter_keys: typing.Optional[typing.List[str]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStepYaml]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -211,6 +216,15 @@ class WhileLoopBlockYamlLoopBlocksItem_FileUpload(UniversalBaseModel):azure_folder_path: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = Noneif IS_PYDANTIC_V2:@@ -286,6 +300,7 @@ class WhileLoopBlockYamlLoopBlocksItem_Validation(UniversalBaseModel):error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Nonedisable_cache: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -591,6 +606,7 @@ class WhileLoopBlockYamlLoopBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Noneif IS_PYDANTIC_V2:@@ -648,6 +664,53 @@ class WhileLoopBlockYamlLoopBlocksItem_PrintPage(UniversalBaseModel):extra = pydantic.Extra.allow+class WhileLoopBlockYamlLoopBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockYamlPayload] = None+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow+++class WhileLoopBlockYamlLoopBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WhileLoopBlockYamlLoopBlocksItem_WorkflowTrigger(UniversalBaseModel):block_type: typing.Literal["workflow_trigger"] = "workflow_trigger"label: str@@ -698,6 +761,35 @@ class WhileLoopBlockYamlLoopBlocksItem_GoogleSheetsRead(UniversalBaseModel):extra = pydantic.Extra.allow+class WhileLoopBlockYamlLoopBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockYamlEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WhileLoopBlockYamlLoopBlocksItem_GoogleSheetsWrite(UniversalBaseModel):block_type: typing.Literal["google_sheets_write"] = "google_sheets_write"label: str@@ -751,8 +843,11 @@ WhileLoopBlockYamlLoopBlocksItem = typing.Union[WhileLoopBlockYamlLoopBlocksItem_HttpRequest,WhileLoopBlockYamlLoopBlocksItem_Conditional,WhileLoopBlockYamlLoopBlocksItem_PrintPage,+ WhileLoopBlockYamlLoopBlocksItem_PdfFill,+ WhileLoopBlockYamlLoopBlocksItem_SplitPdf,WhileLoopBlockYamlLoopBlocksItem_WorkflowTrigger,WhileLoopBlockYamlLoopBlocksItem_GoogleSheetsRead,+ WhileLoopBlockYamlLoopBlocksItem_EmailInbox,WhileLoopBlockYamlLoopBlocksItem_GoogleSheetsWrite,]from .for_loop_block_yaml_loop_blocks_item import ForLoopBlockYamlLoopBlocksItem # noqa: E402, F401, I001diff --git a/skyvern/client/types/workflow.py b/skyvern/client/types/workflow.pyindex 607fbc0bc..7c262cebb 100644--- a/skyvern/client/types/workflow.py+++ b/skyvern/client/types/workflow.py@@ -29,6 +29,7 @@ class Workflow(UniversalBaseModel):persist_browser_session: typing.Optional[bool] = Nonepin_saved_session_ip: typing.Optional[bool] = Nonebrowser_profile_id: typing.Optional[str] = None+ browser_profile_key: typing.Optional[str] = Nonemodel: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = Nonestatus: typing.Optional[WorkflowStatus] = Nonemax_screenshot_scrolls: typing.Optional[int] = None@@ -39,6 +40,7 @@ class Workflow(UniversalBaseModel):ai_fallback: typing.Optional[bool] = Nonecache_key: typing.Optional[str] = Noneadaptive_caching: typing.Optional[bool] = None+ enable_self_healing: typing.Optional[bool] = Nonecode_version: typing.Optional[int] = Nonegenerate_script_on_terminal: typing.Optional[bool] = Nonerun_sequentially: typing.Optional[bool] = None@@ -47,6 +49,7 @@ class Workflow(UniversalBaseModel):import_error: typing.Optional[str] = Nonecreated_by: typing.Optional[str] = Noneedited_by: typing.Optional[str] = None+ copilot_authored: typing.Optional[bool] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/workflow_create_yaml_request.py b/skyvern/client/types/workflow_create_yaml_request.pyindex 91c2cba64..95e0b042e 100644--- a/skyvern/client/types/workflow_create_yaml_request.py+++ b/skyvern/client/types/workflow_create_yaml_request.py@@ -21,6 +21,7 @@ class WorkflowCreateYamlRequest(UniversalBaseModel):persist_browser_session: typing.Optional[bool] = Nonepin_saved_session_ip: typing.Optional[bool] = Nonebrowser_profile_id: typing.Optional[str] = None+ browser_profile_key: typing.Optional[str] = Nonemodel: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = Noneworkflow_definition: WorkflowDefinitionYamlis_saved_task: typing.Optional[bool] = None@@ -33,6 +34,7 @@ class WorkflowCreateYamlRequest(UniversalBaseModel):ai_fallback: typing.Optional[bool] = Nonecache_key: typing.Optional[str] = Noneadaptive_caching: typing.Optional[bool] = None+ enable_self_healing: typing.Optional[bool] = Nonecode_version: typing.Optional[int] = Nonegenerate_script_on_terminal: typing.Optional[bool] = Nonerun_sequentially: typing.Optional[bool] = Nonediff --git a/skyvern/client/types/workflow_definition_blocks_item.py b/skyvern/client/types/workflow_definition_blocks_item.pyindex 795384696..e0d034a5b 100644--- a/skyvern/client/types/workflow_definition_blocks_item.py+++ b/skyvern/client/types/workflow_definition_blocks_item.py@@ -14,6 +14,9 @@ from .ai_fallback_mode import AiFallbackModefrom .aws_secret_parameter import AwsSecretParameterfrom .branch_condition import BranchConditionfrom .code_block_parameters_item import CodeBlockParametersItem+from .code_block_step import CodeBlockStep+from .email_inbox_block_email_client import EmailInboxBlockEmailClient+from .email_inbox_block_parameters_item import EmailInboxBlockParametersItemfrom .extraction_block_data_schema import ExtractionBlockDataSchemafrom .extraction_block_parameters_item import ExtractionBlockParametersItemfrom .file_download_block_data_schema import FileDownloadBlockDataSchema@@ -33,8 +36,11 @@ from .login_block_parameters_item import LoginBlockParametersItemfrom .navigation_block_data_schema import NavigationBlockDataSchemafrom .navigation_block_parameters_item import NavigationBlockParametersItemfrom .output_parameter import OutputParameter+from .pdf_fill_block_parameters_item import PdfFillBlockParametersItem+from .pdf_fill_block_payload import PdfFillBlockPayloadfrom .print_page_block_parameters_item import PrintPageBlockParametersItemfrom .run_engine import RunEngine+from .split_pdf_block_parameters_item import SplitPdfBlockParametersItemfrom .task_block_data_schema import TaskBlockDataSchemafrom .task_block_parameters_item import TaskBlockParametersItemfrom .text_prompt_block_parameters_item import TextPromptBlockParametersItem@@ -103,6 +109,8 @@ class WorkflowDefinitionBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameters: typing.Optional[typing.List[CodeBlockParametersItem]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStep]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -158,6 +166,37 @@ class WorkflowDefinitionBlocksItem_DownloadToS3(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameters: typing.Optional[typing.List[EmailInboxBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionBlocksItem_Extraction(UniversalBaseModel):block_type: typing.Literal["extraction"] = "extraction"label: str@@ -262,7 +301,17 @@ class WorkflowDefinitionBlocksItem_FileUpload(UniversalBaseModel):azure_blob_container_name: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = None+ continue_on_empty: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -445,6 +494,7 @@ class WorkflowDefinitionBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameters: typing.Optional[typing.List[HttpRequestBlockParametersItem]] = Noneif IS_PYDANTIC_V2:@@ -592,6 +642,32 @@ class WorkflowDefinitionBlocksItem_Navigation(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockPayload] = None+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[PdfFillBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionBlocksItem_PdfParser(UniversalBaseModel):block_type: typing.Literal["pdf_parser"] = "pdf_parser"label: str@@ -672,6 +748,31 @@ class WorkflowDefinitionBlocksItem_SendEmail(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ output_parameter: OutputParameter+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ disable_cache: typing.Optional[bool] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameters: typing.Optional[typing.List[SplitPdfBlockParametersItem]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionBlocksItem_Task(UniversalBaseModel):block_type: typing.Literal["task"] = "task"label: str@@ -819,6 +920,7 @@ class WorkflowDefinitionBlocksItem_Validation(UniversalBaseModel):include_action_history_in_verification: typing.Optional[bool] = Nonedownload_timeout: typing.Optional[float] = Noneinclude_extracted_text: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -915,6 +1017,7 @@ WorkflowDefinitionBlocksItem = typing.Union[WorkflowDefinitionBlocksItem_Code,WorkflowDefinitionBlocksItem_Conditional,WorkflowDefinitionBlocksItem_DownloadToS3,+ WorkflowDefinitionBlocksItem_EmailInbox,WorkflowDefinitionBlocksItem_Extraction,WorkflowDefinitionBlocksItem_FileDownload,WorkflowDefinitionBlocksItem_FileUpload,@@ -927,9 +1030,11 @@ WorkflowDefinitionBlocksItem = typing.Union[WorkflowDefinitionBlocksItem_HumanInteraction,WorkflowDefinitionBlocksItem_Login,WorkflowDefinitionBlocksItem_Navigation,+ WorkflowDefinitionBlocksItem_PdfFill,WorkflowDefinitionBlocksItem_PdfParser,WorkflowDefinitionBlocksItem_PrintPage,WorkflowDefinitionBlocksItem_SendEmail,+ WorkflowDefinitionBlocksItem_SplitPdf,WorkflowDefinitionBlocksItem_Task,WorkflowDefinitionBlocksItem_TaskV2,WorkflowDefinitionBlocksItem_TextPrompt,@@ -941,6 +1046,7 @@ WorkflowDefinitionBlocksItem = typing.Union[]update_forward_refs(WorkflowDefinitionBlocksItem_Action)update_forward_refs(WorkflowDefinitionBlocksItem_Code)+update_forward_refs(WorkflowDefinitionBlocksItem_EmailInbox)update_forward_refs(WorkflowDefinitionBlocksItem_Extraction)update_forward_refs(WorkflowDefinitionBlocksItem_FileDownload)update_forward_refs(WorkflowDefinitionBlocksItem_ForLoop)@@ -951,7 +1057,9 @@ update_forward_refs(WorkflowDefinitionBlocksItem_HttpRequest)update_forward_refs(WorkflowDefinitionBlocksItem_HumanInteraction)update_forward_refs(WorkflowDefinitionBlocksItem_Login)update_forward_refs(WorkflowDefinitionBlocksItem_Navigation)+update_forward_refs(WorkflowDefinitionBlocksItem_PdfFill)update_forward_refs(WorkflowDefinitionBlocksItem_PrintPage)+update_forward_refs(WorkflowDefinitionBlocksItem_SplitPdf)update_forward_refs(WorkflowDefinitionBlocksItem_Task)update_forward_refs(WorkflowDefinitionBlocksItem_TextPrompt)update_forward_refs(WorkflowDefinitionBlocksItem_Validation)diff --git a/skyvern/client/types/workflow_definition_parameters_item.py b/skyvern/client/types/workflow_definition_parameters_item.pyindex a2cf40f66..527152aca 100644--- a/skyvern/client/types/workflow_definition_parameters_item.py+++ b/skyvern/client/types/workflow_definition_parameters_item.py@@ -183,6 +183,8 @@ class WorkflowDefinitionParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/client/types/workflow_definition_yaml_blocks_item.py b/skyvern/client/types/workflow_definition_yaml_blocks_item.pyindex 19a3b6065..0bb983812 100644--- a/skyvern/client/types/workflow_definition_yaml_blocks_item.py+++ b/skyvern/client/types/workflow_definition_yaml_blocks_item.py@@ -11,11 +11,14 @@ from ..core.serialization import FieldMetadatafrom .ai_fallback_mode import AiFallbackModefrom .branch_condition_yaml import BranchConditionYamlfrom .branch_criteria_yaml import BranchCriteriaYaml+from .code_block_step_yaml import CodeBlockStepYaml+from .email_inbox_block_yaml_email_client import EmailInboxBlockYamlEmailClientfrom .extraction_block_yaml_data_schema import ExtractionBlockYamlDataSchemafrom .file_storage_type import FileStorageTypefrom .file_type import FileTypefrom .for_loop_block_yaml_data_schema import ForLoopBlockYamlDataSchemafrom .google_sheets_write_block_yaml_write_mode import GoogleSheetsWriteBlockYamlWriteMode+from .pdf_fill_block_yaml_payload import PdfFillBlockYamlPayloadfrom .pdf_format import PdfFormatfrom .run_engine import RunEnginefrom .task_block_yaml_data_schema import TaskBlockYamlDataSchema@@ -64,6 +67,8 @@ class WorkflowDefinitionYamlBlocksItem_Code(UniversalBaseModel):next_loop_on_failure: typing.Optional[bool] = Nonecode: strparameter_keys: typing.Optional[typing.List[str]] = None+ prompt: typing.Optional[str] = None+ steps: typing.Optional[typing.List[CodeBlockStepYaml]] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -115,6 +120,35 @@ class WorkflowDefinitionYamlBlocksItem_DownloadToS3(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionYamlBlocksItem_EmailInbox(UniversalBaseModel):+ block_type: typing.Literal["email_inbox"] = "email_inbox"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ email_client: EmailInboxBlockYamlEmailClient+ credential_id: typing.Optional[str] = None+ folder: typing.Optional[str] = None+ prompt: typing.Optional[str] = None+ sender: typing.Optional[str] = None+ subject: typing.Optional[str] = None+ newer_than_days: typing.Optional[int] = None+ max_results: typing.Optional[int] = None+ include_body: typing.Optional[bool] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionYamlBlocksItem_Extraction(UniversalBaseModel):block_type: typing.Literal["extraction"] = "extraction"label: str@@ -194,6 +228,15 @@ class WorkflowDefinitionYamlBlocksItem_FileUpload(UniversalBaseModel):azure_folder_path: typing.Optional[str] = Nonegoogle_credential_id: typing.Optional[str] = Nonegoogle_drive_folder_id: typing.Optional[str] = None+ sftp_host: typing.Optional[str] = None+ sftp_port: typing.Optional[int] = None+ sftp_username: typing.Optional[str] = None+ sftp_password: typing.Optional[str] = None+ sftp_private_key: typing.Optional[str] = None+ sftp_private_key_passphrase: typing.Optional[str] = None+ sftp_remote_path: typing.Optional[str] = None+ sftp_host_key: typing.Optional[str] = None+ prompt: typing.Optional[str] = Nonepath: typing.Optional[str] = Noneif IS_PYDANTIC_V2:@@ -345,6 +388,7 @@ class WorkflowDefinitionYamlBlocksItem_HttpRequest(UniversalBaseModel):follow_redirects: typing.Optional[bool] = Nonedownload_filename: typing.Optional[str] = Nonesave_response_as_file: typing.Optional[bool] = None+ secret_response_paths: typing.Optional[typing.List[str]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Noneif IS_PYDANTIC_V2:@@ -454,6 +498,30 @@ class WorkflowDefinitionYamlBlocksItem_Navigation(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionYamlBlocksItem_PdfFill(UniversalBaseModel):+ block_type: typing.Literal["pdf_fill"] = "pdf_fill"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ payload: typing.Optional[PdfFillBlockYamlPayload] = None+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionYamlBlocksItem_PdfParser(UniversalBaseModel):block_type: typing.Literal["pdf_parser"] = "pdf_parser"label: str@@ -528,6 +596,29 @@ class WorkflowDefinitionYamlBlocksItem_SendEmail(UniversalBaseModel):extra = pydantic.Extra.allow+class WorkflowDefinitionYamlBlocksItem_SplitPdf(UniversalBaseModel):+ block_type: typing.Literal["split_pdf"] = "split_pdf"+ label: str+ next_block_label: typing.Optional[str] = None+ continue_on_failure: typing.Optional[bool] = None+ model: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None+ ignore_workflow_system_prompt: typing.Optional[bool] = None+ next_loop_on_failure: typing.Optional[bool] = None+ file_url: str+ prompt: str+ llm_key: typing.Optional[str] = None+ parameter_keys: typing.Optional[typing.List[str]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2+ else:++ class Config:+ frozen = True+ smart_union = True+ extra = pydantic.Extra.allow++class WorkflowDefinitionYamlBlocksItem_Task(UniversalBaseModel):block_type: typing.Literal["task"] = "task"label: str@@ -648,6 +739,7 @@ class WorkflowDefinitionYamlBlocksItem_Validation(UniversalBaseModel):error_code_mapping: typing.Optional[typing.Dict[str, typing.Optional[str]]] = Noneparameter_keys: typing.Optional[typing.List[str]] = Nonedisable_cache: typing.Optional[bool] = None+ without_page_information: typing.Optional[bool] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2@@ -735,6 +827,7 @@ WorkflowDefinitionYamlBlocksItem = typing.Union[WorkflowDefinitionYamlBlocksItem_Code,WorkflowDefinitionYamlBlocksItem_Conditional,WorkflowDefinitionYamlBlocksItem_DownloadToS3,+ WorkflowDefinitionYamlBlocksItem_EmailInbox,WorkflowDefinitionYamlBlocksItem_Extraction,WorkflowDefinitionYamlBlocksItem_FileDownload,WorkflowDefinitionYamlBlocksItem_FileUpload,@@ -747,9 +840,11 @@ WorkflowDefinitionYamlBlocksItem = typing.Union[WorkflowDefinitionYamlBlocksItem_HumanInteraction,WorkflowDefinitionYamlBlocksItem_Login,WorkflowDefinitionYamlBlocksItem_Navigation,+ WorkflowDefinitionYamlBlocksItem_PdfFill,WorkflowDefinitionYamlBlocksItem_PdfParser,WorkflowDefinitionYamlBlocksItem_PrintPage,WorkflowDefinitionYamlBlocksItem_SendEmail,+ WorkflowDefinitionYamlBlocksItem_SplitPdf,WorkflowDefinitionYamlBlocksItem_Task,WorkflowDefinitionYamlBlocksItem_TaskV2,WorkflowDefinitionYamlBlocksItem_TextPrompt,diff --git a/skyvern/client/types/workflow_definition_yaml_parameters_item.py b/skyvern/client/types/workflow_definition_yaml_parameters_item.pyindex 35603ba6d..2363b0275 100644--- a/skyvern/client/types/workflow_definition_yaml_parameters_item.py+++ b/skyvern/client/types/workflow_definition_yaml_parameters_item.py@@ -128,6 +128,8 @@ class WorkflowDefinitionYamlParametersItem_Credential(UniversalBaseModel):key: strdescription: typing.Optional[str] = Nonecredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/workflow_run_block.py b/skyvern/client/types/workflow_run_block.pyindex 22d32371b..efeeb32d6 100644--- a/skyvern/client/types/workflow_run_block.py+++ b/skyvern/client/types/workflow_run_block.py@@ -50,6 +50,7 @@ class WorkflowRunBlock(UniversalBaseModel):attachments: typing.Optional[typing.List[str]] = Nonesubject: typing.Optional[str] = Nonebody: typing.Optional[str] = None+ prompt: typing.Optional[str] = Noneinstructions: typing.Optional[str] = Nonepositive_descriptor: typing.Optional[str] = Nonenegative_descriptor: typing.Optional[str] = None@@ -58,6 +59,7 @@ class WorkflowRunBlock(UniversalBaseModel):executed_branch_result: typing.Optional[bool] = Noneexecuted_branch_next_block: typing.Optional[str] = Nonescript_run: typing.Optional[ScriptRunResponse] = None+ downloaded_file_count: typing.Optional[int] = Noneif IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True) # type: ignore # Pydantic v2diff --git a/skyvern/client/types/workflow_trigger_block_parameters_item.py b/skyvern/client/types/workflow_trigger_block_parameters_item.pyindex 73d1ff539..1eef7f270 100644--- a/skyvern/client/types/workflow_trigger_block_parameters_item.py+++ b/skyvern/client/types/workflow_trigger_block_parameters_item.py@@ -183,6 +183,8 @@ class WorkflowTriggerBlockParametersItem_Credential(UniversalBaseModel):credential_parameter_id: strworkflow_id: strcredential_id: str+ credential_ids: typing.Optional[typing.List[str]] = None+ selection_strategy: typing.Optional[str] = Nonecreated_at: dt.datetimemodified_at: dt.datetimedeleted_at: typing.Optional[dt.datetime] = Nonediff --git a/skyvern/forge/prompts/skyvern/workflow-copilot-request-policy.j2 b/skyvern/forge/prompts/skyvern/workflow-copilot-request-policy.j2index c9dc03f01..d86e489f6 100644--- a/skyvern/forge/prompts/skyvern/workflow-copilot-request-policy.j2+++ b/skyvern/forge/prompts/skyvern/workflow-copilot-request-policy.j2@@ -30,7 +30,7 @@ completion_contract:- Set to null when the user does not provide an explicit completion condition.completion_criteria:-- An array of the END-STATE OUTCOMES that must be true for the user's goal to be done. Each item is {outcome, contingent_on, contingent_antecedent_output_path, deliverable_kind, implicit, method_mandated, level, output_path, expected_output_value, expected_output_shape, requested_output_evidence_source, kind, terminal_action_family, classification_output_key, expected_classification, judgment_predicate, judgment_polarity_when_holds}.+- An array of the END-STATE OUTCOMES that must be true for the user's goal to be done. Each item is {outcome, contingent_on, contingent_antecedent_output_path, deliverable_kind, deliverable_confirmation_criterion_id, implicit, method_mandated, level, output_path, expected_output_value, expected_output_shape, requested_output_evidence_source, kind, terminal_action_family, classification_output_key, expected_classification, judgment_predicate, judgment_polarity_when_holds}.- Each item may additionally carry request_slot_source_id and request_slot_source_quote under the fresh contract described below.- When a criterion represents a request-owned output member, set request_slot_source_id and request_slot_source_quote to the exact source ID and smallest unique exact quote from REQUEST SLOT SOURCES below. The typed request-slot producer owns its final identity, path, plane, and pinability. Do not infer or emit pinability here.- Set request_slot_source_id and request_slot_source_quote to null for criteria that are not request-owned output members. Never invent, normalize, rename, or paraphrase a source quote.@@ -38,6 +38,7 @@ completion_criteria:- contingent_on: null for ordinary criteria. Use a short antecedent string only when this criterion should be graded only if that antecedent happens, for example {"contingent_on": "the provider site blocks online submission", "contingent_antecedent_output_path": "output.blocker", "outcome": "the blocker is reported to the user"}. The antecedent goes in contingent_on; the consequent to grade goes in outcome. Do not encode if/then criteria only in prose.- contingent_antecedent_output_path: null unless the antecedent is represented by a structured run output field. The only valid form is output.<field> (for example output.blocker). Do not emit transcript paths, selectors, regexes, JSONPath, screenshots, nested paths, or prose conditions here.- deliverable_kind: null unless this criterion's requested output is satisfied by execution-owned browser-download registration rather than a user-authored extraction field. The only supported non-null value is "registered_download".+- deliverable_confirmation_criterion_id: null unless this is a plain run-plane outcome whose separate observation may abstain only when the execution-owned registered download is independently confirmed. The only supported non-null value is __copilot_registered_download__downloaded_files_non_empty. Never set it merely because another outcome downloads a file; unrelated required outcomes must still be evidenced independently.- expected_output_value: null unless this criterion requires an exact structured output value the user explicitly provided. Put that value here as data; never hide it in outcome prose. For a goal-judgment field whose expected answer is a boolean (e.g. selected_highest_priority), provide the JSON true or false here.- expected_output_shape: null unless this criterion requires a generated/provider structured output value whose exact value is not known before the run. Use only one of: reference_code, numeric_identifier, date, address, status_label, money_amount, owner_label, goal_judgment_boolean. goal_judgment_boolean declares that the field is an artifact-computed true/false judgment; the typed boolean expected_output_value is the deterministic backstop. Do not use this as a non-empty-value proxy; leave null when the field's shape is not one of those declared types.- judgment_predicate: null unless expected_output_shape=goal_judgment_boolean and requested_output_evidence_source=independent_run_evidence. Use only the closed-vocabulary value login_gate_blocks_target, and only when the requested judgment is whether login gating blocks the target path.diff --git a/skyvern/forge/sdk/copilot/completion_criteria_store.py b/skyvern/forge/sdk/copilot/completion_criteria_store.pyindex 868667018..79b1ab296 100644--- a/skyvern/forge/sdk/copilot/completion_criteria_store.py+++ b/skyvern/forge/sdk/copilot/completion_criteria_store.py@@ -35,6 +35,7 @@ from skyvern.forge.sdk.copilot.request_policy import (_coerce_judgment_truth_condition,_coerce_requested_output_evidence_source,_normalize_contingent_antecedent_output_path,+ _normalize_deliverable_confirmation_criterion_id,_normalize_deliverable_kind,is_defer_authoring_durable_fill_criterion,is_fallback_floor_criterion,@@ -155,6 +156,8 @@ def criteria_to_json(criteria: tuple[CompletionCriterion, ...] | list[Completion"classification_output_key": criterion.classification_output_key,"expected_classification": criterion.expected_classification,}+ if criterion.deliverable_confirmation_criterion_id is not None:+ item["deliverable_confirmation_criterion_id"] = criterion.deliverable_confirmation_criterion_idif criterion.requested_output_corroborator:item["requested_output_corroborator"] = Trueif criterion.requested_output_path_mint_source is not None:@@ -251,17 +254,32 @@ def criteria_from_json(raw: Any) -> tuple[CompletionCriterion, ...]:requested_output_evidence_source = "runtime_output"elif isinstance(stored_expected_output_value, bool) or stored_expected_output_shape == "goal_judgment_boolean":requested_output_evidence_source = "independent_run_evidence"+ stored_level = level if isinstance(level, str) and level in _CRITERION_LEVELS else "run"+ stored_method_mandated = bool(item.get("method_mandated"))+ stored_deliverable_kind = _normalize_deliverable_kind(item.get("deliverable_kind"))+ deliverable_confirmation_criterion_id = _normalize_deliverable_confirmation_criterion_id(+ item.get("deliverable_confirmation_criterion_id")+ )+ if (+ stored_level != "run"+ or kind != "outcome"+ or stored_output_path is not None+ or stored_deliverable_kind is not None+ or stored_method_mandated+ ):+ deliverable_confirmation_criterion_id = Nonecriteria.append(CompletionCriterion(id=criterion_id,outcome=outcome,contingent_on=contingent_on,contingent_antecedent_output_path=contingent_antecedent_output_path,- deliverable_kind=_normalize_deliverable_kind(item.get("deliverable_kind")),+ deliverable_kind=stored_deliverable_kind,+ deliverable_confirmation_criterion_id=deliverable_confirmation_criterion_id,declared_deliverable_kind=_normalize_deliverable_kind(item.get("declared_deliverable_kind")),implicit=bool(item.get("implicit")),- method_mandated=bool(item.get("method_mandated")),- level=level if isinstance(level, str) and level in _CRITERION_LEVELS else "run", # type: ignore[arg-type]+ method_mandated=stored_method_mandated,+ level=stored_level, # type: ignore[arg-type]output_path=stored_output_path,expected_output_value=stored_expected_output_value,expected_output_shape=stored_expected_output_shape,@@ -291,6 +309,7 @@ def _criterion_reconcile_key(criterion: CompletionCriterion) -> str:contingent_path_key = criterion.contingent_antecedent_output_path or ""deliverable_kind_key = (f"{criterion.deliverable_kind or ''}\x1fdeclared:{criterion.declared_deliverable_kind or ''}"+ f"\x1fconfirmation:{criterion.deliverable_confirmation_criterion_id or ''}"f"\x1fjudgment:{judgment_truth_condition_key(criterion.judgment_truth_condition)}")expected_output_value_key = typed_expected_output_value_key(criterion.expected_output_value)diff --git a/skyvern/forge/sdk/copilot/completion_verification.py b/skyvern/forge/sdk/copilot/completion_verification.pyindex f2bd44476..6757ee855 100644--- a/skyvern/forge/sdk/copilot/completion_verification.py+++ b/skyvern/forge/sdk/copilot/completion_verification.py@@ -24,7 +24,11 @@ from skyvern.config import settingsfrom skyvern.forge.prompts import prompt_enginefrom skyvern.forge.sdk.copilot.output_utils import parse_final_responsefrom skyvern.forge.sdk.copilot.request_policy import (+ REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,CompletionCriterion,+ CriterionKind,+ CriterionLevel,+ RequestedOutputPathMintSource,TerminalActionFamily,is_contingent_missing_antecedent_degraded,is_fallback_floor_base_criterion,@@ -47,7 +51,6 @@ _STRUCTURAL_ABSTENTION_REASON_CODE = "structurally_abstained"_CONTINGENT_ABSTENTION_REASON_CODES = frozenset({"unknown", "no_evidence", "evidence_contradicts", "missing_exact_field", "unproducible"})-REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID = "__copilot_registered_download__downloaded_files_non_empty"TERMINAL_RECORD_CORROBORATION_CRITERION_ID = "__copilot_terminal_record_corroboration__"_REGISTERED_DOWNLOAD_COUNT_KEYS = ("downloaded_file_count",@@ -81,6 +84,12 @@ EvidenceSourceKind = Literal["terminal_record","registered_output_parameter","registered_artifact_content",+ "registered_download",+]+AuthoritativeDeliverableSource = Literal[+ "independent_page_evidence",+ "registered_artifact_content",+ "registered_download",]@@ -104,6 +113,13 @@ class CriterionVerdict:return self.state == "satisfied"+@dataclass(frozen=True)+class PlainOutcomeNoEvidenceAbstentionDecision:+ criterion_ids: tuple[str, ...]+ confirming_deliverable_criterion_ids: tuple[str, ...]+ confirming_deliverable_sources: tuple[AuthoritativeDeliverableSource, ...]++@dataclass(frozen=True)class CompletionVerificationResult:status: VerificationStatus@@ -120,11 +136,19 @@ class CompletionVerificationResult:floor_rekeyed_backed_by_criterion_id: dict[str, bool] = field(default_factory=dict)contingent_degraded_criterion_ids: list[str] = field(default_factory=list)requested_output_criteria_count: int = 0+ criterion_level_by_id: dict[str, CriterionLevel] = field(default_factory=dict)+ criterion_kind_by_id: dict[str, CriterionKind] = field(default_factory=dict)+ criterion_output_path_by_id: dict[str, str] = field(default_factory=dict)+ criterion_deliverable_kind_by_id: dict[str, Literal["registered_download"]] = field(default_factory=dict)+ criterion_requested_output_mint_source_by_id: dict[str, RequestedOutputPathMintSource] = field(default_factory=dict)+ deliverable_confirmation_criterion_id_by_id: dict[str, str] = field(default_factory=dict)def is_fully_satisfied(self) -> bool:if self.status != "evaluated" or not self.criterion_ids:return Falseverdict_by_id = {verdict.criterion_id: verdict for verdict in self.verdicts}+ plain_outcome_decision = plain_outcome_no_evidence_abstention_decision(self, verdict_by_id)+ plain_outcome_abstained_ids = set(plain_outcome_decision.criterion_ids) if plain_outcome_decision else set()has_observed_reach_state = any(_is_satisfied_observed_end_state_verdict(verdict) for verdict in verdict_by_id.values())@@ -154,7 +178,7 @@ class CompletionVerificationResult:return False# A structurally-unfired contingent criterion is N/A for this run: it neither vetoes nor# earns credit, so success must derive from the remaining genuinely-satisfied criteria.- if criterion_id in abstained_id_set:+ if criterion_id in abstained_id_set or criterion_id in plain_outcome_abstained_ids:continue# A definition-plane ``unknown`` is a YAML-grader abstention, not a refutation,# so it must not veto a run whose observable outcome evidence is fully confirmed.@@ -195,11 +219,8 @@ class CompletionVerificationResult:return _is_contingent_abstention(verdict, self.abstained_criterion_ids())def to_trace_data(self) -> dict[str, Any]:- unmet = [- verdict- for verdict in self.verdicts- if not verdict.satisfied and not self.is_structural_contingent_abstention(verdict)- ]+ plain_outcome_decision = plain_outcome_no_evidence_abstention_decision(self)+ unmet = effective_unmet_verdicts(self, plain_outcome_decision=plain_outcome_decision)missing_evidence: list[str] = []for verdict in unmet:detail = verdict_missing_evidence(verdict)@@ -218,6 +239,30 @@ class CompletionVerificationResult:"unmet_criterion_ids": [verdict.criterion_id for verdict in unmet],"missing_evidence": missing_evidence,}+ if plain_outcome_decision is not None:+ data.update(+ {+ "plain_outcome_no_evidence_abstention_engaged": True,+ "plain_outcome_no_evidence_abstention_abstained_criterion_ids": list(+ plain_outcome_decision.criterion_ids+ ),+ "plain_outcome_no_evidence_abstention_confirming_deliverable_criterion_ids": list(+ plain_outcome_decision.confirming_deliverable_criterion_ids+ ),+ "plain_outcome_no_evidence_abstention_confirming_deliverable_sources": list(+ plain_outcome_decision.confirming_deliverable_sources+ ),+ "plain_outcome_no_evidence_abstention_criterion_plane": "run",+ "plain_outcome_no_evidence_abstention_criterion_kind": "outcome",+ "plain_outcome_no_evidence_abstention_reason_code": "no_evidence",+ "plain_outcome_no_evidence_abstention_confirmed_independent_deliverable": True,+ "plain_outcome_no_evidence_abstention_confirming_deliverable_mint_sources": [+ self.criterion_requested_output_mint_source_by_id[criterion_id]+ for criterion_id in plain_outcome_decision.confirming_deliverable_criterion_ids+ if criterion_id in self.criterion_requested_output_mint_source_by_id+ ],+ }+ )if self.contingent_criterion_ids:data["contingent_criterion_ids"] = list(self.contingent_criterion_ids)if self.structural_unfired_criterion_ids:@@ -226,6 +271,7 @@ class CompletionVerificationResult:data["contingent_degraded_criterion_ids"] = list(self.contingent_degraded_criterion_ids)contingent_id_set = set(self.contingent_criterion_ids)structural_unfired_id_set = set(self.structural_unfired_criterion_ids)+ plain_outcome_abstained_id_set = set(plain_outcome_decision.criterion_ids) if plain_outcome_decision else set()for index, verdict in enumerate(self.verdicts[:_MAX_TRACE_VERDICTS]):prefix = f"verdict_{index}"data[f"{prefix}_criterion_id"] = verdict.criterion_id@@ -262,7 +308,12 @@ class CompletionVerificationResult:evidence_ref = _clean_optional_text(verdict.evidence_ref, max_chars=_EVIDENCE_REF_MAX_CHARS)if evidence_ref:data[f"{prefix}_evidence_ref"] = evidence_ref- detail = None if self.is_structural_contingent_abstention(verdict) else verdict_missing_evidence(verdict)+ detail = (+ None+ if self.is_structural_contingent_abstention(verdict)+ or verdict.criterion_id in plain_outcome_abstained_id_set+ else verdict_missing_evidence(verdict)+ )if detail:data[f"{prefix}_missing_evidence"] = detailreturn data@@ -400,6 +451,7 @@ def grade_registered_download_criteria(state="satisfied",reason_code="evidence_confirms",evidence_ref=f"block_outputs:{label}",+ evidence_source="registered_download",)for criterion in registered_criteria]@@ -449,9 +501,11 @@ def _missing_verdict(criterion_id: str) -> CriterionVerdict:def summarize_unsatisfied_outcomes(result: CompletionVerificationResult, criteria: list[CompletionCriterion]) -> str:outcome_by_id = {criterion.id: criterion.outcome for criterion in criteria}- satisfied = {verdict.criterion_id for verdict in result.verdicts if verdict.satisfied}- unmet = [outcome_by_id[cid] for cid in result.criterion_ids if cid not in satisfied and cid in outcome_by_id]- return "; ".join(unmet)+ return "; ".join(+ outcome_by_id[verdict.criterion_id]+ for verdict in effective_unmet_verdicts(result)+ if verdict.criterion_id in outcome_by_id+ )def _render_criteria(criteria: list[CompletionCriterion]) -> str:@@ -2029,6 +2083,103 @@ def _is_reperception_contradiction(verdict: CriterionVerdict) -> bool:)+def plain_outcome_no_evidence_abstention_decision(+ result: CompletionVerificationResult,+ verdict_by_id: Mapping[str, CriterionVerdict] | None = None,+) -> PlainOutcomeNoEvidenceAbstentionDecision | None:+ if result.status != "evaluated" or not result.criterion_ids:+ return None+ verdict_by_id = verdict_by_id or {verdict.criterion_id: verdict for verdict in result.verdicts}+ active_ids = set(result.criterion_ids)+ has_observed_reach_state = any(+ _is_satisfied_observed_end_state_verdict(verdict)+ for criterion_id, verdict in verdict_by_id.items()+ if criterion_id in active_ids+ )+ if any(+ verdict.state == "unsatisfied"+ and verdict.reason_code == "evidence_contradicts"+ and not result.is_structural_contingent_abstention(verdict)+ and not (has_observed_reach_state and _is_reperception_contradiction(verdict))+ for criterion_id, verdict in verdict_by_id.items()+ if criterion_id in active_ids+ ):+ return None++ confirming_ids: list[str] = []+ confirming_sources: list[AuthoritativeDeliverableSource] = []+ for criterion_id in result.criterion_ids:+ verdict = verdict_by_id.get(criterion_id)+ if (+ verdict is None+ or not verdict.satisfied+ or verdict.reason_code != "evidence_confirms"+ or result.criterion_level_by_id.get(criterion_id) != "run"+ ):+ continue+ source: AuthoritativeDeliverableSource | None = None+ if (+ criterion_id == REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID+ and verdict.evidence_source == "registered_download"+ and criterion_id in result.criterion_requested_output_mint_source_by_id+ ):+ source = "registered_download"+ elif criterion_id in result.criterion_output_path_by_id:+ if verdict.evidence_source == "independent_page_evidence":+ source = "independent_page_evidence"+ elif verdict.evidence_source == "registered_artifact_content":+ source = "registered_artifact_content"+ if source is not None:+ confirming_ids.append(criterion_id)+ confirming_sources.append(source)+ if not confirming_ids:+ return None++ degraded_ids = degraded_lane_criterion_ids(result)+ floor_rekeyed_ids = set(result.floor_rekeyed_criterion_ids)+ confirmed_ids = set(confirming_ids)+ abstained_ids = tuple(+ criterion_id+ for criterion_id in result.criterion_ids+ if criterion_id != REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID+ and criterion_id not in degraded_ids+ and criterion_id not in floor_rekeyed_ids+ and criterion_id not in result.criterion_output_path_by_id+ and criterion_id not in result.criterion_deliverable_kind_by_id+ and result.deliverable_confirmation_criterion_id_by_id.get(criterion_id) in confirmed_ids+ and result.criterion_level_by_id.get(criterion_id) == "run"+ and result.criterion_kind_by_id.get(criterion_id) == "outcome"+ and (verdict := verdict_by_id.get(criterion_id)) is not None+ and verdict.state == "unsatisfied"+ and verdict.reason_code == "no_evidence"+ )+ if not abstained_ids:+ return None+ return PlainOutcomeNoEvidenceAbstentionDecision(+ criterion_ids=abstained_ids,+ confirming_deliverable_criterion_ids=tuple(confirming_ids),+ confirming_deliverable_sources=tuple(confirming_sources),+ )+++def effective_unmet_verdicts(+ result: CompletionVerificationResult,+ *,+ plain_outcome_decision: PlainOutcomeNoEvidenceAbstentionDecision | None = None,+) -> list[CriterionVerdict]:+ decision = plain_outcome_decision or plain_outcome_no_evidence_abstention_decision(result)+ abstained_ids = set(decision.criterion_ids) if decision else set()+ active_ids = set(result.criterion_ids)+ return [+ verdict+ for verdict in result.verdicts+ if verdict.criterion_id in active_ids+ and not verdict.satisfied+ and not result.is_structural_contingent_abstention(verdict)+ and verdict.criterion_id not in abstained_ids+ ]++def _is_definition_plane_abstention(verdict: CriterionVerdict) -> bool:return verdict.state == "unknown" and verdict.reason_code.startswith(_DEFINITION_REASON_PREFIX)@@ -2236,6 +2387,12 @@ def combine_verification_results(floor_rekeyed_path_by_id: dict[str, str] = {}floor_rekeyed_backed_by_id: dict[str, bool] = {}contingent_degraded_ids: list[str] = []+ criterion_level_by_id: dict[str, CriterionLevel] = {}+ criterion_kind_by_id: dict[str, CriterionKind] = {}+ criterion_output_path_by_id: dict[str, str] = {}+ criterion_deliverable_kind_by_id: dict[str, Literal["registered_download"]] = {}+ criterion_requested_output_mint_source_by_id: dict[str, RequestedOutputPathMintSource] = {}+ deliverable_confirmation_criterion_id_by_id: dict[str, str] = {}if run_result is not None:contingent_ids = list(dict.fromkeys([*contingent_ids, *run_result.contingent_criterion_ids]))contingent_on_by_id.update(run_result.contingent_on_by_criterion_id)@@ -2250,6 +2407,12 @@ def combine_verification_results(contingent_degraded_ids = list(dict.fromkeys([*contingent_degraded_ids, *run_result.contingent_degraded_criterion_ids]))+ criterion_level_by_id.update(run_result.criterion_level_by_id)+ criterion_kind_by_id.update(run_result.criterion_kind_by_id)+ criterion_output_path_by_id.update(run_result.criterion_output_path_by_id)+ criterion_deliverable_kind_by_id.update(run_result.criterion_deliverable_kind_by_id)+ criterion_requested_output_mint_source_by_id.update(run_result.criterion_requested_output_mint_source_by_id)+ deliverable_confirmation_criterion_id_by_id.update(run_result.deliverable_confirmation_criterion_id_by_id)if run_result is not None and run_result.status != "evaluated":return CompletionVerificationResult(status=run_result.status,@@ -2265,6 +2428,12 @@ def combine_verification_results(floor_rekeyed_backed_by_criterion_id=floor_rekeyed_backed_by_id,contingent_degraded_criterion_ids=contingent_degraded_ids,requested_output_criteria_count=requested_output_criteria_count,+ criterion_level_by_id=criterion_level_by_id,+ criterion_kind_by_id=criterion_kind_by_id,+ criterion_output_path_by_id=criterion_output_path_by_id,+ criterion_deliverable_kind_by_id=criterion_deliverable_kind_by_id,+ criterion_requested_output_mint_source_by_id=criterion_requested_output_mint_source_by_id,+ deliverable_confirmation_criterion_id_by_id=deliverable_confirmation_criterion_id_by_id,)if run_result is not None:run_result = replace(@@ -2298,6 +2467,12 @@ def combine_verification_results(floor_rekeyed_output_path_by_criterion_id=floor_rekeyed_path_by_id,contingent_degraded_criterion_ids=contingent_degraded_ids,requested_output_criteria_count=requested_output_criteria_count,+ criterion_level_by_id=criterion_level_by_id,+ criterion_kind_by_id=criterion_kind_by_id,+ criterion_output_path_by_id=criterion_output_path_by_id,+ criterion_deliverable_kind_by_id=criterion_deliverable_kind_by_id,+ criterion_requested_output_mint_source_by_id=criterion_requested_output_mint_source_by_id,+ deliverable_confirmation_criterion_id_by_id=deliverable_confirmation_criterion_id_by_id,)@@ -2316,6 +2491,8 @@ def only_degraded_blocking(result: CompletionVerificationResult) -> bool:if not degraded:return Falseverdict_by_id = {verdict.criterion_id: verdict for verdict in result.verdicts}+ decision = plain_outcome_no_evidence_abstention_decision(result, verdict_by_id)+ plain_outcome_abstained_ids = set(decision.criterion_ids) if decision else set()blocking: set[str] = set()for criterion_id in result.criterion_ids:verdict = verdict_by_id.get(criterion_id)@@ -2327,6 +2504,8 @@ def only_degraded_blocking(result: CompletionVerificationResult) -> bool:continueif verdict is not None and result.is_structural_contingent_abstention(verdict):continue+ if criterion_id in plain_outcome_abstained_ids:+ continueblocking.add(criterion_id)if not blocking:return False@@ -2380,6 +2559,8 @@ def degraded_contract_delivered_unverified_terminal_state(if not degraded:return Noneverdict_by_id = {verdict.criterion_id: verdict for verdict in result.verdicts}+ decision = plain_outcome_no_evidence_abstention_decision(result, verdict_by_id)+ plain_outcome_abstained_ids = set(decision.criterion_ids) if decision else set()observed: list[CriterionVerdict] = []blocking: set[str] = set()for criterion_id in result.criterion_ids:@@ -2391,6 +2572,8 @@ def degraded_contract_delivered_unverified_terminal_state(continueif verdict is not None and result.is_structural_contingent_abstention(verdict):continue+ if criterion_id in plain_outcome_abstained_ids:+ continueblocking.add(criterion_id)if not observed or not blocking or not blocking <= degraded:return None@@ -2472,6 +2655,55 @@ def gradeable_completion_criteria(criteria: Iterable[CompletionCriterion]) -> li]+def carry_criterion_metadata(+ result: CompletionVerificationResult,+ criteria: Iterable[CompletionCriterion],+) -> CompletionVerificationResult:+ active_ids = set(result.criterion_ids)+ active_criteria = [criterion for criterion in criteria if criterion.id in active_ids]+ level_by_id = dict(result.criterion_level_by_id)+ level_by_id.update({criterion.id: criterion.level for criterion in active_criteria})+ kind_by_id = dict(result.criterion_kind_by_id)+ kind_by_id.update({criterion.id: criterion.kind for criterion in active_criteria})+ output_path_by_id = dict(result.criterion_output_path_by_id)+ output_path_by_id.update(+ {criterion.id: criterion.output_path for criterion in active_criteria if criterion.output_path is not None}+ )+ deliverable_kind_by_id = dict(result.criterion_deliverable_kind_by_id)+ deliverable_kind_by_id.update(+ {+ criterion.id: criterion.deliverable_kind+ for criterion in active_criteria+ if criterion.deliverable_kind is not None+ }+ )+ requested_output_mint_source_by_id = dict(result.criterion_requested_output_mint_source_by_id)+ requested_output_mint_source_by_id.update(+ {+ criterion.id: criterion.requested_output_path_mint_source+ for criterion in active_criteria+ if criterion.requested_output_path_mint_source is not None+ }+ )+ deliverable_confirmation_by_id = dict(result.deliverable_confirmation_criterion_id_by_id)+ deliverable_confirmation_by_id.update(+ {+ criterion.id: criterion.deliverable_confirmation_criterion_id+ for criterion in active_criteria+ if criterion.deliverable_confirmation_criterion_id is not None+ }+ )+ return replace(+ result,+ criterion_level_by_id=level_by_id,+ criterion_kind_by_id=kind_by_id,+ criterion_output_path_by_id=output_path_by_id,+ criterion_deliverable_kind_by_id=deliverable_kind_by_id,+ criterion_requested_output_mint_source_by_id=requested_output_mint_source_by_id,+ deliverable_confirmation_criterion_id_by_id=deliverable_confirmation_by_id,+ )++def carry_degraded_criterion_ids(result: CompletionVerificationResult,criteria: Iterable[CompletionCriterion],diff --git a/skyvern/forge/sdk/copilot/outcome_verification_trace.py b/skyvern/forge/sdk/copilot/outcome_verification_trace.pyindex 8801eb177..b2db409e4 100644--- a/skyvern/forge/sdk/copilot/outcome_verification_trace.py+++ b/skyvern/forge/sdk/copilot/outcome_verification_trace.py@@ -19,6 +19,8 @@ LOG = structlog.get_logger()_SNAPSHOT_ATTR = "outcome_verification_trace_snapshot"_COMPLETION_PREFIX = "completion_verification_"+_ABSTENTION_PREFIX = "plain_outcome_no_evidence_abstention_"+_ABSTENTION_LOG_EVENT = "copilot.completion.plain_outcome_no_evidence_abstention"_CODE_ARTIFACT_VIOLATIONS_KEY = "copilot.code_artifact_violations"_CODE_ARTIFACT_VIOLATION_LABELS_KEY = "copilot.code_artifact_violation_block_labels"_CODE_ARTIFACT_VIOLATION_COUNT_KEY = "copilot.code_artifact_violation_count"@@ -76,20 +78,32 @@ def record_code_artifact_violations(ctx: Any, violations: list[str], offending_lLOG.warning("failed to record copilot code artifact violation telemetry", exc_info=True)-def record_completion_verification(ctx: Any, result: Any | None) -> None:+def record_completion_verification(ctx: Any, result: Any | None, workflow_run_id: str | None = None) -> None:"""Refresh the snapshot's completion-verification block for the latest run.Called on every recorded run, evaluated or not, so the snapshot describes theturn's most recent run and never preserves a stale verdict from an earlier one."""try:+ trace_data: dict[str, Any] | None = None+ if result is not None and getattr(result, "status", None) == "evaluated":+ trace_data = result.to_trace_data()+ # Span attributes are refreshed by later runs in the same turn, so the+ # abstention fingerprint is also emitted as a durable log line.+ if trace_data.get(f"{_ABSTENTION_PREFIX}engaged") is True:+ LOG.info(+ _ABSTENTION_LOG_EVENT,+ workflow_run_id=workflow_run_id,+ fully_satisfied=trace_data.get("fully_satisfied"),+ **{key: value for key, value in trace_data.items() if key.startswith(_ABSTENTION_PREFIX)},+ )snapshot = _snapshot(ctx)if snapshot is None:returnfor key in [key for key in snapshot if key.startswith(_COMPLETION_PREFIX)]:del snapshot[key]- if result is not None and getattr(result, "status", None) == "evaluated":- snapshot.update({f"{_COMPLETION_PREFIX}{key}": value for key, value in result.to_trace_data().items()})+ if trace_data is not None:+ snapshot.update({f"{_COMPLETION_PREFIX}{key}": value for key, value in trace_data.items()})snapshot[f"{_COMPLETION_PREFIX}evaluated_on_final_run"] = Trueelse:snapshot[f"{_COMPLETION_PREFIX}status"] = getattr(result, "status", None) or "not_run"diff --git a/skyvern/forge/sdk/copilot/reached_download_target.py b/skyvern/forge/sdk/copilot/reached_download_target.pyindex a66fb0927..a7b5eb0e4 100644--- a/skyvern/forge/sdk/copilot/reached_download_target.py+++ b/skyvern/forge/sdk/copilot/reached_download_target.py@@ -58,6 +58,10 @@ REGISTERED_DOWNLOAD_OUTPUT_KEYS: tuple[str, ...] = ("downloaded_file_artifact_ids",)+REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS: frozenset[str] = frozenset(+ f"output.{key}" for key in REGISTERED_DOWNLOAD_OUTPUT_KEYS+)+# The keys whose typed-affordance hints flow through the scout navTargets capture.NAV_TARGET_DOWNLOAD_KIND_KEY = "download_kind"diff --git a/skyvern/forge/sdk/copilot/request_policy.py b/skyvern/forge/sdk/copilot/request_policy.pyindex e57198562..da289ca36 100644--- a/skyvern/forge/sdk/copilot/request_policy.py+++ b/skyvern/forge/sdk/copilot/request_policy.py@@ -17,6 +17,7 @@ from skyvern.forge.sdk.copilot.config import CopilotConfigfrom skyvern.forge.sdk.copilot.context import StructuredContext, sanitize_global_llm_context_for_promptfrom skyvern.forge.sdk.copilot.llm_errors import is_retriable_llm_errorfrom skyvern.forge.sdk.copilot.output_utils import parse_final_response+from skyvern.forge.sdk.copilot.reached_download_target import REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHSfrom skyvern.forge.sdk.copilot.request_slots import (CanonicalRequestSlotV1,RequestSlotContractV1,@@ -69,14 +70,8 @@ _CLASSIFICATION_RESPONSE_FIELDS = {"raw_secret_handling","clarification_reason",}-REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS = frozenset(- {- "output.downloaded_files",- "output.downloaded_file_urls",- "output.downloaded_file_artifact_ids",- }-)_LONE_REGISTERED_DOWNLOAD_OUTPUT_PATH = "output.downloaded_files"+REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID = "__copilot_registered_download__downloaded_files_non_empty"ClarificationReason = Literal["none","raw_secret",@@ -230,7 +225,7 @@ _CRITERION_KINDS: frozenset[str] = frozenset({"outcome", "terminal_action", "val_TERMINAL_ACTION_FAMILIES: frozenset[str] = frozenset({"request", "application", "form", "order"})_EXPECTED_OUTPUT_SHAPES: frozenset[str] = frozenset(get_args(ExpectedOutputShape))_REQUESTED_OUTPUT_EVIDENCE_SOURCES: frozenset[str] = frozenset(get_args(RequestedOutputEvidenceSource))-RequestedOutputPathMintSource = Literal["classifier_default"]+RequestedOutputPathMintSource = Literal["classifier_default", "classifier_declared"]REQUESTED_OUTPUT_PATH_MINT_SOURCES: frozenset[str] = frozenset(get_args(RequestedOutputPathMintSource))_OUTPUT_INTENT_RE = re.compile(@@ -304,6 +299,9 @@ class CompletionCriterion:# Author-time seam signal only: unlike ``deliverable_kind`` it survives canonicalization onto# non-canonical output paths, so it is never rendered to the completion verifier.declared_deliverable_kind: Literal["registered_download"] | None = None+ # Classifier-authored license for the plain-outcome abstention: non-null only when this+ # criterion's separate observation may abstain behind the confirmed canonical download.+ deliverable_confirmation_criterion_id: str | None = Noneimplicit: bool = Falsemethod_mandated: bool = False# "definition": a property of the workflow definition itself, graded against the@@ -1385,11 +1383,43 @@ def _parse_completion_criterion_entries(requested_output_path_mint_source=requested_output_path_mint_source,criterion_id=f"c{len(entries)}",)+ elif (+ output_path is not None+ and expected_output_value is None+ and deliverable_kind == "registered_download"+ and kind != "validation_classification"+ and output_path in REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS+ ):+ requested_output_path_mint_source = "classifier_declared"+ if emit_mint_events:+ LOG.info(+ "copilot_registered_download_requested_output_minted",+ output_path=output_path,+ requested_output_path_mint_source=requested_output_path_mint_source,+ criterion_id=f"c{len(entries)}",+ )+ method_mandated = bool(item.get("method_mandated"))+ level_raw = item.get("level")+ level = (+ cast(CriterionLevel, level_raw) if isinstance(level_raw, str) and level_raw in _CRITERION_LEVELS else "run"+ )+ deliverable_confirmation_criterion_id = _normalize_deliverable_confirmation_criterion_id(+ item.get("deliverable_confirmation_criterion_id")+ )+ if (+ level != "run"+ or kind != "outcome"+ or output_path is not None+ or deliverable_kind is not None+ or method_mandated+ ):+ deliverable_confirmation_criterion_id = Nonekey = (contingent_on or "",contingent_antecedent_output_path or "",output_path or classification_output_key or normalized_criterion_outcome_key(outcome),deliverable_kind or "",+ deliverable_confirmation_criterion_id or "",kind,str(expected_classification) if expected_classification is not None else "",typed_expected_output_value_key(expected_output_value),@@ -1400,7 +1430,6 @@ def _parse_completion_criterion_entries(if key in seen:continueseen.add(key)- level_raw = item.get("level")entries.append((item,@@ -1410,12 +1439,11 @@ def _parse_completion_criterion_entries(contingent_on=contingent_on,contingent_antecedent_output_path=contingent_antecedent_output_path,deliverable_kind=deliverable_kind,+ deliverable_confirmation_criterion_id=deliverable_confirmation_criterion_id,declared_deliverable_kind=deliverable_kind,implicit=bool(item.get("implicit")),- method_mandated=bool(item.get("method_mandated")),- level=cast(CriterionLevel, level_raw)- if isinstance(level_raw, str) and level_raw in _CRITERION_LEVELS- else "run",+ method_mandated=method_mandated,+ level=level,output_path=output_path,expected_output_value=expected_output_value,expected_output_shape=expected_output_shape,@@ -1468,6 +1496,10 @@ def _normalize_deliverable_kind(raw: Any) -> Literal["registered_download"] | Noreturn "registered_download" if raw == "registered_download" else None+def _normalize_deliverable_confirmation_criterion_id(raw: object) -> str | None:+ return REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID if raw == REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID else None++def normalized_criterion_outcome_key(outcome: str) -> str:collapsed = " ".join((outcome or "").split())[:_COMPLETION_CRITERION_OUTCOME_MAX_CHARS]return collapsed.strip().lower().rstrip(".!?;:,").strip()@@ -1862,6 +1894,8 @@ def _generic_completion_criterion(criterion: CompletionCriterion) -> bool:def _criterion_drop_priority(criterion: CompletionCriterion, requested_output_paths: set[str]) -> int:+ if criterion.deliverable_confirmation_criterion_id is not None:+ return 0if criterion.output_path in requested_output_paths:return 0if criterion.requested_output_corroborator:@@ -2241,6 +2275,8 @@ def _render_active_criteria_for_prompt(criteria: list[CompletionCriterion] | Nonitem["contingent_antecedent_output_path"] = criterion.contingent_antecedent_output_pathif criterion.deliverable_kind:item["deliverable_kind"] = criterion.deliverable_kind+ if criterion.deliverable_confirmation_criterion_id:+ item["deliverable_confirmation_criterion_id"] = criterion.deliverable_confirmation_criterion_idif criterion.output_path:item["output_path"] = criterion.output_pathif criterion.expected_output_value is not None:diff --git a/skyvern/forge/sdk/copilot/tools/completion.py b/skyvern/forge/sdk/copilot/tools/completion.pyindex 954b4d7bb..84c3c38a9 100644--- a/skyvern/forge/sdk/copilot/tools/completion.py+++ b/skyvern/forge/sdk/copilot/tools/completion.py@@ -23,10 +23,12 @@ from skyvern.forge.sdk.copilot.completion_verification import (RunEvidenceSnapshot,_contingent_metadata_for_criteria,_is_structural_requested_output_abstention,+ carry_criterion_metadata,carry_degraded_criterion_ids,carry_floor_rekeyed_criterion_ids,carry_floor_rekeyed_path_backing,combine_verification_results,+ effective_unmet_verdicts,evaluate_completion_criteria,grade_definition_criteria,grade_fallback_floor_reached_end_state_criteria,@@ -55,6 +57,7 @@ from skyvern.forge.sdk.copilot.reached_download_target import (DOWNLOAD_KIND_EXTENSION,DOWNLOAD_KIND_REGISTERED,REGISTERED_DOWNLOAD_OUTPUT_KEYS,+ REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS,ReachedDownloadTarget,derive_from_block_outputs,)@@ -97,13 +100,6 @@ _REGISTERED_ARTIFACT_OBSERVATION_LABEL = "registered_artifact_observation"# Stamp keys the same-run gate reads; they are dropped from the graded payload so the run id# and observation flag cannot be traversed as observed page content._POST_RUN_PAGE_EVIDENCE_STAMP_KEYS = frozenset({"workflow_run_id", "observed_after_workflow_run"})-_REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS = frozenset(f"output.{key}" for key in REGISTERED_DOWNLOAD_OUTPUT_KEYS)-_CLASSIFIER_DEFAULT_MINT_SOURCE: RequestedOutputPathMintSource = "classifier_default"-if REQUESTED_OUTPUT_PATH_MINT_SOURCES != {_CLASSIFIER_DEFAULT_MINT_SOURCE}:- raise RuntimeError(- "RequestedOutputPathMintSource gained a member; the reconciled registered-download "- "requested-output identity carry must be revisited before this equality can stay strict."- )_AUTHORED_OUTPUT_CONTRACT_CRITERION_ID_PREFIX = "__copilot_authored_output__"_AUTHORED_OUTPUT_CONTRACT_MISSING_CRITERION_ID = "__copilot_authored_output_contract_missing"_AUTHORED_OUTPUT_CONTRACT_MISSING_PATH = "output.__copilot_missing_authored_output_contract__"@@ -171,25 +167,28 @@ def _result_has_registered_download_block_output(result: dict[str, Any]) -> booldef _registered_download_requested_output_criterion(criterion: CompletionCriterion) -> bool:+ requested_path = criterion.output_path if criterion.output_path is not None else criterion.floor_rekeyed_from_pathreturn (- criterion.output_path is not None+ requested_path is not Noneand criterion.level != "definition"and not criterion.method_mandated- and criterion.output_path in _REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS+ and requested_path in REGISTERED_DOWNLOAD_REQUESTED_OUTPUT_PATHS)def _is_minted_registered_download_requested_output(criterion: CompletionCriterion) -> bool:return (_registered_download_requested_output_criterion(criterion)- and criterion.requested_output_path_mint_source == _CLASSIFIER_DEFAULT_MINT_SOURCE+ and criterion.requested_output_path_mint_source in REQUESTED_OUTPUT_PATH_MINT_SOURCES)-def _registered_download_criterion_carrying_requested_output(*, carries_requested_output: bool) -> CompletionCriterion:+def _registered_download_criterion_carrying_requested_output(+ *, witnessed_mint_source: RequestedOutputPathMintSource | None+) -> CompletionCriterion:criterion = registered_download_completion_criterion()- if carries_requested_output:- return replace(criterion, requested_output_path_mint_source=_CLASSIFIER_DEFAULT_MINT_SOURCE)+ if witnessed_mint_source is not None:+ return replace(criterion, requested_output_path_mint_source=witnessed_mint_source)return criterion@@ -198,7 +197,7 @@ def _minted_registered_download_requested_output_count(criteria: list[Completion1for criterion in criteriaif is_registered_download_completion_criterion(criterion)- and criterion.requested_output_path_mint_source == _CLASSIFIER_DEFAULT_MINT_SOURCE+ and criterion.requested_output_path_mint_source in REQUESTED_OUTPUT_PATH_MINT_SOURCES)@@ -210,13 +209,27 @@ def _has_typed_download_signal(copilot_ctx: Any, result: dict[str, Any]) -> boolreturn _result_has_registered_download_block_output(result)+def _formed_completion_criteria(copilot_ctx: Any) -> list[CompletionCriterion]:+ policy = _completion_request_policy(copilot_ctx)+ return policy.graded_completion_criteria() if policy is not None else []++def _reconcile_download_completion_criterion(copilot_ctx: Any, result: dict[str, Any], criteria: list[CompletionCriterion]) -> list[CompletionCriterion]:has_registered_download_evidence = _result_has_registered_download_block_output(result)- stripped_minted_requested_output = has_registered_download_evidence and any(- _is_minted_registered_download_requested_output(criterion) for criterion in criteria- )+ # The gradeable filter drops degraded minted asks, so the association witness reads the formed+ # criteria; a degraded witness supplies requested-output identity only, never confirmation.+ witnessed_mint_source: RequestedOutputPathMintSource | None = None+ if has_registered_download_evidence:+ witnessed_mint_source = next(+ (+ criterion.requested_output_path_mint_source+ for criterion in [*criteria, *_formed_completion_criteria(copilot_ctx)]+ if _is_minted_registered_download_requested_output(criterion)+ ),+ None,+ )reconciled = ([criterion for criterion in criteria if not _registered_download_requested_output_criterion(criterion)]if has_registered_download_evidence@@ -228,9 +241,7 @@ def _reconcile_download_completion_criterion(return reconciledreturn [*reconciled,- _registered_download_criterion_carrying_requested_output(- carries_requested_output=stripped_minted_requested_output- ),+ _registered_download_criterion_carrying_requested_output(witnessed_mint_source=witnessed_mint_source),]@@ -469,10 +480,13 @@ async def _maybe_run_completion_verification_from_page_observation()if _classifier_status(copilot_ctx) == "fallback" and not run_criteria:verification = _no_gradeable_run_plane_result(criterion_ids)+ verification = carry_criterion_metadata(verification, criteria)verification = _carry_degraded_ids(copilot_ctx, verification)verification = carry_floor_rekeyed_criterion_ids(verification, criteria)copilot_ctx.completion_verification_result = verification- record_completion_verification(copilot_ctx, verification)+ record_completion_verification(+ copilot_ctx, verification, workflow_run_id=copilot_ctx.last_run_blocks_workflow_run_id+ )_record_adjudication_on_turn_state(copilot_ctx, verification)_emit_completion_verification_trace(copilot_ctx, verification)return verification@@ -626,6 +640,7 @@ async def _maybe_run_completion_verification_from_page_observation(requested_output_criteria_count=len(requested_output_criteria),)+ verification = carry_criterion_metadata(verification, criteria)verification = _carry_degraded_ids(copilot_ctx, verification)verification = carry_floor_rekeyed_criterion_ids(verification, criteria)if (@@ -636,7 +651,9 @@ async def _maybe_run_completion_verification_from_page_observation(return existingcopilot_ctx.completion_verification_result = verification- record_completion_verification(copilot_ctx, verification)+ record_completion_verification(+ copilot_ctx, verification, workflow_run_id=copilot_ctx.last_run_blocks_workflow_run_id+ )_record_adjudication_on_turn_state(copilot_ctx, verification)if verification.status == "evaluated":_emit_completion_verification_trace(copilot_ctx, verification)@@ -1365,6 +1382,7 @@ async def _maybe_run_completion_verification(verification = await _completion_verification_from_run_result(copilot_ctx, result, handler_start, criteria)if verification is None:return None+ verification = carry_criterion_metadata(verification, criteria)verification = _carry_degraded_ids(copilot_ctx, verification)verification = carry_floor_rekeyed_criterion_ids(verification, criteria)run_data = result.get("data")@@ -1668,9 +1686,7 @@ def _missing_evidence_detail() -> str | None:outcome_by_id = {criterion.id: criterion.outcome for criterion in criteria}parts: list[str] = []- for verdict in completion_verification.verdicts:- if verdict.satisfied or completion_verification.is_structural_contingent_abstention(verdict):- continue+ for verdict in effective_unmet_verdicts(completion_verification):missing_evidence = verdict_missing_evidence(verdict)if not missing_evidence:continue@@ -1698,13 +1714,14 @@ def _outcome_failure_warrants_repair(return Falseif only_degraded_blocking(completion_verification):return False- if any(verdict.reason_code == "evidence_contradicts" for verdict in completion_verification.verdicts):+ unmet_verdicts = effective_unmet_verdicts(completion_verification)+ if any(verdict.reason_code == "evidence_contradicts" for verdict in unmet_verdicts):return True# Repair needs at least one affirmatively unsatisfied criterion; unknown alone# (absent judge signal, unmappable definition checks) never warrants repair.if not any(verdict.state == "unsatisfied" and not _is_structural_requested_output_abstention(verdict)- for verdict in completion_verification.verdicts+ for verdict in unmet_verdicts):return Falsereturn _current_workflow_has_evidence_block(copilot_ctx)diff --git a/skyvern/forge/sdk/copilot/tools/run_execution.py b/skyvern/forge/sdk/copilot/tools/run_execution.pyindex f500e4a41..226e7e87d 100644--- a/skyvern/forge/sdk/copilot/tools/run_execution.py+++ b/skyvern/forge/sdk/copilot/tools/run_execution.py@@ -2748,7 +2748,9 @@ def _record_run_blocks_result()copilot_ctx.completion_verification_result = completion_verificationif prior_committed_outcome is None or _verification_fully_satisfied(completion_verification):- record_completion_verification(copilot_ctx, completion_verification)+ record_completion_verification(+ copilot_ctx, completion_verification, workflow_run_id=run_id if isinstance(run_id, str) else None+ )_record_adjudication_on_turn_state(copilot_ctx, completion_verification)if completion_verification is not None and completion_verification.status == "evaluated":_emit_completion_verification_trace(copilot_ctx, completion_verification)@@ -2884,7 +2886,9 @@ def _record_run_blocks_result(if blocked_verification is not completion_verification:completion_verification = blocked_verificationcopilot_ctx.completion_verification_result = blocked_verification- record_completion_verification(copilot_ctx, blocked_verification)+ record_completion_verification(+ copilot_ctx, blocked_verification, workflow_run_id=run_id if isinstance(run_id, str) else None+ )_record_adjudication_on_turn_state(copilot_ctx, blocked_verification)_mark_page_inspected(copilot_ctx)result["ok"] = Falsediff --git a/skyvern/forge/sdk/copilot/tools/workflow_update.py b/skyvern/forge/sdk/copilot/tools/workflow_update.pyindex 1a4176dc6..c9bed6061 100644--- a/skyvern/forge/sdk/copilot/tools/workflow_update.py+++ b/skyvern/forge/sdk/copilot/tools/workflow_update.py@@ -163,7 +163,6 @@ from skyvern.forge.sdk.copilot.request_policy import (CompletionCriterion,JudgmentPredicate,RequestedOutputEvidenceSource,- RequestedOutputPathMintSource,_coerce_requested_output_evidence_source,_is_judgment_boolean_criterion,)@@ -247,13 +246,6 @@ from .guardrails import (LOG = structlog.get_logger()-_CLASSIFIER_DEFAULT_MINT_SOURCE: RequestedOutputPathMintSource = "classifier_default"-if REQUESTED_OUTPUT_PATH_MINT_SOURCES != {_CLASSIFIER_DEFAULT_MINT_SOURCE}:- raise RuntimeError(- "RequestedOutputPathMintSource gained a member; the requested-output author-exclusion "- "must be revisited before this equality can stay strict."- )-class BlockObservationRef(BaseModel):label: str@@ -1696,7 +1688,7 @@ def _requested_output_child_paths(ctx: AgentContext) -> set[str]:continueif getattr(criterion, "mint_degrade", None) is not None:continue- if getattr(criterion, "requested_output_path_mint_source", None) == _CLASSIFIER_DEFAULT_MINT_SOURCE:+ if getattr(criterion, "requested_output_path_mint_source", None) in REQUESTED_OUTPUT_PATH_MINT_SOURCES:continuepath = _canonical_requested_output_path(getattr(criterion, "output_path", None))if path and _output_path_has_child(path):diff --git a/tests/unit/copilot_test_helpers.py b/tests/unit/copilot_test_helpers.pyindex 1eb121172..0ea489b71 100644--- a/tests/unit/copilot_test_helpers.py+++ b/tests/unit/copilot_test_helpers.py@@ -172,6 +172,7 @@ def make_completion_criterion(kind: str = "outcome",terminal_action_family: str | None = None,deliverable_kind: str | None = None,+ deliverable_confirmation_criterion_id: str | None = None,expected_output_value: str | None = None,expected_output_shape: str | None = None,requested_output_evidence_source: str = "runtime_output",@@ -180,6 +181,8 @@ def make_completion_criterion(expected_classification: str | bool | None = None,requested_output_corroborator: bool = False,mint_degrade: str | None = None,+ requested_output_floor_rekeyed: bool = False,+ floor_rekeyed_from_path: str | None = None,) -> CompletionCriterion:return CompletionCriterion(id=cid,@@ -192,6 +195,7 @@ def make_completion_criterion(kind=kind, # type: ignore[arg-type]terminal_action_family=terminal_action_family, # type: ignore[arg-type]deliverable_kind=deliverable_kind, # type: ignore[arg-type]+ deliverable_confirmation_criterion_id=deliverable_confirmation_criterion_id,expected_output_value=expected_output_value,expected_output_shape=expected_output_shape, # type: ignore[arg-type]requested_output_evidence_source=requested_output_evidence_source, # type: ignore[arg-type]@@ -200,4 +204,6 @@ def make_completion_criterion(expected_classification=expected_classification,requested_output_corroborator=requested_output_corroborator,mint_degrade=mint_degrade, # type: ignore[arg-type]+ requested_output_floor_rekeyed=requested_output_floor_rekeyed,+ floor_rekeyed_from_path=floor_rekeyed_from_path,)diff --git a/tests/unit/test_copilot_completion_verification.py b/tests/unit/test_copilot_completion_verification.pyindex 352c288c8..0651ba91d 100644--- a/tests/unit/test_copilot_completion_verification.py+++ b/tests/unit/test_copilot_completion_verification.py@@ -44,10 +44,12 @@ from skyvern.forge.sdk.copilot.completion_verification import (RunEvidenceSnapshot,_coerce_result,_structured_record_has_identifier,+ carry_criterion_metadata,carry_degraded_criterion_ids,carry_floor_rekeyed_criterion_ids,combine_verification_results,degraded_contract_delivered_unverified_terminal_state,+ effective_unmet_verdicts,evaluate_completion_criteria,floor_rekeyed_deliverable_credit,floor_rekeyed_emission_lane_fields,@@ -63,6 +65,7 @@ from skyvern.forge.sdk.copilot.completion_verification import (gradeable_completion_criteria,is_registered_download_completion_criterion,only_degraded_blocking,+ plain_outcome_no_evidence_abstention_decision,registered_download_completion_criterion,run_plane_all_no_evidence,structural_unfired_contingent_criterion_ids,@@ -97,6 +100,7 @@ from skyvern.forge.sdk.copilot.request_policy import (RequestPolicy,_apply_classifier_typed_requested_output_corroborators,_apply_requested_output_completion_criteria,+ _degrade_unbound_request_slot_criterion,_parse_completion_criteria,build_classifier_fallback_floor,is_contingent_missing_antecedent_degraded,@@ -653,6 +657,340 @@ def _mixed(*verdicts: CriterionVerdict) -> CompletionVerificationResult:)+def _typed_result(criteria: list[CompletionCriterion], *verdicts: CriterionVerdict) -> CompletionVerificationResult:+ return carry_criterion_metadata(_mixed(*verdicts), criteria)+++def _plain_no_evidence_criterion(criterion_id: str = "c_outcome", *, associated: bool = False) -> CompletionCriterion:+ return replace(+ _criterion(criterion_id, "The requested outcome is reached."),+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID if associated else None,+ )+++def _requested_registered_download_criterion() -> CompletionCriterion:+ return replace(+ registered_download_completion_criterion(),+ requested_output_path_mint_source="classifier_default",+ )+++def _plain_no_evidence_verdict(criterion_id: str = "c_outcome") -> CriterionVerdict:+ return CriterionVerdict(criterion_id=criterion_id, state="unsatisfied", reason_code="no_evidence")+++def _confirmed_deliverable_verdict(+ criterion_id: str,+ source: EvidenceSourceKind,+) -> CriterionVerdict:+ return CriterionVerdict(+ criterion_id=criterion_id,+ state="satisfied",+ reason_code="evidence_confirms",+ evidence_ref=f"block_outputs:{criterion_id}",+ evidence_source=source,+ )+++def test_plain_outcome_no_evidence_abstains_for_registered_download() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is True+ assert result.criterion_requested_output_mint_source_by_id == {download.id: "classifier_default"}+ trace = result.to_trace_data()+ assert trace["plain_outcome_no_evidence_abstention_engaged"] is True+ assert trace["plain_outcome_no_evidence_abstention_abstained_criterion_ids"] == [outcome.id]+ assert trace["plain_outcome_no_evidence_abstention_confirming_deliverable_criterion_ids"] == [download.id]+ assert trace["plain_outcome_no_evidence_abstention_confirming_deliverable_sources"] == ["registered_download"]+ assert trace["plain_outcome_no_evidence_abstention_criterion_plane"] == "run"+ assert trace["plain_outcome_no_evidence_abstention_criterion_kind"] == "outcome"+ assert trace["plain_outcome_no_evidence_abstention_reason_code"] == "no_evidence"+ assert trace["plain_outcome_no_evidence_abstention_confirmed_independent_deliverable"] is True+ assert trace["plain_outcome_no_evidence_abstention_confirming_deliverable_mint_sources"] == ["classifier_default"]+ assert trace["unmet_criterion_ids"] == []+ assert trace["missing_evidence"] == []+ assert summarize_unsatisfied_outcomes(result, [outcome, download]) == ""+ assert _outcome_failure_warrants_repair(SimpleNamespace(), result) is False+ assert _outcome_unverified_reason(SimpleNamespace(), result) is None+++def test_plain_outcome_no_evidence_rejects_unrequested_registered_download() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ download = registered_download_completion_criterion()+ result = _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()++[email protected]("source", ["independent_page_evidence", "registered_artifact_content"])+def test_confirmed_requested_output_deliverable_does_not_license_abstention_without_association(+ source: EvidenceSourceKind,+) -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ deliverable = _criterion("c_deliverable", "The result is returned.", output_path="output.result")+ result = _typed_result(+ [outcome, deliverable],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(deliverable.id, source),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_confirmed_download_does_not_abstain_unassociated_plain_outcome() -> None:+ outcome = _plain_no_evidence_criterion()+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_confirmed_download_does_not_excuse_unassociated_sibling_outcome() -> None:+ associated = _plain_no_evidence_criterion("c_download_outcome", associated=True)+ unrelated = _plain_no_evidence_criterion("c_cart_outcome")+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [associated, unrelated, download],+ _plain_no_evidence_verdict(associated.id),+ _plain_no_evidence_verdict(unrelated.id),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ decision = plain_outcome_no_evidence_abstention_decision(result)+ assert decision is not None+ assert list(decision.criterion_ids) == [associated.id]+ assert unrelated.id in {verdict.criterion_id for verdict in effective_unmet_verdicts(result)}+++def test_floor_rekeyed_criterion_is_not_abstainable() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ download = _requested_registered_download_criterion()+ result = replace(+ _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ ),+ floor_rekeyed_criterion_ids=[outcome.id],+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++ "source",+ [None, "runtime_output", "same_record_context", "registered_output_parameter", "terminal_record"],+)+def test_plain_outcome_no_evidence_rejects_non_authoritative_deliverable_sources(+ source: EvidenceSourceKind | None,+) -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ deliverable = _criterion("c_deliverable", "The result is returned.", output_path="output.result")+ verdict = CriterionVerdict(+ criterion_id=deliverable.id,+ state="satisfied",+ reason_code="evidence_confirms",+ evidence_ref="block_outputs:forged_authority",+ evidence_source=source,+ )+ result = _typed_result([outcome, deliverable], _plain_no_evidence_verdict(), verdict)++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++ "criterion",+ [+ _criterion(+ "c_definition",+ "A reusable input exists.",+ level="definition",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ _criterion(+ "c_requested",+ "The status is returned.",+ output_path="output.status",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ _criterion(+ "c_download",+ "A download is produced.",+ deliverable_kind="registered_download",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ _criterion(+ "c_terminal",+ "The request is submitted.",+ kind="terminal_action",+ terminal_action_family="request",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ ],+)+def test_confirmed_deliverable_does_not_abstain_ineligible_no_evidence_criteria(+ criterion: CompletionCriterion,+) -> None:+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [criterion, download],+ _plain_no_evidence_verdict(criterion.id),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_registered_download_deliverable_self_no_evidence_does_not_abstain() -> None:+ download = registered_download_completion_criterion()+ deliverable = _criterion("c_deliverable", "The result is returned.", output_path="output.result")+ result = _typed_result(+ [download, deliverable],+ _plain_no_evidence_verdict(download.id),+ _confirmed_deliverable_verdict(deliverable.id, "registered_artifact_content"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_missing_criterion_metadata_keeps_plain_no_evidence_fail_closed() -> None:+ download = registered_download_completion_criterion()+ result = _mixed(+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_plain_outcome_abstention_does_not_hide_unknown_or_genuine_miss() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ unknown = _criterion("c_unknown", "A second outcome is observed.")+ contradicted = _criterion("c_miss", "A third outcome is observed.")+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [outcome, unknown, contradicted, download],+ _plain_no_evidence_verdict(),+ CriterionVerdict(criterion_id=unknown.id, state="unknown", reason_code="unknown"),+ CriterionVerdict(criterion_id=contradicted.id, state="unsatisfied", reason_code="evidence_contradicts"),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_plain_outcome_abstention_preserves_reperception_exception() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ observed = _criterion("c_observed", "The observed end state is reached.")+ reperception = _criterion("c_reperception", "The synthesized browser steps agree.")+ download = _requested_registered_download_criterion()+ result = _typed_result(+ [outcome, observed, reperception, download],+ _plain_no_evidence_verdict(),+ CriterionVerdict(+ criterion_id=observed.id,+ state="satisfied",+ reason_code="evidence_confirms",+ evidence_ref="observed_end_state_url",+ ),+ CriterionVerdict(+ criterion_id=reperception.id,+ state="unsatisfied",+ reason_code="evidence_contradicts",+ evidence_ref="scout_synthesized_browser_steps_output",+ ),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ assert result.is_fully_satisfied() is True+ assert result.to_trace_data()["plain_outcome_no_evidence_abstention_engaged"] is True+++def test_plain_outcome_abstention_earns_zero_credit_without_confirmed_deliverable() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ result = _typed_result([outcome], _plain_no_evidence_verdict())++ assert result.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()+++def test_combine_verification_results_retains_plain_outcome_metadata() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ download = _requested_registered_download_criterion()+ run_result = _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ combined = combine_verification_results([outcome.id, download.id], run_result, [])++ assert combined.criterion_level_by_id == run_result.criterion_level_by_id+ assert combined.criterion_kind_by_id == run_result.criterion_kind_by_id+ assert combined.criterion_output_path_by_id == run_result.criterion_output_path_by_id+ assert (+ combined.deliverable_confirmation_criterion_id_by_id == run_result.deliverable_confirmation_criterion_id_by_id+ )+ assert combined.is_fully_satisfied() is True+++def test_combine_verification_results_retains_requested_download_identity() -> None:+ outcome = _plain_no_evidence_criterion(associated=True)+ download = _requested_registered_download_criterion()+ run_result = _typed_result(+ [outcome, download],+ _plain_no_evidence_verdict(),+ _confirmed_deliverable_verdict(download.id, "registered_download"),+ )++ combined = combine_verification_results([outcome.id, download.id], run_result, [])++ assert combined.criterion_requested_output_mint_source_by_id == {download.id: "classifier_default"}+ assert combined.is_fully_satisfied() is True+++def test_registered_download_grader_stamps_typed_authority() -> None:+ criterion = registered_download_completion_criterion()+ verdicts = grade_registered_download_criteria(+ [criterion],+ RunEvidenceSnapshot(block_outputs={"download": {"download_registered": True, "downloaded_file_count": 1}}),+ )++ assert verdicts == [+ CriterionVerdict(+ criterion_id=criterion.id,+ state="satisfied",+ reason_code="evidence_confirms",+ evidence_ref="block_outputs:download",+ evidence_source="registered_download",+ )+ ]++def test_definition_plane_abstention_does_not_sink_evidence_confirmed_run() -> None:definition_unknown = CriterionVerdict(criterion_id="c0", state="unknown", reason_code="definition_parameters_absent"@@ -5894,6 +6232,56 @@ async def test_page_observation_verification_recognizes_budgeted_outcome(assert "SKU-12345 is present in the cart" in seen_prompt["prompt"]+async def test_page_observation_finalization_keeps_unassociated_plain_no_evidence_blocking(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ outcome = _plain_no_evidence_criterion()+ deliverable = _criterion(+ "c_deliverable",+ "The result is returned.",+ output_path="output.result",+ expected_output_value="ready",+ )+ ctx = _run_ctx()+ ctx.request_policy = RequestPolicy(completion_criteria=[outcome, deliverable])+ ctx.code_artifact_metadata = _metadata_for_requested_paths("result")+ ctx.last_test_ok = False+ ctx.last_run_blocks_workflow_run_id = "wr_cancel"+ ctx.copilot_run_start_monotonic = time.monotonic()+ _record_composition_page_observation(+ ctx,+ source_tool="evaluate",+ url="https://example.test/result",+ observed_data={"result": "ready"},+ )++ result = await _maybe_run_completion_verification_from_page_observation(+ ctx,+ url="https://example.test/result",+ observed_data={"result": "ready"},+ )++ assert result is not None+ assert result.is_fully_satisfied() is False+ verdict_by_id = {verdict.criterion_id: verdict for verdict in result.verdicts}+ assert verdict_by_id[deliverable.id].evidence_source == "independent_page_evidence"+ assert result.criterion_output_path_by_id == {deliverable.id: "output.result"}+ assert "plain_outcome_no_evidence_abstention_engaged" not in result.to_trace_data()++@pytest.mark.asyncioasync def test_page_observation_validation_classification_cannot_be_judge_approved(monkeypatch: pytest.MonkeyPatch,@@ -10019,11 +10407,59 @@ async def test_download_registered_non_empty_injects_and_verifies_without_judge(state="satisfied",reason_code="evidence_confirms",evidence_ref="block_outputs:download_document",+ evidence_source="registered_download",)]assert ctx.request_policy.completion_criteria == []+async def test_run_finalization_abstains_plain_no_evidence_for_registered_download(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ _set_workflow_labels(ctx, "download_document")+ requested_download = _criterion(+ "c_download",+ "The run returns a registered downloaded file.",+ output_path="output.downloaded_files",+ deliverable_kind="registered_download",+ requested_output_path_mint_source="classifier_default",+ )+ ctx.request_policy = RequestPolicy(+ completion_criteria=[_plain_no_evidence_criterion(associated=True), requested_download]+ )++ verification = await _maybe_run_completion_verification(+ ctx,+ _download_result(_REGISTERED_DOWNLOAD_OUTPUT),+ time.monotonic(),+ )++ assert verification is not None+ assert verification.is_fully_satisfied() is True+ assert verification.criterion_ids == ["c_outcome", REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID]+ assert verification.criterion_level_by_id == {+ "c_outcome": "run",+ REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID: "run",+ }+ assert verification.to_trace_data()["plain_outcome_no_evidence_abstention_engaged"] is True+ assert verification.requested_output_criteria_count == 1+ assert zero_requested_output_criteria_credit(verification, has_meaningful_registered_output=True) is False++@pytest.mark.asyncioasync def test_download_registered_output_parameter_injects_and_verifies_without_judge(monkeypatch: pytest.MonkeyPatch,@@ -10057,6 +10493,7 @@ async def test_download_registered_output_parameter_injects_and_verifies_withoutstate="satisfied",reason_code="evidence_confirms",evidence_ref="block_outputs:download_document_output",+ evidence_source="registered_download",)]assert ctx.request_policy.completion_criteria == []@@ -10501,6 +10938,130 @@ def test_reconciliation_incidental_download_stays_uncounted() -> None:assert carried[0].requested_output_path_mint_source is None+def _degraded_minted_download_criterion(cid: str = "c_download") -> CompletionCriterion:+ return _criterion(+ cid,+ "The finished workflow produces the downloaded file.",+ deliverable_kind="registered_download",+ requested_output_path_mint_source="classifier_default",+ mint_degrade="undecidable_judgment",+ requested_output_floor_rekeyed=True,+ floor_rekeyed_from_path="output.downloaded_files",+ )+++def test_reconciliation_witnesses_degraded_minted_ask_from_formed_criteria() -> None:+ ctx = _run_ctx()+ ctx.request_policy = RequestPolicy(completion_criteria=[_degraded_minted_download_criterion()])++ reconciled = _reconcile_download_completion_criterion(ctx, _download_result(_REGISTERED_DOWNLOAD_OUTPUT), [])++ carried = [criterion for criterion in reconciled if is_registered_download_completion_criterion(criterion)]+ assert len(carried) == 1+ assert carried[0].requested_output_path_mint_source == "classifier_default"+++async def test_degraded_minted_download_ask_still_reaches_abstention(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ _set_workflow_labels(ctx, "download_document")+ ctx.request_policy = RequestPolicy(+ completion_criteria=[_plain_no_evidence_criterion(associated=True), _degraded_minted_download_criterion()]+ )++ verification = await _maybe_run_completion_verification(+ ctx, _download_result(_REGISTERED_DOWNLOAD_OUTPUT), time.monotonic()+ )++ assert verification is not None+ assert verification.is_fully_satisfied() is True+ assert verification.criterion_ids == ["c_outcome", REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID]+ assert verification.to_trace_data()["plain_outcome_no_evidence_abstention_engaged"] is True+ assert verification.requested_output_criteria_count == 1+ assert zero_requested_output_criteria_credit(verification, has_meaningful_registered_output=True) is False+++async def test_incidental_download_does_not_license_plain_no_evidence_abstention(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ _set_workflow_labels(ctx, "download_document")+ ctx.request_policy = RequestPolicy(completion_criteria=[_plain_no_evidence_criterion()])++ verification = await _maybe_run_completion_verification(+ ctx, _download_result(_REGISTERED_DOWNLOAD_OUTPUT), time.monotonic()+ )++ assert verification is not None+ assert verification.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in verification.to_trace_data()+ assert REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID not in verification.criterion_requested_output_mint_source_by_id+++async def test_degraded_minted_ask_cannot_manufacture_confirmation_without_download_evidence(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ ctx.reached_download_target = ReachedDownloadTarget(+ selector='a[href="/files/statement.pdf"]',+ affordance_text="Download",+ download_kind="extension",+ source_step="trajectory_recency",+ already_registered=False,+ )+ ctx.request_policy = RequestPolicy(+ completion_criteria=[_plain_no_evidence_criterion(associated=True), _degraded_minted_download_criterion()]+ )++ verification = await _maybe_run_completion_verification(ctx, _goto_only_result(), time.monotonic())++ assert verification is not None+ assert verification.is_fully_satisfied() is False+ assert "plain_outcome_no_evidence_abstention_engaged" not in verification.to_trace_data()+ assert "c_download" not in verification.criterion_ids+ assert REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID not in verification.criterion_requested_output_mint_source_by_id++@pytest.mark.asyncioasync def test_minted_download_ask_counts_as_requested_output_and_verifies(monkeypatch: pytest.MonkeyPatch,@@ -10583,6 +11144,83 @@ async def test_predeploy_persisted_download_ask_is_undercredited_until_reminted(assert zero_requested_output_criteria_credit(verification, has_meaningful_registered_output=True) is True+def _declared_download_criterion(cid: str = "c_download") -> CompletionCriterion:+ return _criterion(+ cid,+ "The finished workflow produces the downloaded file.",+ output_path="output.downloaded_files",+ deliverable_kind="registered_download",+ requested_output_path_mint_source="classifier_declared",+ )+++async def test_declared_download_ask_reaches_abstention(monkeypatch: pytest.MonkeyPatch) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ _set_workflow_labels(ctx, "download_document")+ ctx.request_policy = RequestPolicy(+ completion_criteria=[_plain_no_evidence_criterion(associated=True), _declared_download_criterion()]+ )++ verification = await _maybe_run_completion_verification(+ ctx, _download_result(_REGISTERED_DOWNLOAD_OUTPUT), time.monotonic()+ )++ assert verification is not None+ assert verification.is_fully_satisfied() is True+ trace = verification.to_trace_data()+ assert trace["plain_outcome_no_evidence_abstention_engaged"] is True+ assert trace["plain_outcome_no_evidence_abstention_confirming_deliverable_mint_sources"] == ["classifier_declared"]+ assert verification.requested_output_criteria_count == 1+ assert zero_requested_output_criteria_credit(verification, has_meaningful_registered_output=True) is False+++async def test_request_slot_degraded_declared_download_ask_still_reaches_abstention(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ async def handler(**_: object) -> dict[str, object]:+ return {+ "verdicts": [+ {+ "criterion_id": "c_outcome",+ "satisfied": False,+ "reason_code": "no_evidence",+ }+ ]+ }++ _patch_completion_handler(monkeypatch, handler)+ ctx = _run_ctx()+ _set_workflow_labels(ctx, "download_document")+ degraded = _degrade_unbound_request_slot_criterion(_declared_download_criterion())+ ctx.request_policy = RequestPolicy(completion_criteria=[_plain_no_evidence_criterion(associated=True), degraded])++ verification = await _maybe_run_completion_verification(+ ctx, _download_result(_REGISTERED_DOWNLOAD_OUTPUT), time.monotonic()+ )++ assert degraded.floor_rekeyed_from_path == "output.downloaded_files"+ assert degraded.requested_output_path_mint_source == "classifier_declared"+ assert verification is not None+ assert verification.is_fully_satisfied() is True+ trace = verification.to_trace_data()+ assert trace["plain_outcome_no_evidence_abstention_engaged"] is True+ assert trace["plain_outcome_no_evidence_abstention_confirming_deliverable_mint_sources"] == ["classifier_declared"]++def test_download_grader_requires_non_empty_registered_surface() -> None:criteria = [registered_download_completion_criterion()]@@ -10628,6 +11266,7 @@ def test_download_grader_requires_non_empty_registered_surface() -> None:state="satisfied",reason_code="evidence_confirms",evidence_ref="block_outputs:download_document",+ evidence_source="registered_download",)]diff --git a/tests/unit/test_copilot_outcome_verification_trace.py b/tests/unit/test_copilot_outcome_verification_trace.pyindex 13b977ae4..5a9c254a5 100644--- a/tests/unit/test_copilot_outcome_verification_trace.py+++ b/tests/unit/test_copilot_outcome_verification_trace.py@@ -2,21 +2,32 @@from __future__ import annotations+from dataclasses import replacefrom types import SimpleNamespacefrom typing import Anyimport pytestfrom opentelemetry import trace as otel_trace+from structlog.testing import capture_logsfrom skyvern.forge.sdk.copilot import agent as copilot_agent-from skyvern.forge.sdk.copilot.completion_verification import CompletionVerificationResult, CriterionVerdict+from skyvern.forge.sdk.copilot.completion_verification import (+ CompletionVerificationResult,+ CriterionVerdict,+ carry_criterion_metadata,+ registered_download_completion_criterion,+)from skyvern.forge.sdk.copilot.outcome_verification_trace import (finalize_outcome_verification_trace,outcome_verification_turn_fields,record_completion_verification,record_gate_decision,)-from skyvern.forge.sdk.copilot.request_policy import CompletionCriterion, RequestPolicy+from skyvern.forge.sdk.copilot.request_policy import (+ REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ CompletionCriterion,+ RequestPolicy,+)from skyvern.forge.sdk.copilot.verification_evidence import WorkflowVerificationEvidencefrom skyvern.forge.sdk.schemas.workflow_copilot import WorkflowCopilotChatRequest@@ -39,6 +50,61 @@ def _evaluated_result() -> CompletionVerificationResult:)+def _abstention_engaged_result() -> CompletionVerificationResult:+ outcome = CompletionCriterion(+ id="c_outcome",+ outcome="The requested outcome is reached.",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ )+ download = replace(+ registered_download_completion_criterion(),+ requested_output_path_mint_source="classifier_default",+ )+ result = CompletionVerificationResult(+ status="evaluated",+ criterion_ids=[outcome.id, download.id],+ verdicts=[+ CriterionVerdict(criterion_id=outcome.id, state="unsatisfied", reason_code="no_evidence"),+ CriterionVerdict(+ criterion_id=download.id,+ state="satisfied",+ reason_code="evidence_confirms",+ evidence_ref=f"block_outputs:{download.id}",+ evidence_source="registered_download",+ ),+ ],+ )+ return carry_criterion_metadata(result, [outcome, download])+++def test_record_completion_verification_logs_abstention_fingerprint() -> None:+ ctx = SimpleNamespace()+ with capture_logs() as logs:+ record_completion_verification(ctx, _abstention_engaged_result(), workflow_run_id="wr_test_run")++ events = [log for log in logs if log["event"] == "copilot.completion.plain_outcome_no_evidence_abstention"]+ assert len(events) == 1+ event = events[0]+ assert event["workflow_run_id"] == "wr_test_run"+ assert event["plain_outcome_no_evidence_abstention_criterion_plane"] == "run"+ assert event["plain_outcome_no_evidence_abstention_criterion_kind"] == "outcome"+ assert event["plain_outcome_no_evidence_abstention_reason_code"] == "no_evidence"+ assert event["plain_outcome_no_evidence_abstention_confirmed_independent_deliverable"] is True+ assert event["plain_outcome_no_evidence_abstention_abstained_criterion_ids"] == ["c_outcome"]+ assert event["plain_outcome_no_evidence_abstention_confirming_deliverable_sources"] == ["registered_download"]+ assert event["plain_outcome_no_evidence_abstention_confirming_deliverable_mint_sources"] == ["classifier_default"]+ snapshot = ctx.outcome_verification_trace_snapshot+ assert snapshot["completion_verification_plain_outcome_no_evidence_abstention_engaged"] is True+++def test_record_completion_verification_skips_fingerprint_log_when_not_engaged() -> None:+ ctx = SimpleNamespace()+ with capture_logs() as logs:+ record_completion_verification(ctx, _evaluated_result(), workflow_run_id="wr_test_run")++ assert all(log["event"] != "copilot.completion.plain_outcome_no_evidence_abstention" for log in logs)++def test_record_completion_verification_populates_evaluated_block() -> None:ctx = SimpleNamespace()record_completion_verification(ctx, _evaluated_result())diff --git a/tests/unit/test_copilot_output_contract_actuation.py b/tests/unit/test_copilot_output_contract_actuation.pyindex 607203f71..f3f4acd96 100644--- a/tests/unit/test_copilot_output_contract_actuation.py+++ b/tests/unit/test_copilot_output_contract_actuation.py@@ -2018,6 +2018,21 @@ def test_classifier_minted_download_path_excluded_from_author_coverage() -> Noneassert wu._output_contract_required_paths_source(ctx).union == set()+def test_classifier_declared_download_path_excluded_from_author_coverage() -> None:+ ctx = _antecedent_ctx(+ CompletionCriterion(+ id="c_download",+ outcome="The invoice PDF is downloaded.",+ output_path="output.downloaded_files",+ deliverable_kind="registered_download",+ requested_output_path_mint_source="classifier_declared",+ )+ )++ assert wu._requested_output_child_paths(ctx) == set()+ assert wu._output_contract_required_paths_source(ctx).union == set()++def test_non_minted_registered_download_path_still_requires_author_coverage() -> None:ctx = _antecedent_ctx(CompletionCriterion(diff --git a/tests/unit/test_copilot_request_policy_completion_criteria.py b/tests/unit/test_copilot_request_policy_completion_criteria.pyindex fbd1c4648..9ce8820ed 100644--- a/tests/unit/test_copilot_request_policy_completion_criteria.py+++ b/tests/unit/test_copilot_request_policy_completion_criteria.py@@ -17,6 +17,7 @@ from skyvern.forge.sdk.copilot.completion_criteria_store import ()from skyvern.forge.sdk.copilot.config import CopilotConfigfrom skyvern.forge.sdk.copilot.request_policy import (+ REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,CompletionCriterion,JudgmentTruthCondition,RequestPolicy,@@ -1775,6 +1776,161 @@ def test_requested_output_path_mint_source_excluded_from_reconcile_key() -> Noneassert _criterion_reconcile_key(minted) == _criterion_reconcile_key(persisted_twin)+def test_classifier_declared_registered_download_path_mints_declared_source() -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The requested statement download is returned.",+ "output_path": "output.downloaded_file_artifact_ids",+ "deliverable_kind": "registered_download",+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].output_path == "output.downloaded_file_artifact_ids"+ assert parsed[0].requested_output_path_mint_source == "classifier_declared"+++def test_classifier_declared_non_registered_download_path_mints_no_source() -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The returned record includes the statement id.",+ "output_path": "output.statement_id",+ "deliverable_kind": "registered_download",+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].output_path == "output.statement_id"+ assert parsed[0].requested_output_path_mint_source is None+++def test_store_round_trip_preserves_classifier_declared_mint_source() -> None:+ criteria = (replace(_minted_download_criterion(), requested_output_path_mint_source="classifier_declared"),)++ restored = criteria_from_json(criteria_to_json(criteria))++ assert restored[0].requested_output_path_mint_source == "classifier_declared"+ assert restored == criteria+++def test_exact_value_download_ask_does_not_mint_classifier_declared_source() -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The requested statement download is returned.",+ "output_path": "output.downloaded_files",+ "deliverable_kind": "registered_download",+ "expected_output_value": "statement-2026-05.pdf",+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].expected_output_value == "statement-2026-05.pdf"+ assert parsed[0].requested_output_path_mint_source is None+++def test_plain_outcome_keeps_canonical_deliverable_confirmation_association() -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The requested document is selected and downloaded.",+ "deliverable_confirmation_criterion_id": REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].deliverable_confirmation_criterion_id == REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID+++def test_non_canonical_deliverable_confirmation_association_is_cleared() -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The requested document is selected and downloaded.",+ "deliverable_confirmation_criterion_id": "c1",+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].deliverable_confirmation_criterion_id is None+++ "ineligible_fields",+ [+ {"level": "definition"},+ {"kind": "terminal_action", "terminal_action_family": "request"},+ {"output_path": "output.downloaded_files", "deliverable_kind": "registered_download"},+ {"method_mandated": True},+ ],+)+def test_ineligible_criteria_cannot_carry_deliverable_confirmation_association(+ ineligible_fields: dict[str, Any],+) -> None:+ parsed = _parse_completion_criteria(+ [+ {+ "outcome": "The requested document is selected and downloaded.",+ "deliverable_confirmation_criterion_id": REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ **ineligible_fields,+ }+ ]+ )++ assert len(parsed) == 1+ assert parsed[0].deliverable_confirmation_criterion_id is None+++def test_store_round_trip_preserves_deliverable_confirmation_association() -> None:+ criteria = (+ _criterion(+ "c0",+ "The requested document is selected and downloaded.",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ )++ restored = criteria_from_json(criteria_to_json(criteria))++ assert restored == criteria+ assert restored[0].deliverable_confirmation_criterion_id == REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID+++def test_store_load_clears_association_on_ineligible_row() -> None:+ row = criteria_to_json(+ (+ _criterion(+ "c0",+ "The requested document is selected and downloaded.",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ ),+ )+ )+ row[0]["method_mandated"] = True++ restored = criteria_from_json(row)++ assert restored[0].deliverable_confirmation_criterion_id is None+++def test_deliverable_confirmation_association_changes_reconcile_identity() -> None:+ associated = _criterion(+ "c0",+ "The requested document is selected and downloaded.",+ deliverable_confirmation_criterion_id=REGISTERED_DOWNLOAD_COMPLETION_CRITERION_ID,+ )+ unassociated = replace(associated, deliverable_confirmation_criterion_id=None)++ assert _criterion_reconcile_key(associated) != _criterion_reconcile_key(unassociated)++def test_request_policy_trace_exposes_requested_output_grounding_contract_without_values() -> None:policy = RequestPolicy(completion_criteria=[diff --git a/tests/unit/test_copilot_request_policy_prompt.py b/tests/unit/test_copilot_request_policy_prompt.pyindex cf4203084..8defa4514 100644--- a/tests/unit/test_copilot_request_policy_prompt.py+++ b/tests/unit/test_copilot_request_policy_prompt.py@@ -90,10 +90,14 @@ class TestRequestPolicyPromptStructure:rendered = _render()assert ("{outcome, contingent_on, contingent_antecedent_output_path, "- "deliverable_kind, implicit, method_mandated, level, output_path, expected_output_value, "+ "deliverable_kind, deliverable_confirmation_criterion_id, implicit, method_mandated, level, output_path, "+ "expected_output_value, ""expected_output_shape, requested_output_evidence_source, kind, terminal_action_family, ""classification_output_key, expected_classification, judgment_predicate, judgment_polarity_when_holds}") in rendered+ assert "deliverable_confirmation_criterion_id: null unless this is a plain run-plane outcome" in rendered+ assert "__copilot_registered_download__downloaded_files_non_empty" in rendered+ assert "Never set it merely because another outcome downloads a file" in renderedassert "typed request-slot producer owns its final identity, path, plane, and pinability" in renderedassert "Do not infer or emit pinability here" in renderedassert "never hide it in outcome prose" in rendereddiff --git a/tests/unit/test_mcp_block_type_parity.py b/tests/unit/test_mcp_block_type_parity.pyindex 99d8bb925..7f54a23ad 100644--- a/tests/unit/test_mcp_block_type_parity.py+++ b/tests/unit/test_mcp_block_type_parity.py@@ -95,27 +95,9 @@ class BlockDriftEntry:# the vendored Fern SDK. Run `fern generate` using the Skyvern Cloud-only# runbook to resync, then remove the entry here._KNOWN_DRIFT_ALLOWLIST: tuple[BlockDriftEntry, ...] = (- BlockDriftEntry(- block_type="pdf_fill",- ticket="SKY-10944",- owner="@suchintan",- added_at=date(2026, 6, 11),- notes="Fern SDK regen happens via CI post-deploy",- ),- BlockDriftEntry(- block_type="split_pdf",- ticket="SKY-12071",- owner="@suchintan",- added_at=date(2026, 7, 8),- notes="Fern SDK regen happens via CI post-deploy",- ),- BlockDriftEntry(- block_type="email_inbox",- ticket="SKY-12068",- owner="@suchintan",- added_at=date(2026, 7, 8),- notes="Fern SDK regen happens via CI post-deploy",- ),+ # Empty: pdf_fill (SKY-10944), split_pdf (SKY-12071), and email_inbox+ # (SKY-12068) were resolved by the Fern SDK regen in the 1.0.47 bump — all+ # three now appear in both WorkflowDefinition(Yaml)BlocksItem unions.)diff --git a/tests/unit/test_mcp_concise_responses.py b/tests/unit/test_mcp_concise_responses.pyindex 48535fb0f..5f9af19a3 100644--- a/tests/unit/test_mcp_concise_responses.py+++ b/tests/unit/test_mcp_concise_responses.py@@ -117,6 +117,15 @@ def test_concise_preserves_meaningful_data() -> None:assert result["data"] == {"extracted": {"price": 42.0}}+def test_concise_preserves_trajectory_capture_status() -> None:+ result = make_result(+ "skyvern_trajectory_get",+ data={"trajectory_json": "[]", "entry_count": 0, "truncated": False, "capture_status": "not_found"},+ )++ assert result["data"]["capture_status"] == "not_found"++def test_concise_preserves_error() -> None:err = {"code": "SELECTOR_NOT_FOUND", "message": "Not found", "hint": "Try another selector"}result = make_result("skyvern_click", ok=False, error=err)diff --git a/tests/unit/test_mcp_trajectory.py b/tests/unit/test_mcp_trajectory.pynew file mode 100644index 000000000..c482adddc--- /dev/null+++ b/tests/unit/test_mcp_trajectory.py@@ -0,0 +1,735 @@+from __future__ import annotations++import json+from collections.abc import Iterator+from types import SimpleNamespace+from unittest.mock import AsyncMock, MagicMock, Mock++import pytest++from skyvern.cli.core import session_manager, trajectory_store+from skyvern.cli.core.browser_ops import NativeOptionSelection+from skyvern.cli.core.result import BrowserContext, set_concise_responses+from skyvern.cli.core.session_manager import SessionState, set_current_session+from skyvern.cli.core.session_ops import SessionCloseResult+from skyvern.cli.core.trajectory_store import append_trajectory_entry, delete_trajectory, get_trajectory+from skyvern.cli.mcp_tools import browser as mcp_browser+from skyvern.cli.mcp_tools import session as mcp_session+from skyvern.cli.mcp_tools import trajectory as mcp_trajectory+from skyvern.cli.mcp_tools.code_block import skyvern_code_block_synthesize+from skyvern.forge.sdk.copilot.typed_value_policy import typed_text_looks_secret++_HASH_A = "principal-a"+_HASH_B = "principal-b"+_SESSION_IDS = (+ "pbs_roundtrip",+ "pbs_sessionless",+ "pbs_failed_action",+ "pbs_empty_type",+ "pbs_isolation",+ "pbs_close_explicit",+ "pbs_close_refused",+ "pbs_close_current",+ "pbs_passive",+ "pbs_secret",+ "pbs_secret_select",+ "pbs_native_secret_option",+ "pbs_concise",+ "pbs_native_option",+ "pbs_native_index",+ "pbs_select_values",+ "pbs_transport_cap",+ "pbs_hybrid_variants",+ "pbs_direct_intent",+ "pbs_custom_select",+ "pbs_type_variants",+ "pbs_select_label",+ "pbs_click_variants",+ "pbs_press_variants",+ "pbs_expired",+ "pbs_source_url",+)++[email protected](autouse=True)+def _reset_trajectory_state(monkeypatch: pytest.MonkeyPatch) -> Iterator[None]:+ monkeypatch.setattr(session_manager, "get_active_api_key", lambda: "key-a")+ monkeypatch.setattr(+ session_manager,+ "hash_api_key_for_cache",+ lambda api_key: {"key-a": _HASH_A, "key-b": _HASH_B}[api_key],+ )+ set_concise_responses(False)+ set_current_session(SessionState())+ for api_key_hash in (_HASH_A, _HASH_B, None):+ for session_id in _SESSION_IDS:+ delete_trajectory(api_key_hash=api_key_hash, session_id=session_id)+ yield+ set_concise_responses(False)+ set_current_session(SessionState())+ for api_key_hash in (_HASH_A, _HASH_B, None):+ for session_id in _SESSION_IDS:+ delete_trajectory(api_key_hash=api_key_hash, session_id=session_id)+++def _patch_browser_page(+ monkeypatch: pytest.MonkeyPatch,+ *,+ session_id: str | None,+ mode: str = "cloud_session",+ api_key_hash: str | None = _HASH_A,+ source_url: str = "https://example.com/catalog",+) -> SimpleNamespace:+ locator = SimpleNamespace(press=AsyncMock(), select_option=AsyncMock(), evaluate=AsyncMock(return_value=False))+ locator.first = locator+ raw_page = SimpleNamespace(locator=MagicMock(return_value=locator))+ page = SimpleNamespace(+ url=source_url,+ page=raw_page,+ click=AsyncMock(return_value="#resolved-submit"),+ evaluate=AsyncMock(return_value=False),+ fill=AsyncMock(),+ keyboard=SimpleNamespace(press=AsyncMock()),+ locator=MagicMock(return_value=locator),+ select_option=AsyncMock(),+ type=AsyncMock(),+ )+ context = BrowserContext(mode=mode, session_id=session_id)+ set_current_session(SessionState(context=context, api_key_hash=api_key_hash))+ monkeypatch.setattr(mcp_browser, "get_page", AsyncMock(return_value=(page, context)))+ monkeypatch.setattr(mcp_browser, "select_native_option_if_targeted", AsyncMock(return_value=None))+ monkeypatch.setenv("SKYVERN_DISABLE_CUSTOM_SELECT", "1")+ return page+++async def test_browser_actions_round_trip_through_trajectory_get_and_synthesize(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ page = _patch_browser_page(monkeypatch, session_id="pbs_roundtrip")++ async def _click(**_: object) -> str:+ page.url = "https://example.com/results"+ return "#resolved-submit"++ page.click = AsyncMock(side_effect=_click)++ click_result = await mcp_browser.skyvern_click(selector="#submit")+ type_result = await mcp_browser.skyvern_type(text="widget", selector="#search")+ select_result = await mcp_browser.skyvern_select_option(value="west", selector="#region")+ press_result = await mcp_browser.skyvern_press_key(key="Enter", selector="#search")++ assert all(result["ok"] is True for result in (click_result, type_result, select_result, press_result))+ trajectory_result = await mcp_trajectory.skyvern_trajectory_get("pbs_roundtrip")+ entries = json.loads(trajectory_result["data"]["trajectory_json"])+ assert entries == [+ {+ "tool_name": "click",+ "selector": "#resolved-submit",+ "source_url": "https://example.com/catalog",+ },+ {+ "tool_name": "type_text",+ "selector": "#search",+ "source_url": "https://example.com/results",+ "typed_value": "widget",+ "typed_length": 6,+ },+ {+ "tool_name": "select_option",+ "selector": "#region",+ "value": "west",+ "source_url": "https://example.com/results",+ },+ {+ "tool_name": "press_key",+ "key": "Enter",+ "selector": "#search",+ "source_url": "https://example.com/results",+ },+ ]+ assert trajectory_result["data"]["entry_count"] == 4+ assert trajectory_result["data"]["truncated"] is False+ assert trajectory_result["data"]["capture_status"] == "found"++ synthesis_result = await skyvern_code_block_synthesize(trajectory_result["data"]["trajectory_json"])+ assert synthesis_result["ok"] is True+ assert synthesis_result["data"]["code"].strip()+++async def test_native_option_click_records_executed_select(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_native_option")+ monkeypatch.setattr(+ mcp_browser,+ "select_native_option_if_targeted",+ AsyncMock(+ return_value=NativeOptionSelection(+ select_selector="#region",+ value="east",+ label="East",+ selected_by="value",+ )+ ),+ )++ result = await mcp_browser.skyvern_click(selector="#region > option")++ assert result["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_native_option") == (+ [+ {+ "tool_name": "select_option",+ "selector": "#region",+ "source_url": "https://example.com/catalog",+ "value": "east",+ }+ ],+ False,+ True,+ )+++async def test_secret_shaped_native_option_value_is_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ secret = "sk-test-secret-value"+ assert typed_text_looks_secret(secret)+ _patch_browser_page(monkeypatch, session_id="pbs_native_secret_option")+ monkeypatch.setattr(+ mcp_browser,+ "select_native_option_if_targeted",+ AsyncMock(+ return_value=NativeOptionSelection(+ select_selector="#region",+ value=secret,+ label="Secret",+ selected_by="value",+ )+ ),+ )++ result = await mcp_browser.skyvern_click(selector="#region > option")++ assert result["ok"] is True+ assert result["data"]["selected_option"]["value"] == secret+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_native_secret_option")+ assert (entries, truncated, found) == ([], False, False)+ assert secret not in json.dumps(entries)+++async def test_index_or_label_native_selection_is_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_native_index")+ selections = [+ NativeOptionSelection(select_selector="#region", value=None, label="East", index=2, selected_by="index"),+ NativeOptionSelection(select_selector="#region", value="east", label="East", index=2, selected_by="index"),+ NativeOptionSelection(select_selector="#region", value="east", label="East", selected_by="label"),+ NativeOptionSelection(select_selector="#region", value="", label="East", selected_by="value"),+ NativeOptionSelection(select_selector="#region", value=" ", label="East", selected_by="value"),+ NativeOptionSelection(select_selector="#region", value=" east ", label="East", selected_by="value"),+ ]+ for selection in selections:+ monkeypatch.setattr(mcp_browser, "select_native_option_if_targeted", AsyncMock(return_value=selection))+ result = await mcp_browser.skyvern_click(selector="#region > option")+ assert result["ok"] is True++ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_native_index") == ([], False, False)+++async def test_hybrid_ai_fallback_actions_are_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_hybrid_variants")++ hybrid_type = await mcp_browser.skyvern_type(text="widget", selector="#search", intent="the search field")+ hybrid_select = await mcp_browser.skyvern_select_option(+ value="west", selector="#region", intent="the region dropdown"+ )+ hybrid_press = await mcp_browser.skyvern_press_key(key="Enter", selector="#search", intent="the search field")++ assert all(result["ok"] is True for result in (hybrid_type, hybrid_select, hybrid_press))+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_hybrid_variants") == ([], False, False)+++async def test_direct_mode_with_intent_still_records(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_direct_intent")++ direct_type = await mcp_browser.skyvern_type(+ text="widget", selector="#search", intent="the search field", selector_mode="direct"+ )+ direct_select = await mcp_browser.skyvern_select_option(+ value="west", selector="#region", intent="the region dropdown", selector_mode="direct"+ )++ assert direct_type["ok"] is True+ assert direct_select["ok"] is True+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_direct_intent")+ assert truncated is False+ assert found is True+ assert [(entry["tool_name"], entry["selector"]) for entry in entries] == [+ ("type_text", "#search"),+ ("select_option", "#region"),+ ]+++async def test_unfaithful_action_variants_are_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_type_variants")++ append_type = await mcp_browser.skyvern_type(text="widget", selector="#search", clear=False)+ intent_type = await mcp_browser.skyvern_type(text="widget", intent="the search field")++ assert append_type["ok"] is True+ assert intent_type["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_type_variants") == ([], False, False)+++async def test_custom_widget_selection_is_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_custom_select")+ monkeypatch.delenv("SKYVERN_DISABLE_CUSTOM_SELECT")+ monkeypatch.setattr(mcp_browser, "do_select_option", AsyncMock(return_value="Music"))++ result = await mcp_browser.skyvern_select_option(selector="#category", value="music")++ assert result["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_custom_select") == ([], False, False)+++async def test_unreplayable_select_values_are_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_select_values")++ empty_value = await mcp_browser.skyvern_select_option(value="", selector="#region")+ padded_value = await mcp_browser.skyvern_select_option(value=" west ", selector="#region")++ assert empty_value["ok"] is True+ assert padded_value["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_select_values") == ([], False, False)+++async def test_secret_shaped_select_value_is_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ secret = "sk-test-secret-value"+ assert typed_text_looks_secret(secret)+ _patch_browser_page(monkeypatch, session_id="pbs_secret_select")++ result = await mcp_browser.skyvern_select_option(value=secret, selector="#region")++ assert result["ok"] is True+ assert result["data"]["value"] == secret+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_secret_select")+ assert (entries, truncated, found) == ([], False, False)+ assert secret not in json.dumps(entries)+++async def test_by_label_selection_is_not_recorded(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_select_label")++ result = await mcp_browser.skyvern_select_option(selector="#region", value="East", by_label=True)++ assert result["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_select_label") == ([], False, False)+++async def test_click_only_records_plain_left_click(monkeypatch: pytest.MonkeyPatch) -> None:+ page = _patch_browser_page(monkeypatch, session_id="pbs_click_variants")++ double_click = await mcp_browser.skyvern_click(selector="#submit", click_count=2)+ right_click = await mcp_browser.skyvern_click(selector="#submit", button="right")+ left_click = await mcp_browser.skyvern_click(selector="#submit", button="left")+ page.click.return_value = None+ unresolved_click = await mcp_browser.skyvern_click(intent="the submit button")++ assert all(result["ok"] is True for result in (double_click, right_click, left_click, unresolved_click))+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_click_variants") == (+ [+ {+ "tool_name": "click",+ "selector": "#resolved-submit",+ "source_url": "https://example.com/catalog",+ }+ ],+ False,+ True,+ )+++async def test_click_ai_fallback_only_records_resolved_selector(monkeypatch: pytest.MonkeyPatch) -> None:+ page = _patch_browser_page(monkeypatch, session_id="pbs_click_variants")+ page.click = AsyncMock(side_effect=[None, "#resolved-submit"])++ unresolved = await mcp_browser.skyvern_click(selector="#stale-submit", intent="the submit button")+ resolved = await mcp_browser.skyvern_click(selector="#stale-submit", intent="the submit button")++ assert unresolved["ok"] is True+ assert resolved["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_click_variants") == (+ [+ {+ "tool_name": "click",+ "selector": "#resolved-submit",+ "source_url": "https://example.com/catalog",+ }+ ],+ False,+ True,+ )+++async def test_press_key_skips_intent_only_and_keeps_page_level(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_press_variants")++ intent_press = await mcp_browser.skyvern_press_key(key="Enter", intent="the search field")+ page_press = await mcp_browser.skyvern_press_key(key="Escape")+ blank_intent_press = await mcp_browser.skyvern_press_key(key="Enter", selector="#search", intent="")++ assert intent_press["ok"] is True+ assert page_press["ok"] is True+ assert blank_intent_press["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_press_variants") == (+ [+ {+ "tool_name": "press_key",+ "key": "Escape",+ "source_url": "https://example.com/catalog",+ },+ {+ "tool_name": "press_key",+ "key": "Enter",+ "selector": "#search",+ "source_url": "https://example.com/catalog",+ },+ ],+ False,+ True,+ )+++async def test_press_key_only_records_named_keys(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_press_variants")++ character_results = [+ await mcp_browser.skyvern_press_key(key=key, selector="#otp") for key in ("1", "2", "3", "Shift+1")+ ]++ assert all(result["ok"] is True for result in character_results)+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_press_variants") == ([], False, False)++ named_results = [+ await mcp_browser.skyvern_press_key(key=key, selector="#search") for key in ("Enter", "Control+Enter", "F1")+ ]++ assert all(result["ok"] is True for result in named_results)+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_press_variants")+ assert truncated is False+ assert found is True+ assert [entry["key"] for entry in entries] == ["Enter", "Control+Enter", "F1"]+++async def test_sessionless_browser_action_does_not_capture(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id=None, mode="local")+ append = Mock()+ monkeypatch.setattr(mcp_browser, "append_trajectory_entry", append)++ result = await mcp_browser.skyvern_click(selector="#submit")++ assert result["ok"] is True+ append.assert_not_called()+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_sessionless") == ([], False, False)+++async def test_failed_browser_action_does_not_capture(monkeypatch: pytest.MonkeyPatch) -> None:+ page = _patch_browser_page(monkeypatch, session_id="pbs_failed_action")+ page.click = AsyncMock(side_effect=RuntimeError("click failed"))++ result = await mcp_browser.skyvern_click(selector="#submit")++ assert result["ok"] is False+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_failed_action") == ([], False, False)+++async def test_empty_type_preserves_zero_typed_length(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_empty_type")++ result = await mcp_browser.skyvern_type(text="", selector="#search")++ assert result["ok"] is True+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_empty_type")+ assert truncated is False+ assert found is True+ assert entries == [+ {+ "tool_name": "type_text",+ "selector": "#search",+ "source_url": "https://example.com/catalog",+ "typed_length": 0,+ }+ ]+++async def test_trajectory_get_uses_active_principal_instead_of_stored_session(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_isolation",+ entry={"tool_name": "click", "selector": "#submit"},+ )+ set_current_session(SessionState(api_key_hash=_HASH_A))+ active_key = ["key-b"]+ monkeypatch.setattr(session_manager, "get_active_api_key", lambda: active_key[0])++ foreign = await mcp_trajectory.skyvern_trajectory_get("pbs_isolation")+ never_existed = await mcp_trajectory.skyvern_trajectory_get("pbs_never_existed")+ assert foreign == never_existed+ assert foreign["data"] == {+ "trajectory_json": "[]",+ "entry_count": 0,+ "truncated": False,+ "capture_status": "not_found",+ }++ active_key[0] = "key-a"+ owner = await mcp_trajectory.skyvern_trajectory_get("pbs_isolation")+ assert owner["data"]["entry_count"] == 1+ assert owner["data"]["capture_status"] == "found"+++async def test_expired_trajectory_reports_not_found(monkeypatch: pytest.MonkeyPatch) -> None:+ now = [100.0]+ monkeypatch.setattr(trajectory_store, "TTL_SECONDS", 10)+ monkeypatch.setattr(trajectory_store.time, "monotonic", lambda: now[0])+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_expired",+ entry={"tool_name": "click", "selector": "#submit"},+ )+ set_current_session(SessionState(api_key_hash=_HASH_A))+ now[0] = 111.0++ result = await mcp_trajectory.skyvern_trajectory_get("pbs_expired")++ assert result["data"] == {+ "trajectory_json": "[]",+ "entry_count": 0,+ "truncated": False,+ "capture_status": "not_found",+ }+++async def test_explicit_session_close_deletes_trajectory(monkeypatch: pytest.MonkeyPatch) -> None:+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_close_explicit",+ entry={"tool_name": "click", "selector": "#submit"},+ )+ append_trajectory_entry(+ api_key_hash=_HASH_B,+ session_id="pbs_close_explicit",+ entry={"tool_name": "click", "selector": "#other-principal"},+ )+ set_current_session(SessionState(api_key_hash=_HASH_A))+ fake_skyvern = SimpleNamespace(get_browser_session=AsyncMock(side_effect=RuntimeError("not retained")))+ monkeypatch.setattr(mcp_session, "get_skyvern", lambda: fake_skyvern)+ monkeypatch.setattr(+ mcp_session,+ "do_session_close",+ AsyncMock(return_value=SessionCloseResult(session_id="pbs_close_explicit", closed=True)),+ )++ result = await mcp_session.skyvern_browser_session_close(session_id="pbs_close_explicit")++ assert result["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_close_explicit") == ([], False, False)+ assert get_trajectory(api_key_hash=_HASH_B, session_id="pbs_close_explicit") == ([], False, False)+++async def test_failed_backend_close_preserves_trajectory(monkeypatch: pytest.MonkeyPatch) -> None:+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_close_refused",+ entry={"tool_name": "click", "selector": "#submit"},+ )+ set_current_session(SessionState(api_key_hash=_HASH_A))+ monkeypatch.setattr(mcp_session, "get_skyvern", lambda: SimpleNamespace())+ monkeypatch.setattr(mcp_session, "do_session_close", AsyncMock(side_effect=RuntimeError("backend refused")))++ result = await mcp_session.skyvern_browser_session_close(session_id="pbs_close_refused")++ assert result["ok"] is False+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_close_refused") == (+ [{"tool_name": "click", "selector": "#submit"}],+ False,+ True,+ )+++async def test_current_session_close_deletes_trajectory(monkeypatch: pytest.MonkeyPatch) -> None:+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_close_current",+ entry={"tool_name": "click", "selector": "#submit"},+ )+ browser = MagicMock()+ browser._browser_session_id = "pbs_close_current"+ browser.close = AsyncMock()+ context = BrowserContext(mode="cloud_session", session_id="pbs_close_current")+ set_current_session(SessionState(browser=browser, context=context, api_key_hash=_HASH_A))+ fake_skyvern = SimpleNamespace(get_browser_session=AsyncMock(side_effect=RuntimeError("not retained")))+ monkeypatch.setattr(mcp_session, "get_skyvern", lambda: fake_skyvern)+ monkeypatch.setattr(session_manager, "get_skyvern", lambda: fake_skyvern)+ monkeypatch.setattr(+ "skyvern.cli.core.session_ops.do_session_close",+ AsyncMock(return_value=SessionCloseResult(session_id="pbs_close_current", closed=True)),+ )++ result = await mcp_session.skyvern_browser_session_close()++ assert result["ok"] is True+ assert get_trajectory(api_key_hash=_HASH_A, session_id="pbs_close_current") == ([], False, False)+++async def test_recorder_failure_is_logged_and_does_not_change_tool_result(monkeypatch: pytest.MonkeyPatch) -> None:+ _patch_browser_page(monkeypatch, session_id="pbs_passive")+ set_concise_responses(True)+ monkeypatch.setattr(mcp_browser, "append_trajectory_entry", Mock())+ baseline = await mcp_browser.skyvern_click(selector="#submit")++ reached = False++ class RecorderSentinel(RuntimeError):+ pass++ def _raise(**_: object) -> None:+ nonlocal reached+ reached = True+ raise RecorderSentinel("armed")++ warning = Mock()+ monkeypatch.setattr(mcp_browser, "append_trajectory_entry", _raise)+ monkeypatch.setattr(mcp_browser.LOG, "warning", warning)++ result = await mcp_browser.skyvern_click(selector="#submit")++ assert reached is True+ warning.assert_called_once()+ assert result == baseline+ assert result["ok"] is True+++async def test_secret_shaped_type_value_never_reaches_store_or_getter(monkeypatch: pytest.MonkeyPatch) -> None:+ secret = "sk-test-secret-value"+ assert typed_text_looks_secret(secret)+ _patch_browser_page(monkeypatch, session_id="pbs_secret")++ result = await mcp_browser.skyvern_type(text=secret, selector="#search")++ assert result["ok"] is True+ entries, truncated, found = get_trajectory(api_key_hash=_HASH_A, session_id="pbs_secret")+ assert truncated is False+ assert found is True+ assert entries == [+ {+ "tool_name": "type_text",+ "selector": "#search",+ "source_url": "https://example.com/catalog",+ "typed_length": len(secret),+ }+ ]+ serialized_store = json.dumps(entries)+ trajectory_result = await mcp_trajectory.skyvern_trajectory_get("pbs_secret")+ assert secret not in serialized_store+ assert secret not in trajectory_result["data"]["trajectory_json"]+ assert "raw_typed_value" not in trajectory_result["data"]["trajectory_json"]+++async def test_source_url_is_scrubbed_before_storage(monkeypatch: pytest.MonkeyPatch) -> None:+ secret = "abc123"+ _patch_browser_page(+ monkeypatch,+ session_id="pbs_source_url",+ source_url=f"https://example.com/page?session={secret}&q=widgets",+ )++ result = await mcp_browser.skyvern_click(selector="#submit")+ trajectory_result = await mcp_trajectory.skyvern_trajectory_get("pbs_source_url")++ assert result["ok"] is True+ trajectory_json = trajectory_result["data"]["trajectory_json"]+ assert "session=__redacted__" in trajectory_json+ assert "q=widgets" in trajectory_json+ assert secret not in trajectory_json+++async def test_password_selector_is_rejected_without_append(monkeypatch: pytest.MonkeyPatch) -> None:+ append = Mock()+ get_page = AsyncMock(side_effect=AssertionError("password rejection must happen before session resolution"))+ monkeypatch.setattr(mcp_browser, "append_trajectory_entry", append)+ monkeypatch.setattr(mcp_browser, "get_page", get_page)++ result = await mcp_browser.skyvern_type(text="not-stored", selector="#password")++ assert result["ok"] is False+ append.assert_not_called()+ get_page.assert_not_awaited()+++async def test_full_store_response_fits_mcp_transport_cap() -> None:+ from skyvern.cli.core.trajectory_store import MAX_BYTES+ from skyvern.cli.mcp_tools.response import MCP_MAX_RESPONSE_CHARS++ set_current_session(SessionState(api_key_hash=_HASH_A))+ # Quote/backslash-heavy values maximize JSON-in-JSON escaping inflation.+ hostile_value = ('"\\' + "x" * 6) * 100+ for index in range(300):+ append_trajectory_entry(+ api_key_hash=_HASH_A,+ session_id="pbs_transport_cap",+ entry={"tool_name": "type_text", "selector": f"#field-{index}", "typed_value": hostile_value},+ )++ result = await mcp_trajectory.skyvern_trajectory_get("pbs_transport_cap")++ assert result["data"]["truncated"] is True+ entries = json.loads(result["data"]["trajectory_json"])+ assert entries+ serialized = json.dumps(result)+ assert MAX_BYTES < MCP_MAX_RESPONSE_CHARS+ assert len(serialized) < MCP_MAX_RESPONSE_CHARS+++async def test_trajectory_get_preserves_all_data_keys_in_concise_mode() -> None:+ set_current_session(SessionState(api_key_hash=_HASH_A))+ set_concise_responses(True)++ result = await mcp_trajectory.skyvern_trajectory_get("pbs_concise")++ assert result == {+ "ok": True,+ "data": {+ "trajectory_json": "[]",+ "entry_count": 0,+ "truncated": False,+ "capture_status": "not_found",+ },+ }diff --git a/tests/unit/test_trajectory_store.py b/tests/unit/test_trajectory_store.pynew file mode 100644index 000000000..6b26144c8--- /dev/null+++ b/tests/unit/test_trajectory_store.py@@ -0,0 +1,229 @@+from collections.abc import Iterator++import pytest++from skyvern.cli.core import trajectory_store++[email protected](autouse=True)+def reset_trajectory_store() -> Iterator[None]:+ trajectory_store._trajectories.clear()+ yield+ trajectory_store._trajectories.clear()+++def test_append_and_get_trajectory() -> None:+ entry = {"tool_name": "click", "selector": "#submit"}++ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=entry)++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == ([entry], False, True)+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="unknown") == ([], False, False)+++def test_entry_count_overflow_drops_oldest_and_stays_truncated(monkeypatch: pytest.MonkeyPatch) -> None:+ monkeypatch.setattr(trajectory_store, "MAX_ENTRIES", 2)++ for index in range(3):+ trajectory_store.append_trajectory_entry(+ api_key_hash="hash-a",+ session_id="session-1",+ entry={"index": index},+ )++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (+ [{"index": 1}, {"index": 2}],+ True,+ True,+ )++ trajectory_store.append_trajectory_entry(+ api_key_hash="hash-a",+ session_id="session-1",+ entry={"index": 3},+ )+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (+ [{"index": 2}, {"index": 3}],+ True,+ True,+ )+++def test_byte_overflow_drops_oldest(monkeypatch: pytest.MonkeyPatch) -> None:+ first = {"value": "first"}+ second = {"value": "second"}+ max_single_entry_bytes = max(+ trajectory_store._json_size([first]),+ trajectory_store._json_size([second]),+ )+ monkeypatch.setattr(trajectory_store, "MAX_BYTES", max_single_entry_bytes)++ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=first)+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=second)++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == ([second], True, True)+++def test_single_oversize_entry_is_dropped_and_sets_truncated(monkeypatch: pytest.MonkeyPatch) -> None:+ small = {"value": "ok"}+ oversized = {"value": "x" * 100}+ monkeypatch.setattr(trajectory_store, "MAX_BYTES", trajectory_store._json_size([small]))++ trajectory_store.append_trajectory_entry(api_key_hash=None, session_id="session-1", entry=oversized)+ assert trajectory_store.get_trajectory(api_key_hash=None, session_id="session-1") == ([], True, True)++ trajectory_store.append_trajectory_entry(api_key_hash=None, session_id="session-1", entry=small)+ assert trajectory_store.get_trajectory(api_key_hash=None, session_id="session-1") == ([small], True, True)+++def test_single_oversize_entry_preserves_existing_history(monkeypatch: pytest.MonkeyPatch) -> None:+ history = [{"value": "first"}, {"value": "second"}]+ oversized = {"value": "x" * 100}+ monkeypatch.setattr(trajectory_store, "MAX_BYTES", trajectory_store._json_size(history))++ for entry in history:+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=entry)+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=oversized)++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (history, True, True)+++def test_entries_are_copied_on_append_and_get() -> None:+ entry = {"nested": {"values": [1]}}+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=entry)++ entry["nested"]["values"].append(2)+ returned, _, found = trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1")+ assert found is True+ assert returned == [{"nested": {"values": [1]}}]++ returned[0]["nested"]["values"].append(3)+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (+ [{"nested": {"values": [1]}}],+ False,+ True,+ )+++def test_serialization_error_preserves_existing_history() -> None:+ entry = {"value": "kept"}+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry=entry)++ with pytest.raises(TypeError):+ trajectory_store.append_trajectory_entry(+ api_key_hash="hash-a",+ session_id="session-1",+ entry={"value": object()},+ )++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == ([entry], False, True)+++def test_ttl_uses_last_touch_and_sweeps_on_append_and_get(monkeypatch: pytest.MonkeyPatch) -> None:+ now = [100.0]+ monkeypatch.setattr(trajectory_store, "TTL_SECONDS", 10)+ monkeypatch.setattr(trajectory_store.time, "monotonic", lambda: now[0])++ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="active", entry={"value": 1})+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="stale", entry={"value": 2})++ now[0] = 109.0+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="active") == (+ [{"value": 1}],+ False,+ True,+ )++ now[0] = 111.0+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="fresh", entry={"value": 3})+ assert ("hash-a", "stale") not in trajectory_store._trajectories+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="active") == (+ [{"value": 1}],+ False,+ True,+ )++ now[0] = 122.0+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="active") == ([], False, False)+++def test_delete_trajectory() -> None:+ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry={"value": 1})++ trajectory_store.delete_trajectory(api_key_hash="hash-a", session_id="session-1")++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == ([], False, False)+++def test_same_session_id_is_isolated_by_api_key_hash() -> None:+ trajectory_store.append_trajectory_entry(+ api_key_hash="hash-a",+ session_id="shared-session",+ entry={"owner": "a"},+ )++ assert trajectory_store.get_trajectory(api_key_hash="hash-b", session_id="shared-session") == ([], False, False)+ assert trajectory_store.get_trajectory(api_key_hash=None, session_id="shared-session") == ([], False, False)+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="shared-session") == (+ [{"owner": "a"}],+ False,+ True,+ )+++def test_per_tenant_cap_self_evicts_without_touching_other_tenants(monkeypatch: pytest.MonkeyPatch) -> None:+ now = [100.0]+ monkeypatch.setattr(trajectory_store, "MAX_SESSIONS_PER_TENANT", 2)+ monkeypatch.setattr(trajectory_store.time, "monotonic", lambda: now[0])++ trajectory_store.append_trajectory_entry(api_key_hash="hash-b", session_id="other-tenant", entry={"value": 0})+ for index in range(3):+ now[0] += 1.0+ trajectory_store.append_trajectory_entry(+ api_key_hash="hash-a",+ session_id=f"session-{index}",+ entry={"value": index},+ )++ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-0") == ([], False, False)+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (+ [{"value": 1}],+ False,+ True,+ )+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-2") == (+ [{"value": 2}],+ False,+ True,+ )+ assert trajectory_store.get_trajectory(api_key_hash="hash-b", session_id="other-tenant") == (+ [{"value": 0}],+ False,+ True,+ )+++def test_global_cap_evicts_least_recently_touched_session(monkeypatch: pytest.MonkeyPatch) -> None:+ now = [100.0]+ monkeypatch.setattr(trajectory_store, "MAX_SESSIONS", 2)+ monkeypatch.setattr(trajectory_store.time, "monotonic", lambda: now[0])++ trajectory_store.append_trajectory_entry(api_key_hash="hash-a", session_id="session-1", entry={"value": 1})+ now[0] = 101.0+ trajectory_store.append_trajectory_entry(api_key_hash="hash-b", session_id="session-2", entry={"value": 2})+ now[0] = 102.0+ trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1")+ now[0] = 103.0+ trajectory_store.append_trajectory_entry(api_key_hash="hash-c", session_id="session-3", entry={"value": 3})++ assert trajectory_store.get_trajectory(api_key_hash="hash-b", session_id="session-2") == ([], False, False)+ assert trajectory_store.get_trajectory(api_key_hash="hash-a", session_id="session-1") == (+ [{"value": 1}],+ False,+ True,+ )+ assert trajectory_store.get_trajectory(api_key_hash="hash-c", session_id="session-3") == (+ [{"value": 3}],+ False,+ True,+ )diff --git a/uv.lock b/uv.lockindex 5bdd4aac9..c74fa71e0 100644--- a/uv.lock+++ b/uv.lock@@ -5797,7 +5797,7 @@ wheels = [[[package]]name = "skyvern"-version = "1.0.46"+version = "1.0.47"source = { editable = "." }dependencies = [{ name = "cachetools" },