everyrow 0.1.0__py3-none-any.whl

everyrow/__init__.py

@@ -0,0 +1,4 @@
+from everyrow.api_utils import create_client
+from everyrow.session import create_session
+
+__all__ = ["create_client", "create_session"]

everyrow/api_utils.py

@@ -0,0 +1,45 @@
+import os
+from typing import TypeVar
+
+from everyrow.constants import DEFAULT_EVERYROW_API_URL, EveryrowError
+from everyrow.generated.client import AuthenticatedClient
+from everyrow.generated.models.http_validation_error import HTTPValidationError
+from everyrow.generated.models.insufficient_balance_error import (
+    InsufficientBalanceError,
+)
+
+
+def create_client() -> AuthenticatedClient:
+    """Create an AuthenticatedClient from environment variables.
+
+    Reads EVERYROW_API_KEY and EVERYROW_API_URL from environment variables.
+
+    Returns:
+        AuthenticatedClient: A configured client instance
+
+    Raises:
+        ValueError: If EVERYROW_API_KEY is not set in environment
+    """
+    if "EVERYROW_API_KEY" not in os.environ:
+        raise ValueError("EVERYROW_API_KEY is not set; cannot initialize client")
+    return AuthenticatedClient(
+        base_url=os.environ.get("EVERYROW_API_URL", DEFAULT_EVERYROW_API_URL),
+        token=os.environ["EVERYROW_API_KEY"],
+        raise_on_unexpected_status=True,
+    )
+
+
+T = TypeVar("T")
+
+
+def handle_response[T](
+    response: T | HTTPValidationError | InsufficientBalanceError | None,
+) -> T:
+    if isinstance(response, HTTPValidationError):
+        raise EveryrowError(response.detail)
+    if isinstance(response, InsufficientBalanceError):
+        raise EveryrowError(response.message)
+    if response is None:
+        raise EveryrowError("Unknown error")
+
+    return response

everyrow/citations.py

@@ -0,0 +1,46 @@
+from copy import deepcopy
+from typing import Any
+
+from everyrow.generated.models import (
+    ArtifactGroupRecord,
+    AuxDataSourceBank,
+    StandaloneArtifactRecord,
+)
+from everyrow.generated.types import Unset
+
+
+def _render_citations(data: dict[str, Any], source_bank: AuxDataSourceBank) -> dict[str, Any]:
+    result = deepcopy(data)
+    for source_id, source_data in source_bank.to_dict().items():
+        for key, value in result.items():
+            if isinstance(value, str):
+                result[key] = value.replace(source_id, source_data["url"])
+            else:
+                result[key] = value
+    return result
+
+
+def render_citations_standalone(artifact: StandaloneArtifactRecord):
+    if isinstance(artifact.aux_data, Unset) or isinstance(artifact.aux_data.source_bank, Unset):
+        return artifact
+    source_bank = (
+        artifact.aux_data.source_bank
+    )  # create reference simply to make the type checker happy before deepcopy.
+    artifact = deepcopy(artifact)
+    artifact.data = _render_citations(artifact.data, source_bank)
+    return artifact
+
+
+def render_citations_group(artifact: ArtifactGroupRecord) -> ArtifactGroupRecord:
+    artifact = deepcopy(artifact)
+    new_artifacts = []
+    for artifact_item in artifact.artifacts:
+        if isinstance(artifact_item, StandaloneArtifactRecord):
+            item_to_add = render_citations_standalone(artifact_item)
+        elif isinstance(artifact_item, ArtifactGroupRecord):
+            item_to_add = render_citations_group(artifact_item)
+        else:
+            item_to_add = artifact_item
+        new_artifacts.append(item_to_add)
+    artifact.artifacts = new_artifacts
+    return artifact

everyrow/constants.py

@@ -0,0 +1,4 @@
+DEFAULT_EVERYROW_API_URL = "https://engine.futuresearch.ai"
+
+
+class EveryrowError(Exception): ...

everyrow/generated/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing FastAPI"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

everyrow/generated/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

everyrow/generated/api/default/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

everyrow/generated/api/default/continue_task_endpoint_tasks_continue_post.py

