runloop_api_client 0.61.0__py3-none-any.whl

runloop_api_client/types/input_context_update_param.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["InputContextUpdateParam"]
+
+
+class InputContextUpdateParam(TypedDict, total=False):
+    additional_context: Optional[object]
+    """Additional JSON structured input context."""
+
+    problem_statement: Optional[str]
+    """The problem statement for the Scenario."""

runloop_api_client/types/object_create_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ObjectCreateParams"]
+
+
+class ObjectCreateParams(TypedDict, total=False):
+    content_type: Required[Literal["unspecified", "text", "binary", "gzip", "tar", "tgz"]]
+    """The content type of the Object."""
+
+    name: Required[str]
+    """The name of the Object."""
+
+    metadata: Optional[Dict[str, str]]
+    """User defined metadata to attach to the object for organization."""

runloop_api_client/types/object_download_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ObjectDownloadParams"]
+
+
+class ObjectDownloadParams(TypedDict, total=False):
+    duration_seconds: int
+    """Duration in seconds for the presigned URL validity (default: 3600)."""

runloop_api_client/types/object_download_url_view.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["ObjectDownloadURLView"]
+
+
+class ObjectDownloadURLView(BaseModel):
+    download_url: str
+    """The presigned download URL for the Object."""

runloop_api_client/types/object_list_params.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ObjectListParams"]
+
+
+class ObjectListParams(TypedDict, total=False):
+    content_type: str
+    """Filter objects by content type."""
+
+    limit: int
+    """The limit of items to return. Default is 20."""
+
+    name: str
+    """Filter objects by name (partial match supported)."""
+
+    search: str
+    """Search by object ID or name."""
+
+    starting_after: str
+    """Load the next page of data starting after the item with the given ID."""
+
+    state: str
+    """Filter objects by state (UPLOADING, READ_ONLY, DELETED)."""

runloop_api_client/types/object_list_public_params.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ObjectListPublicParams"]
+
+
+class ObjectListPublicParams(TypedDict, total=False):
+    content_type: str
+    """Filter objects by content type."""
+
+    limit: int
+    """The limit of items to return. Default is 20."""
+
+    name: str
+    """Filter objects by name (partial match supported)."""
+
+    search: str
+    """Search by object ID or name."""
+
+    starting_after: str
+    """Load the next page of data starting after the item with the given ID."""
+
+    state: str
+    """Filter objects by state (UPLOADING, READ_ONLY, DELETED)."""

runloop_api_client/types/object_list_view.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .object_view import ObjectView
+
+__all__ = ["ObjectListView"]
+
+
+class ObjectListView(BaseModel):
+    has_more: bool
+    """True if there are more results available beyond this page."""
+
+    objects: List[ObjectView]
+    """List of Object entities."""
+
+    remaining_count: int
+    """Number of Objects remaining after this page."""
+
+    total_count: int
+    """Total number of Objects across all pages."""

runloop_api_client/types/object_view.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ObjectView"]
+
+
+class ObjectView(BaseModel):
+    id: str
+    """The unique identifier of the Object."""
+
+    content_type: Literal["unspecified", "text", "binary", "gzip", "tar", "tgz"]
+    """The content type of the Object."""
+
+    name: str
+    """The name of the Object."""
+
+    state: str
+    """The current state of the Object."""
+
+    size_bytes: Optional[int] = None
+    """The size of the Object content in bytes (null until uploaded)."""
+
+    upload_url: Optional[str] = None
+    """Presigned URL for uploading content to S3 (only present on create)."""

runloop_api_client/types/repository_connection_list_view.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .repository_connection_view import RepositoryConnectionView
+
+__all__ = ["RepositoryConnectionListView"]
+
+
+class RepositoryConnectionListView(BaseModel):
+    has_more: bool
+
+    remaining_count: int
+
+    repositories: List[RepositoryConnectionView]
+    """List of repositories matching filter."""
+
+    total_count: int

runloop_api_client/types/repository_connection_view.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["RepositoryConnectionView"]
+
+
+class RepositoryConnectionView(BaseModel):
+    id: str
+    """The ID of the Repository."""
+
+    name: str
+    """The name of the Repository."""
+
+    owner: str
+    """The account owner of the Repository."""

