robosystems-client 2.2.1__tar.gz → 2.2.3__tar.gz

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: robosystems-client
-Version: 2.2.1
+Version: 2.2.3
 Summary: Python client library for the RoboSystems financial intelligence platform
 Project-URL: Homepage, https://robosystems.ai
 Project-URL: Documentation, https://robosystems.ai/docs/technical

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "robosystems-client"
-version = "2.2.1"
+version = "2.2.3"
 description = "Python client library for the RoboSystems financial intelligence platform"
 readme = "README.md"
 requires-python = ">=3.11"

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/robosystems_client/api/content_operations/ingest_file.py

@@ -113,7 +113,8 @@ def sync_detailed(
 
    Mark an uploaded file ready and stage it into DuckDB. Small files stage directly (sync); large files
   stage via a background job (returns a pending envelope with an `operation_id` to monitor). Set
-  `ingest_to_graph` to auto-materialize into the graph after staging.
+  `ingest_to_graph` to auto-materialize into the graph after staging; that write takes the graph's
+  materialize lock, so it returns 409 while another materialization of the graph is running.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -158,7 +159,8 @@ def sync(
 
    Mark an uploaded file ready and stage it into DuckDB. Small files stage directly (sync); large files
   stage via a background job (returns a pending envelope with an `operation_id` to monitor). Set
-  `ingest_to_graph` to auto-materialize into the graph after staging.
+  `ingest_to_graph` to auto-materialize into the graph after staging; that write takes the graph's
+  materialize lock, so it returns 409 while another materialization of the graph is running.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -198,7 +200,8 @@ async def asyncio_detailed(
 
    Mark an uploaded file ready and stage it into DuckDB. Small files stage directly (sync); large files
   stage via a background job (returns a pending envelope with an `operation_id` to monitor). Set
-  `ingest_to_graph` to auto-materialize into the graph after staging.
+  `ingest_to_graph` to auto-materialize into the graph after staging; that write takes the graph's
+  materialize lock, so it returns 409 while another materialization of the graph is running.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -241,7 +244,8 @@ async def asyncio(
 
    Mark an uploaded file ready and stage it into DuckDB. Small files stage directly (sync); large files
   stage via a background job (returns a pending envelope with an `operation_id` to monitor). Set
-  `ingest_to_graph` to auto-materialize into the graph after staging.
+  `ingest_to_graph` to auto-materialize into the graph after staging; that write takes the graph's
+  materialize lock, so it returns 409 while another materialization of the graph is running.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

robosystems_client-2.2.3/robosystems_client/api/graph_audit/list_graph_mutations.py

@@ -0,0 +1,381 @@
+import datetime
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error_response import ErrorResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...models.list_graph_mutations_surface_type_0 import ListGraphMutationsSurfaceType0
+from ...models.mutation_audit_list_response import MutationAuditListResponse
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+  graph_id: str,
+  *,
+  surface: ListGraphMutationsSurfaceType0 | None | Unset = UNSET,
+  operation_name: None | str | Unset = UNSET,
+  user_id: None | str | Unset = UNSET,
+  operation_id: None | str | Unset = UNSET,
+  since: datetime.datetime | None | Unset = UNSET,
+  until: datetime.datetime | None | Unset = UNSET,
+  cursor: None | str | Unset = UNSET,
+  limit: int | Unset = 50,
+) -> dict[str, Any]:
+
+  params: dict[str, Any] = {}
+
+  json_surface: None | str | Unset
+  if isinstance(surface, Unset):
+    json_surface = UNSET
+  elif isinstance(surface, ListGraphMutationsSurfaceType0):
+    json_surface = surface.value
+  else:
+    json_surface = surface
+  params["surface"] = json_surface
+
+  json_operation_name: None | str | Unset
+  if isinstance(operation_name, Unset):
+    json_operation_name = UNSET
+  else:
+    json_operation_name = operation_name
+  params["operation_name"] = json_operation_name
+
+  json_user_id: None | str | Unset
+  if isinstance(user_id, Unset):
+    json_user_id = UNSET
+  else:
+    json_user_id = user_id
+  params["user_id"] = json_user_id
+
+  json_operation_id: None | str | Unset
+  if isinstance(operation_id, Unset):
+    json_operation_id = UNSET
+  else:
+    json_operation_id = operation_id
+  params["operation_id"] = json_operation_id
+
+  json_since: None | str | Unset
+  if isinstance(since, Unset):
+    json_since = UNSET
+  elif isinstance(since, datetime.datetime):
+    json_since = since.isoformat()
+  else:
+    json_since = since
+  params["since"] = json_since
+
+  json_until: None | str | Unset
+  if isinstance(until, Unset):
+    json_until = UNSET
+  elif isinstance(until, datetime.datetime):
+    json_until = until.isoformat()
+  else:
+    json_until = until
+  params["until"] = json_until
+
+  json_cursor: None | str | Unset
+  if isinstance(cursor, Unset):
+    json_cursor = UNSET
+  else:
+    json_cursor = cursor
+  params["cursor"] = json_cursor
+
+  params["limit"] = limit
+
+  params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+  _kwargs: dict[str, Any] = {
+    "method": "get",
+    "url": "/v1/graphs/{graph_id}/audit/mutations".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
+    "params": params,
+  }
+
+  return _kwargs
+
+
+def _parse_response(
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ErrorResponse | HTTPValidationError | MutationAuditListResponse | None:
+  if response.status_code == 200:
+    response_200 = MutationAuditListResponse.from_dict(response.json())
+
+    return response_200
+
+  if response.status_code == 400:
+    response_400 = ErrorResponse.from_dict(response.json())
+
+    return response_400
+
+  if response.status_code == 401:
+    response_401 = ErrorResponse.from_dict(response.json())
+
+    return response_401
+
+  if response.status_code == 403:
+    response_403 = ErrorResponse.from_dict(response.json())
+
+    return response_403
+
+  if response.status_code == 404:
+    response_404 = ErrorResponse.from_dict(response.json())
+
+    return response_404
+
+  if response.status_code == 422:
+    response_422 = HTTPValidationError.from_dict(response.json())
+
+    return response_422
+
+  if response.status_code == 429:
+    response_429 = ErrorResponse.from_dict(response.json())
+
+    return response_429
+
+  if response.status_code == 500:
+    response_500 = ErrorResponse.from_dict(response.json())
+
+    return response_500
+
+  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[ErrorResponse | HTTPValidationError | MutationAuditListResponse]:
+  return Response(
+    status_code=HTTPStatus(response.status_code),
+    content=response.content,
+    headers=response.headers,
+    parsed=_parse_response(client=client, response=response),
+  )
+
+
+def sync_detailed(
+  graph_id: str,
+  *,
+  client: AuthenticatedClient,
+  surface: ListGraphMutationsSurfaceType0 | None | Unset = UNSET,
+  operation_name: None | str | Unset = UNSET,
+  user_id: None | str | Unset = UNSET,
+  operation_id: None | str | Unset = UNSET,
+  since: datetime.datetime | None | Unset = UNSET,
+  until: datetime.datetime | None | Unset = UNSET,
+  cursor: None | str | Unset = UNSET,
+  limit: int | Unset = 50,
+) -> Response[ErrorResponse | HTTPValidationError | MutationAuditListResponse]:
+  """List Graph Mutations
+
+   Every call that changed this graph, newest first: REST operations, external MCP clients, and in-app
+  AI operator runs. Each entry names the operation, the outcome, who made it and with which
+  credential, and the objects it touched. Arguments are not stored, only their SHA-256 fingerprint.
+  Requires graph admin.
+
+  Args:
+      graph_id (str): Graph identifier
+      surface (ListGraphMutationsSurfaceType0 | None | Unset): Only calls from this surface
+      operation_name (None | str | Unset): Only this operation or MCP tool
+      user_id (None | str | Unset): Only calls made as this user
+      operation_id (None | str | Unset): Only calls from this REST operation or operator run
+      since (datetime.datetime | None | Unset): Only calls at or after this time
+      until (datetime.datetime | None | Unset): Only calls before this time
+      cursor (None | str | Unset): The `next_cursor` of the previous page
+      limit (int | Unset): Entries per page Default: 50.
+
+  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[ErrorResponse | HTTPValidationError | MutationAuditListResponse]
+  """
+
+  kwargs = _get_kwargs(
+    graph_id=graph_id,
+    surface=surface,
+    operation_name=operation_name,
+    user_id=user_id,
+    operation_id=operation_id,
+    since=since,
+    until=until,
+    cursor=cursor,
+    limit=limit,
+  )
+
+  response = client.get_httpx_client().request(
+    **kwargs,
+  )
+
+  return _build_response(client=client, response=response)
+
+
+def sync(
+  graph_id: str,
+  *,
+  client: AuthenticatedClient,
+  surface: ListGraphMutationsSurfaceType0 | None | Unset = UNSET,
+  operation_name: None | str | Unset = UNSET,
+  user_id: None | str | Unset = UNSET,
+  operation_id: None | str | Unset = UNSET,
+  since: datetime.datetime | None | Unset = UNSET,
+  until: datetime.datetime | None | Unset = UNSET,
+  cursor: None | str | Unset = UNSET,
+  limit: int | Unset = 50,
+) -> ErrorResponse | HTTPValidationError | MutationAuditListResponse | None:
+  """List Graph Mutations
+
+   Every call that changed this graph, newest first: REST operations, external MCP clients, and in-app
+  AI operator runs. Each entry names the operation, the outcome, who made it and with which
+  credential, and the objects it touched. Arguments are not stored, only their SHA-256 fingerprint.
+  Requires graph admin.
+
+  Args:
+      graph_id (str): Graph identifier
+      surface (ListGraphMutationsSurfaceType0 | None | Unset): Only calls from this surface
+      operation_name (None | str | Unset): Only this operation or MCP tool
+      user_id (None | str | Unset): Only calls made as this user
+      operation_id (None | str | Unset): Only calls from this REST operation or operator run
+      since (datetime.datetime | None | Unset): Only calls at or after this time
+      until (datetime.datetime | None | Unset): Only calls before this time
+      cursor (None | str | Unset): The `next_cursor` of the previous page
+      limit (int | Unset): Entries per page Default: 50.
+
+  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:
+      ErrorResponse | HTTPValidationError | MutationAuditListResponse
+  """
+
+  return sync_detailed(
+    graph_id=graph_id,
+    client=client,
+    surface=surface,
+    operation_name=operation_name,
+    user_id=user_id,
+    operation_id=operation_id,
+    since=since,
+    until=until,
+    cursor=cursor,
+    limit=limit,
+  ).parsed
+
+
+async def asyncio_detailed(
+  graph_id: str,
+  *,
+  client: AuthenticatedClient,
+  surface: ListGraphMutationsSurfaceType0 | None | Unset = UNSET,
+  operation_name: None | str | Unset = UNSET,
+  user_id: None | str | Unset = UNSET,
+  operation_id: None | str | Unset = UNSET,
+  since: datetime.datetime | None | Unset = UNSET,
+  until: datetime.datetime | None | Unset = UNSET,
+  cursor: None | str | Unset = UNSET,
+  limit: int | Unset = 50,
+) -> Response[ErrorResponse | HTTPValidationError | MutationAuditListResponse]:
+  """List Graph Mutations
+
+   Every call that changed this graph, newest first: REST operations, external MCP clients, and in-app
+  AI operator runs. Each entry names the operation, the outcome, who made it and with which
+  credential, and the objects it touched. Arguments are not stored, only their SHA-256 fingerprint.
+  Requires graph admin.
+
+  Args:
+      graph_id (str): Graph identifier
+      surface (ListGraphMutationsSurfaceType0 | None | Unset): Only calls from this surface
+      operation_name (None | str | Unset): Only this operation or MCP tool
+      user_id (None | str | Unset): Only calls made as this user
+      operation_id (None | str | Unset): Only calls from this REST operation or operator run
+      since (datetime.datetime | None | Unset): Only calls at or after this time
+      until (datetime.datetime | None | Unset): Only calls before this time
+      cursor (None | str | Unset): The `next_cursor` of the previous page
+      limit (int | Unset): Entries per page Default: 50.
+
+  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[ErrorResponse | HTTPValidationError | MutationAuditListResponse]
+  """
+
+  kwargs = _get_kwargs(
+    graph_id=graph_id,
+    surface=surface,
+    operation_name=operation_name,
+    user_id=user_id,
+    operation_id=operation_id,
+    since=since,
+    until=until,
+    cursor=cursor,
+    limit=limit,
+  )
+
+  response = await client.get_async_httpx_client().request(**kwargs)
+
+  return _build_response(client=client, response=response)
+
+
+async def asyncio(
+  graph_id: str,
+  *,
+  client: AuthenticatedClient,
+  surface: ListGraphMutationsSurfaceType0 | None | Unset = UNSET,
+  operation_name: None | str | Unset = UNSET,
+  user_id: None | str | Unset = UNSET,
+  operation_id: None | str | Unset = UNSET,
+  since: datetime.datetime | None | Unset = UNSET,
+  until: datetime.datetime | None | Unset = UNSET,
+  cursor: None | str | Unset = UNSET,
+  limit: int | Unset = 50,
+) -> ErrorResponse | HTTPValidationError | MutationAuditListResponse | None:
+  """List Graph Mutations
+
+   Every call that changed this graph, newest first: REST operations, external MCP clients, and in-app
+  AI operator runs. Each entry names the operation, the outcome, who made it and with which
+  credential, and the objects it touched. Arguments are not stored, only their SHA-256 fingerprint.
+  Requires graph admin.
+
+  Args:
+      graph_id (str): Graph identifier
+      surface (ListGraphMutationsSurfaceType0 | None | Unset): Only calls from this surface
+      operation_name (None | str | Unset): Only this operation or MCP tool
+      user_id (None | str | Unset): Only calls made as this user
+      operation_id (None | str | Unset): Only calls from this REST operation or operator run
+      since (datetime.datetime | None | Unset): Only calls at or after this time
+      until (datetime.datetime | None | Unset): Only calls before this time
+      cursor (None | str | Unset): The `next_cursor` of the previous page
+      limit (int | Unset): Entries per page Default: 50.
+
+  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:
+      ErrorResponse | HTTPValidationError | MutationAuditListResponse
+  """
+
+  return (
+    await asyncio_detailed(
+      graph_id=graph_id,
+      client=client,
+      surface=surface,
+      operation_name=operation_name,
+      user_id=user_id,
+      operation_id=operation_id,
+      since=since,
+      until=until,
+      cursor=cursor,
+      limit=limit,
+    )
+  ).parsed

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/robosystems_client/api/operations/cancel_operation.py

@@ -110,7 +110,8 @@ def sync_detailed(
   """Cancel Operation
 
    Cancels a pending or running operation. Emits a cancellation event to any active SSE connections.
-  Cannot cancel completed or failed operations.
+  Cannot cancel completed or failed operations, or a running operation that cannot be stopped (graph
+  creation, tier changes, materialization, period close), which returns 409.
 
   Args:
       operation_id (str): Operation identifier
@@ -148,7 +149,8 @@ def sync(
   """Cancel Operation
 
    Cancels a pending or running operation. Emits a cancellation event to any active SSE connections.
-  Cannot cancel completed or failed operations.
+  Cannot cancel completed or failed operations, or a running operation that cannot be stopped (graph
+  creation, tier changes, materialization, period close), which returns 409.
 
   Args:
       operation_id (str): Operation identifier
@@ -177,7 +179,8 @@ async def asyncio_detailed(
   """Cancel Operation
 
    Cancels a pending or running operation. Emits a cancellation event to any active SSE connections.
-  Cannot cancel completed or failed operations.
+  Cannot cancel completed or failed operations, or a running operation that cannot be stopped (graph
+  creation, tier changes, materialization, period close), which returns 409.
 
   Args:
       operation_id (str): Operation identifier
@@ -213,7 +216,8 @@ async def asyncio(
   """Cancel Operation
 
    Cancels a pending or running operation. Emits a cancellation event to any active SSE connections.
-  Cannot cancel completed or failed operations.
+  Cannot cancel completed or failed operations, or a running operation that cannot be stopped (graph
+  creation, tier changes, materialization, period close), which returns 409.
 
   Args:
       operation_id (str): Operation identifier

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/robosystems_client/api/robo_ledger_reports/transition_filing_status.py

@@ -111,8 +111,9 @@ def sync_detailed(
 ) -> Response[ErrorResponse | OperationEnvelopeReportResponse]:
   """Transition Filing Status
 
-   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed →
-  archived). Use 'file-report' to reach 'filed' so audit fields land cleanly.
+   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed ↔
+  archived). Archiving takes a filed report off the current list without deleting it; unarchiving
+  returns it to 'filed'. Use 'file-report' to file a draft so audit fields land cleanly.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -123,10 +124,11 @@ def sync_detailed(
       body (TransitionFilingStatusRequest): Generic filing-status transition — escape hatch for
           non-file moves.
 
-          Used for `draft → under_review` (submit for review) and
-          `filed → archived` (supersede / retire). Filing the package goes
-          through :class:`FileReportRequest` so `filed_at` / `filed_by`
-          audit fields land cleanly.
+          Used for `draft ↔ under_review` (submit for review, or send back),
+          `filed → archived` (take a filed report off the current list) and
+          `archived → filed` (bring it back). Filing a draft goes through
+          :class:`FileReportRequest` so `filed_at` / `filed_by` audit fields
+          land cleanly.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -158,8 +160,9 @@ def sync(
 ) -> ErrorResponse | OperationEnvelopeReportResponse | None:
   """Transition Filing Status
 
-   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed →
-  archived). Use 'file-report' to reach 'filed' so audit fields land cleanly.
+   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed ↔
+  archived). Archiving takes a filed report off the current list without deleting it; unarchiving
+  returns it to 'filed'. Use 'file-report' to file a draft so audit fields land cleanly.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -170,10 +173,11 @@ def sync(
       body (TransitionFilingStatusRequest): Generic filing-status transition — escape hatch for
           non-file moves.
 
-          Used for `draft → under_review` (submit for review) and
-          `filed → archived` (supersede / retire). Filing the package goes
-          through :class:`FileReportRequest` so `filed_at` / `filed_by`
-          audit fields land cleanly.
+          Used for `draft ↔ under_review` (submit for review, or send back),
+          `filed → archived` (take a filed report off the current list) and
+          `archived → filed` (bring it back). Filing a draft goes through
+          :class:`FileReportRequest` so `filed_at` / `filed_by` audit fields
+          land cleanly.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -200,8 +204,9 @@ async def asyncio_detailed(
 ) -> Response[ErrorResponse | OperationEnvelopeReportResponse]:
   """Transition Filing Status
 
-   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed →
-  archived). Use 'file-report' to reach 'filed' so audit fields land cleanly.
+   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed ↔
+  archived). Archiving takes a filed report off the current list without deleting it; unarchiving
+  returns it to 'filed'. Use 'file-report' to file a draft so audit fields land cleanly.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -212,10 +217,11 @@ async def asyncio_detailed(
       body (TransitionFilingStatusRequest): Generic filing-status transition — escape hatch for
           non-file moves.
 
-          Used for `draft → under_review` (submit for review) and
-          `filed → archived` (supersede / retire). Filing the package goes
-          through :class:`FileReportRequest` so `filed_at` / `filed_by`
-          audit fields land cleanly.
+          Used for `draft ↔ under_review` (submit for review, or send back),
+          `filed → archived` (take a filed report off the current list) and
+          `archived → filed` (bring it back). Filing a draft goes through
+          :class:`FileReportRequest` so `filed_at` / `filed_by` audit fields
+          land cleanly.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -245,8 +251,9 @@ async def asyncio(
 ) -> ErrorResponse | OperationEnvelopeReportResponse | None:
   """Transition Filing Status
 
-   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed →
-  archived). Use 'file-report' to reach 'filed' so audit fields land cleanly.
+   Move a Report along the non-file legs of the filing lifecycle (draft ↔ under_review, filed ↔
+  archived). Archiving takes a filed report off the current list without deleting it; unarchiving
+  returns it to 'filed'. Use 'file-report' to file a draft so audit fields land cleanly.
 
   **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
   return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -257,10 +264,11 @@ async def asyncio(
       body (TransitionFilingStatusRequest): Generic filing-status transition — escape hatch for
           non-file moves.
 
-          Used for `draft → under_review` (submit for review) and
-          `filed → archived` (supersede / retire). Filing the package goes
-          through :class:`FileReportRequest` so `filed_at` / `filed_by`
-          audit fields land cleanly.
+          Used for `draft ↔ under_review` (submit for review, or send back),
+          `filed → archived` (take a filed report off the current list) and
+          `archived → filed` (bring it back). Filing a draft goes through
+          :class:`FileReportRequest` so `filed_at` / `filed_by` audit fields
+          land cleanly.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/robosystems_client/api/robo_ledger_taxonomy_mapping/create_mapping_association.py

@@ -116,7 +116,8 @@ def sync_detailed(
   """Create Mapping Association
 
    Link a chart-of-accounts element to a US GAAP reporting concept. One mapping edge per call — use
-  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. Map
+  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. The
+  target must be a leaf concept: a subtotal the statement sums from its children is refused (422). Map
   before you close: an account with landed history in a closed month cannot be re-mapped (422) — the
   closed month's stamped statements were computed through the old arcs. Reopen latest-first down to
   the earliest month named, map, then close forward.
@@ -165,7 +166,8 @@ def sync(
   """Create Mapping Association
 
    Link a chart-of-accounts element to a US GAAP reporting concept. One mapping edge per call — use
-  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. Map
+  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. The
+  target must be a leaf concept: a subtotal the statement sums from its children is refused (422). Map
   before you close: an account with landed history in a closed month cannot be re-mapped (422) — the
   closed month's stamped statements were computed through the old arcs. Reopen latest-first down to
   the earliest month named, map, then close forward.
@@ -209,7 +211,8 @@ async def asyncio_detailed(
   """Create Mapping Association
 
    Link a chart-of-accounts element to a US GAAP reporting concept. One mapping edge per call — use
-  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. Map
+  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. The
+  target must be a leaf concept: a subtotal the statement sums from its children is refused (422). Map
   before you close: an account with landed history in a closed month cannot be re-mapped (422) — the
   closed month's stamped statements were computed through the old arcs. Reopen latest-first down to
   the earliest month named, map, then close forward.
@@ -256,7 +259,8 @@ async def asyncio(
   """Create Mapping Association
 
    Link a chart-of-accounts element to a US GAAP reporting concept. One mapping edge per call — use
-  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. Map
+  `auto-map-elements` for bulk AI-assisted mapping. Duplicate (from, to, type) tuples return 409. The
+  target must be a leaf concept: a subtotal the statement sums from its children is refused (422). Map
   before you close: an account with landed history in a closed month cannot be re-mapped (422) — the
   closed month's stamped statements were computed through the old arcs. Reopen latest-first down to
   the earliest month named, map, then close forward.

robosystems_client-2.2.3/robosystems_client/api/user/__init__.py

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

{robosystems_client-2.2.1 → robosystems_client-2.2.3}/robosystems_client/clients/ledger_client.py

@@ -2186,9 +2186,20 @@ class LedgerClient:
     envelope = self._call_op("Create report", response)
     return self._typed_result("Create report", envelope, ReportResponse)
 
-  def list_reports(self, graph_id: str) -> list[ListLedgerReportsReportsReports]:
-    """List all reports for a graph (includes received shared reports)."""
-    data = self._query(graph_id, LIST_LEDGER_REPORTS_GQL)
+  def list_reports(
+    self, graph_id: str, lifecycle: str | None = None
+  ) -> list[ListLedgerReportsReportsReports]:
+    """List reports for a graph (includes received shared reports).
+
+    Args:
+        graph_id: The graph to list.
+        lifecycle: ``"current"`` (the server default) leaves archived
+            reports out, ``"archived"`` returns only those, ``"all"`` every
+            report. The enum names ``"CURRENT"`` / ``"ARCHIVED"`` /
+            ``"ALL"`` are also accepted.
+    """
+    variables = {"lifecycle": lifecycle.upper()} if lifecycle else None
+    data = self._query(graph_id, LIST_LEDGER_REPORTS_GQL, variables)
     page = ListLedgerReports.model_validate(data).reports
     return page.reports if page else []
 
@@ -2372,9 +2383,11 @@ class LedgerClient:
   ) -> ReportResponse:
     """Move a Report along the non-file legs of the filing lifecycle.
 
-    Use ``file_report()`` to reach 'filed' so audit fields land cleanly.
-    Other transitions (draft ↔ under_review, filed → archived) go through
-    here so the legal-transition graph stays in one place.
+    Use ``file_report()`` to file a draft so audit fields land cleanly.
+    Other transitions (draft ↔ under_review, filed ↔ archived) go through
+    here so the legal-transition graph stays in one place. Archiving takes
+    a filed report off the current list without deleting it; unarchiving
+    (``target_status="filed"``) brings it back.
     """
     body = TransitionFilingStatusRequest(
       report_id=report_id, target_status=target_status