@@ -0,0 +1,208 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.continue_task_request import ContinueTaskRequest
+from ...models.http_validation_error import HTTPValidationError
+from ...models.insufficient_balance_error import InsufficientBalanceError
+from ...models.task_response import TaskResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: ContinueTaskRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks/continue",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | InsufficientBalanceError | TaskResponse | None:
+    if response.status_code == 200:
+        response_200 = TaskResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 402:
+        response_402 = InsufficientBalanceError.from_dict(response.json())
+
+        return response_402
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HTTPValidationError | InsufficientBalanceError | TaskResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: ContinueTaskRequest,
+) -> Response[HTTPValidationError | InsufficientBalanceError | TaskResponse]:
+    r"""Continue Task Endpoint
+
+     Continue a task by (re)-executing children in place.
+
+    Reason for continue: failed/revoked (\"failed\"), continue after preview (\"from_preview\")
+
+    For MAP tasks, this resets child artifacts and re-submits
+    only those children, keeping the existing task and successful results.
+
+    For non-MAP tasks, this returns an error as they cannot be continued.
+
+    Args:
+        body (ContinueTaskRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HTTPValidationError | InsufficientBalanceError | TaskResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: ContinueTaskRequest,
+) -> HTTPValidationError | InsufficientBalanceError | TaskResponse | None:
+    r"""Continue Task Endpoint
+
+     Continue a task by (re)-executing children in place.
+
+    Reason for continue: failed/revoked (\"failed\"), continue after preview (\"from_preview\")
+
+    For MAP tasks, this resets child artifacts and re-submits
+    only those children, keeping the existing task and successful results.
+
+    For non-MAP tasks, this returns an error as they cannot be continued.
+
+    Args:
+        body (ContinueTaskRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HTTPValidationError | InsufficientBalanceError | TaskResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: ContinueTaskRequest,
+) -> Response[HTTPValidationError | InsufficientBalanceError | TaskResponse]:
+    r"""Continue Task Endpoint
+
+     Continue a task by (re)-executing children in place.
+
+    Reason for continue: failed/revoked (\"failed\"), continue after preview (\"from_preview\")
+
+    For MAP tasks, this resets child artifacts and re-submits
+    only those children, keeping the existing task and successful results.
+
+    For non-MAP tasks, this returns an error as they cannot be continued.
+
+    Args:
+        body (ContinueTaskRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HTTPValidationError | InsufficientBalanceError | TaskResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    body: ContinueTaskRequest,
+) -> HTTPValidationError | InsufficientBalanceError | TaskResponse | None:
+    r"""Continue Task Endpoint
+
+     Continue a task by (re)-executing children in place.
+
+    Reason for continue: failed/revoked (\"failed\"), continue after preview (\"from_preview\")
+
+    For MAP tasks, this resets child artifacts and re-submits
+    only those children, keeping the existing task and successful results.
+
+    For non-MAP tasks, this returns an error as they cannot be continued.
+
+    Args:
+        body (ContinueTaskRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HTTPValidationError | InsufficientBalanceError | TaskResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

everyrow/generated/api/default/copy_artifacts_artifacts_copy_post.py

@@ -0,0 +1,166 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.copy_artifacts_request import CopyArtifactsRequest
+from ...models.copy_artifacts_response import CopyArtifactsResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: CopyArtifactsRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/artifacts/copy",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> CopyArtifactsResponse | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = CopyArtifactsResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[CopyArtifactsResponse | HTTPValidationError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: CopyArtifactsRequest,
+) -> Response[CopyArtifactsResponse | HTTPValidationError]:
+    """Copy Artifacts
+
+    Args:
+        body (CopyArtifactsRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CopyArtifactsResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: CopyArtifactsRequest,
+) -> CopyArtifactsResponse | HTTPValidationError | None:
+    """Copy Artifacts
+
+    Args:
+        body (CopyArtifactsRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CopyArtifactsResponse | HTTPValidationError
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: CopyArtifactsRequest,
+) -> Response[CopyArtifactsResponse | HTTPValidationError]:
+    """Copy Artifacts
+
+    Args:
+        body (CopyArtifactsRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CopyArtifactsResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    body: CopyArtifactsRequest,
+) -> CopyArtifactsResponse | HTTPValidationError | None:
+    """Copy Artifacts
+
+    Args:
+        body (CopyArtifactsRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CopyArtifactsResponse | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

everyrow/generated/api/default/copy_workflow_endpoint_workflows_copy_post.py

@@ -0,0 +1,166 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.copy_workflow_request import CopyWorkflowRequest
+from ...models.copy_workflow_response import CopyWorkflowResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: CopyWorkflowRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/workflows/copy",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> CopyWorkflowResponse | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = CopyWorkflowResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[CopyWorkflowResponse | HTTPValidationError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: CopyWorkflowRequest,
+) -> Response[CopyWorkflowResponse | HTTPValidationError]:
+    """Copy Workflow Endpoint
+
+    Args:
+        body (CopyWorkflowRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CopyWorkflowResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: CopyWorkflowRequest,
+) -> CopyWorkflowResponse | HTTPValidationError | None:
+    """Copy Workflow Endpoint
+
+    Args:
+        body (CopyWorkflowRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CopyWorkflowResponse | HTTPValidationError
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: CopyWorkflowRequest,
+) -> Response[CopyWorkflowResponse | HTTPValidationError]:
+    """Copy Workflow Endpoint
+
+    Args:
+        body (CopyWorkflowRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CopyWorkflowResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    body: CopyWorkflowRequest,
+) -> CopyWorkflowResponse | HTTPValidationError | None:
+    """Copy Workflow Endpoint
+
+    Args:
+        body (CopyWorkflowRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CopyWorkflowResponse | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed