archastro.platform.v1.resources.agent_routine_runs

  1# Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
  2# This file is auto-generated by @archastro/sdk-generator. Do not edit.
  3# Content hash: 3e91531f101a
  4
  5from __future__ import annotations
  6
  7import builtins
  8
  9from ...runtime.http_client import HttpClient, SyncHttpClient
 10from ...types.common import AgentRoutineRunListResponse
 11
 12
 13class AsyncAgentRoutineRunResource:
 14    def __init__(self, http: HttpClient):
 15        self._http = http
 16
 17    async def list(
 18        self,
 19        *,
 20        agent: builtins.list[str] | None = None,
 21        status: str | None = None,
 22        limit: int | None = None,
 23        before_cursor: str | None = None,
 24        after_cursor: str | None = None,
 25    ) -> AgentRoutineRunListResponse:
 26        """
 27        List agent routine runs
 28        Returns a paginated list of agent routine runs across all routines visible to
 29        the authenticated app scope. Results are ordered by creation time descending
 30        (most recent first).
 31        Use the `agent` parameter to filter runs to one or more specific agents. Use
 32        `status` to narrow results to runs in a particular state. Pagination is
 33        bidirectional: supply `after_cursor` to page forward through newer runs or
 34        `before_cursor` to page backward through older runs.
 35        This endpoint requires an app scope. Requests without a valid app credential
 36        return 403.
 37
 38        Args:
 39            agent: Filter by one or more agent IDs (`agi_...`) or `lookup_key` values. Repeat the parameter (e.g. `?agent[]=agi_a&agent[]=agi_b`) to OR multiple agents. Omit to return runs for all agents.
 40            status: Filter by run status. One of `"pending"`, `"running"`, `"completed"`, `"failed"`, `"skipped"`, or `"cancelled"`. Omit to return runs in any status.
 41            limit: Maximum number of runs to return. Defaults to 50; maximum is 100.
 42            before_cursor: Opaque cursor from a previous response's `before_cursor` field. Returns the page of runs older than that cursor position.
 43            after_cursor: Opaque cursor from a previous response's `after_cursor` field. Returns the page of runs newer than that cursor position.
 44
 45        Returns:
 46            Paginated list of agent routine runs.
 47        """
 48        query: dict[str, object] = {}
 49        if agent is not None:
 50            query["agent"] = agent
 51        if status is not None:
 52            query["status"] = status
 53        if limit is not None:
 54            query["limit"] = limit
 55        if before_cursor is not None:
 56            query["before_cursor"] = before_cursor
 57        if after_cursor is not None:
 58            query["after_cursor"] = after_cursor
 59        return await self._http.request(
 60            "/api/v1/agent_routine_runs",
 61            query=query,
 62            response_type=AgentRoutineRunListResponse,
 63        )
 64
 65
 66class AgentRoutineRunResource:
 67    def __init__(self, http: SyncHttpClient):
 68        self._http = http
 69
 70    def list(
 71        self,
 72        *,
 73        agent: builtins.list[str] | None = None,
 74        status: str | None = None,
 75        limit: int | None = None,
 76        before_cursor: str | None = None,
 77        after_cursor: str | None = None,
 78    ) -> AgentRoutineRunListResponse:
 79        """
 80        List agent routine runs
 81        Returns a paginated list of agent routine runs across all routines visible to
 82        the authenticated app scope. Results are ordered by creation time descending
 83        (most recent first).
 84        Use the `agent` parameter to filter runs to one or more specific agents. Use
 85        `status` to narrow results to runs in a particular state. Pagination is
 86        bidirectional: supply `after_cursor` to page forward through newer runs or
 87        `before_cursor` to page backward through older runs.
 88        This endpoint requires an app scope. Requests without a valid app credential
 89        return 403.
 90
 91        Args:
 92            agent: Filter by one or more agent IDs (`agi_...`) or `lookup_key` values. Repeat the parameter (e.g. `?agent[]=agi_a&agent[]=agi_b`) to OR multiple agents. Omit to return runs for all agents.
 93            status: Filter by run status. One of `"pending"`, `"running"`, `"completed"`, `"failed"`, `"skipped"`, or `"cancelled"`. Omit to return runs in any status.
 94            limit: Maximum number of runs to return. Defaults to 50; maximum is 100.
 95            before_cursor: Opaque cursor from a previous response's `before_cursor` field. Returns the page of runs older than that cursor position.
 96            after_cursor: Opaque cursor from a previous response's `after_cursor` field. Returns the page of runs newer than that cursor position.
 97
 98        Returns:
 99            Paginated list of agent routine runs.
100        """
101        query: dict[str, object] = {}
102        if agent is not None:
103            query["agent"] = agent
104        if status is not None:
105            query["status"] = status
106        if limit is not None:
107            query["limit"] = limit
108        if before_cursor is not None:
109            query["before_cursor"] = before_cursor
110        if after_cursor is not None:
111            query["after_cursor"] = after_cursor
112        return self._http.request(
113            "/api/v1/agent_routine_runs",
114            query=query,
115            response_type=AgentRoutineRunListResponse,
116        )