runloop_api_client/types/repository_create_params.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Required, TypedDict
+
+__all__ = ["RepositoryCreateParams"]
+
+
+class RepositoryCreateParams(TypedDict, total=False):
+    name: Required[str]
+    """Name of the repository."""
+
+    owner: Required[str]
+    """Account owner of the repository."""
+
+    blueprint_id: Optional[str]
+    """ID of blueprint to use as base for resulting RepositoryVersion blueprint."""
+
+    github_auth_token: Optional[str]
+    """GitHub authentication token for accessing private repositories."""

runloop_api_client/types/repository_inspection_details.py

@@ -0,0 +1,77 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .repository_manifest_view import RepositoryManifestView
+
+__all__ = ["RepositoryInspectionDetails", "WorkflowContexts", "WorkflowContextsActionsContext"]
+
+
+class WorkflowContextsActionsContext(BaseModel):
+    actions_skipped_unnecessary: List[str]
+    """
+    Actions that were skipped because they were unnecessary (e.g., upload
+    artifacts).
+    """
+
+    actions_taken: List[str]
+    """Actions that were translated into commands and executed."""
+
+    actions_unknown: List[str]
+    """
+    Actions that were not understood and skipped because we did not know what to do.
+    """
+
+
+class WorkflowContexts(BaseModel):
+    actions_context: WorkflowContextsActionsContext
+    """Details about actions processing for this workflow."""
+
+    file_name: str
+    """The file name of the workflow."""
+
+
+class RepositoryInspectionDetails(BaseModel):
+    id: str
+    """The ID of the inspection."""
+
+    commit_sha: str
+    """The sha of the inspected version of the Repository."""
+
+    inspected_at: int
+    """Inspection time of the Repository Version (Unix timestamp milliseconds)."""
+
+    repository_manifest: RepositoryManifestView
+    """Repository manifest containing container config and workspace details."""
+
+    status: Literal[
+        "invalid",
+        "repo_auth_pending",
+        "repo_authentication_failure",
+        "repo_access_failure",
+        "inspection_pending",
+        "inspection_failed",
+        "inspection_success",
+        "inspection_user_manifest_added",
+    ]
+    """The status of the repository inspection."""
+
+    blueprint_id: Optional[str] = None
+    """The blueprint ID associated with this inspection if successful."""
+
+    blueprint_name: Optional[str] = None
+    """The blueprint name associated with this inspection if successful."""
+
+    build_status: Optional[Literal["image_building", "image_build_success", "image_build_failure"]] = None
+    """The status of the linked Blueprint build."""
+
+    user_manifest: Optional[RepositoryManifestView] = None
+    """
+    User uploaded repository manifest containing container config and workspace
+    details.
+    """
+
+    workflow_contexts: Optional[Dict[str, WorkflowContexts]] = None
+    """Workflow contexts mapping workflow names to their processing details."""

runloop_api_client/types/repository_inspection_list_view.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .repository_inspection_details import RepositoryInspectionDetails
+
+__all__ = ["RepositoryInspectionListView"]
+
+
+class RepositoryInspectionListView(BaseModel):
+    inspections: List[RepositoryInspectionDetails]
+    """List of inspections for this repository."""

runloop_api_client/types/repository_list_params.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["RepositoryListParams"]
+
+
+class RepositoryListParams(TypedDict, total=False):
+    limit: int
+    """The limit of items to return. Default is 20."""
+
+    name: str
+    """Filter by repository name"""
+
+    owner: str
+    """Filter by repository owner"""
+
+    starting_after: str
+    """Load the next page of data starting after the item with the given ID."""

runloop_api_client/types/repository_manifest_view.py

@@ -0,0 +1,158 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = [
+    "RepositoryManifestView",
+    "ContainerConfig",
+    "Language",
+    "Workspace",
+    "WorkspaceDevCommands",
+    "ContainerizedService",
+    "ContainerizedServiceCredentials",
+]
+
+
+class ContainerConfig(BaseModel):
+    base_image_name: str
+    """The name of the base image.
+
+    Should be one of the GitHub public images like ubuntu-latest, ubuntu-24.04,
+    ubuntu-22.04, windows-latest, windows-2022, macos-latest etc.
+    """
+
+    architecture: Optional[Literal["x86_64", "arm64"]] = None
+    """The target architecture for the Repository Container."""
+
+    setup_commands: Optional[List[str]] = None
+    """
+    Commands to run to setup the base container such as installing necessary
+    toolchains (e.g. apt install).
+    """
+
+
+class Language(BaseModel):
+    language: Optional[str] = None
+
+    version: Optional[str] = None
+
+
+class WorkspaceDevCommands(BaseModel):
+    build: Optional[List[str]] = None
+    """Build command (e.g. npm run build)."""
+
+    install: Optional[List[str]] = None
+    """Installation command (e.g. pip install -r requirements.txt)."""
+
+    lint: Optional[List[str]] = None
+    """Lint command (e.g. flake8)."""
+
+    scripts: Optional[List[str]] = None
+    """Script commands."""
+
+    test: Optional[List[str]] = None
+    """Test command (e.g. pytest)."""
+
+
+class Workspace(BaseModel):
+    build_tool: List[str]
+    """Name of the build tool used (e.g. pip, npm)."""
+
+    dev_commands: Optional[WorkspaceDevCommands] = None
+    """
+    Extracted common commands important to the developer life cycle like linting,
+    testing, building, etc.
+    """
+
+    name: Optional[str] = None
+    """Name of the workspace.
+
+    Can be empty if the workspace is the root of the repository. Only necessary for
+    monorepo style repositories.
+    """
+
+    path: Optional[str] = None
+    """Path to the workspace from the root of the repository.
+
+    Can be empty if the workspace is the root of the repository. Only necessary for
+    monorepo style repositories.
+    """
+
+    workspace_refresh_commands: Optional[List[str]] = None
+    """
+    Commands to run to refresh this workspace after pulling the latest changes to
+    the repository via git (e.g. npm install).
+    """
+
+    workspace_setup_commands: Optional[List[str]] = None
+    """
+    Commands to run to setup this workspace after a fresh clone of the repository on
+    a new container such as installing necessary toolchains and dependencies (e.g.
+    npm install).
+    """
+
+
+class ContainerizedServiceCredentials(BaseModel):
+    password: str
+    """The password of the container service."""
+
+    username: str
+    """The username of the container service."""
+
+
+class ContainerizedService(BaseModel):
+    image: str
+    """The image of the container service."""
+
+    name: str
+    """The name of the container service."""
+
+    credentials: Optional[ContainerizedServiceCredentials] = None
+    """The credentials of the container service."""
+
+    env: Optional[Dict[str, str]] = None
+    """The environment variables of the container service."""
+
+    options: Optional[str] = None
+    """Additional Docker container create options."""
+
+    port_mappings: Optional[List[str]] = None
+    """The port mappings of the container service.
+
+    Port mappings are in the format of <host_port>:<container_port>.
+    """
+
+
+class RepositoryManifestView(BaseModel):
+    container_config: ContainerConfig
+    """Container configuration specifying the base image and setup commands."""
+
+    languages: List[Language]
+    """List of required languages found in Repository."""
+
+    workspaces: List[Workspace]
+    """List of workspaces within the repository.
+
+    Each workspace represents a buildable unit of code.
+    """
+
+    containerized_services: Optional[List[ContainerizedService]] = None
+    """List of discovered ContainerizedServices.
+
+    Services can be explicitly started when creating a Devbox.
+    """
+
+    env_vars: Optional[Dict[str, str]] = None
+    """
+    Qualified environment variables and values that should be set for this
+    repository to run correctly.
+    """
+
+    required_env_vars: Optional[List[str]] = None
+    """
+    Missing environment variables that (may) be required for this repository to run
+    correctly.
+    """

runloop_api_client/types/repository_refresh_params.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["RepositoryRefreshParams"]
+
+
+class RepositoryRefreshParams(TypedDict, total=False):
+    blueprint_id: Optional[str]
+    """ID of blueprint to use as base for resulting RepositoryVersion blueprint."""
+
+    github_auth_token: Optional[str]
+    """GitHub authentication token for accessing private repositories."""

runloop_api_client/types/scenario_create_params.py

@@ -0,0 +1,53 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .._types import SequenceNotStr
+from .input_context_param import InputContextParam
+from .scoring_contract_param import ScoringContractParam
+from .scenario_environment_param import ScenarioEnvironmentParam
+
+__all__ = ["ScenarioCreateParams"]
+
+
+class ScenarioCreateParams(TypedDict, total=False):
+    input_context: Required[InputContextParam]
+    """The input context for the Scenario."""
+
+    name: Required[str]
+    """Name of the scenario."""
+
+    scoring_contract: Required[ScoringContractParam]
+    """The scoring contract for the Scenario."""
+
+    environment_parameters: Optional[ScenarioEnvironmentParam]
+    """The Environment in which the Scenario will run."""
+
+    metadata: Optional[Dict[str, str]]
+    """User defined metadata to attach to the scenario for organization."""
+
+    reference_output: Optional[str]
+    """A string representation of the reference output to solve the scenario.
+
+    Commonly can be the result of a git diff or a sequence of command actions to
+    apply to the environment.
+    """
+
+    required_environment_variables: Optional[SequenceNotStr[str]]
+    """Environment variables required to run the scenario.
+
+    If these variables are not provided, the scenario will fail to start.
+    """
+
+    required_secret_names: Optional[SequenceNotStr[str]]
+    """
+    Secrets required to run the scenario (user secret name to scenario required
+    secret name). If these secrets are not provided or the mapping is incorrect, the
+    scenario will fail to start.
+    """
+
+    validation_type: Optional[Literal["UNSPECIFIED", "FORWARD", "REVERSE", "EVALUATION"]]
+    """Validation strategy."""

runloop_api_client/types/scenario_definition_list_view.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .scenario_view import ScenarioView
+
+__all__ = ["ScenarioDefinitionListView"]
+
+
+class ScenarioDefinitionListView(BaseModel):
+    has_more: bool
+
+    remaining_count: int
+
+    scenarios: List[ScenarioView]
+    """List of Scenarios matching filter."""
+
+    total_count: int

runloop_api_client/types/scenario_environment.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .shared.launch_parameters import LaunchParameters
+
+__all__ = ["ScenarioEnvironment"]
+
+
+class ScenarioEnvironment(BaseModel):
+    blueprint_id: Optional[str] = None
+    """Use the blueprint with matching ID."""
+
+    launch_parameters: Optional[LaunchParameters] = None
+    """Optional launch parameters to apply to the devbox environment at launch."""
+
+    snapshot_id: Optional[str] = None
+    """Use the snapshot with matching ID."""
+
+    working_directory: Optional[str] = None
+    """The working directory where the agent is expected to fulfill the scenario.
+
+    Scoring functions also run from the working directory.
+    """

runloop_api_client/types/scenario_environment_param.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from .shared_params.launch_parameters import LaunchParameters
+
+__all__ = ["ScenarioEnvironmentParam"]
+
+
+class ScenarioEnvironmentParam(TypedDict, total=False):
+    blueprint_id: Optional[str]
+    """Use the blueprint with matching ID."""
+
+    launch_parameters: Optional[LaunchParameters]
+    """Optional launch parameters to apply to the devbox environment at launch."""
+
+    snapshot_id: Optional[str]
+    """Use the snapshot with matching ID."""
+
+    working_directory: Optional[str]
+    """The working directory where the agent is expected to fulfill the scenario.
+
+    Scoring functions also run from the working directory.
+    """

runloop_api_client/types/scenario_list_params.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ScenarioListParams"]
+
+
+class ScenarioListParams(TypedDict, total=False):
+    benchmark_id: str
+    """Filter scenarios by benchmark ID."""
+
+    limit: int
+    """The limit of items to return. Default is 20."""
+
+    name: str
+    """Query for Scenarios with a given name."""
+
+    starting_after: str
+    """Load the next page of data starting after the item with the given ID."""