pingintel-api 1.4.6__tar.gz → 1.4.8__tar.gz

pingintel_api-1.4.8/.claude/settings.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:data-api.sovfixer.com)"
+    ]
+  }
+}

pingintel_api-1.4.8/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:data-api.sovfixer.com)",
+      "WebFetch(domain:docs.pingintel.com)",
+      "WebFetch(domain:api.sovfixer.com)",
+      "Bash(curl -s \"http://localhost/olddocs\")",
+      "Bash(curl -sv \"http://localhost/api/schema/\")",
+      "Bash(curl -s \"http://localhost/api/schema/\")",
+      "Bash(python3 -c ' *)",
+      "Bash(mkdir -p \"C:/temp\")",
+      "Bash(curl -s \"http://localhost/api/schema/\" -o \"C:/temp/schema.yaml\")",
+      "Read(//c/temp/**)"
+    ]
+  }
+}

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pingintel-api
-Version: 1.4.6
+Version: 1.4.8
 Summary: Python-based client to Ping Data Intelligence APIs
 Project-URL: Homepage, https://github.com/pingintel/pingintel-api
 Project-URL: Issues, https://github.com/pingintel/pingintel-api/issues

pingintel_api-1.4.8/examples/close_submissions.py

@@ -0,0 +1,129 @@
+"""
+Set one or more PingVision submissions to a given workflow status.
+
+Accepts pingids (e.g. p-ob-amw-agtdgc) or client_refs. Identifiers starting
+with "p-" are treated as pingids; all others are looked up as client_refs.
+
+Usage:
+    python close_submissions.py <id1> [id2 ...] --status <name> [options]
+
+    python close_submissions.py p-ob-amw-abc123 my-client-ref-456 --status Closed
+    python close_submissions.py p-ob-amw-abc123 --status Declined --env staging --dry-run
+"""
+
+import argparse
+import sys
+
+from pingintel_api import PingVisionAPIClient
+
+
+def resolve_pingids(client: PingVisionAPIClient, identifiers: list[str]) -> dict[str, str | None]:
+    """Return {identifier: pingid} for all identifiers. pingid is None if not found."""
+    result = {}
+    for ident in identifiers:
+        if ident.startswith("p-"):
+            result[ident] = ident
+        else:
+            activity = client.list_submission_activity(client_ref=ident, page_size=10)
+            submissions = activity.get("results", [])
+            if not submissions:
+                print(f"  WARNING: No submission found for client_ref={ident!r}", file=sys.stderr)
+                result[ident] = None
+            elif len(submissions) > 1:
+                pingids = [s["id"] for s in submissions]
+                print(
+                    f"  WARNING: Multiple submissions found for client_ref={ident!r}: {pingids}. Skipping.",
+                    file=sys.stderr,
+                )
+                result[ident] = None
+            else:
+                result[ident] = submissions[0]["id"]
+    return result
+
+
+def find_status_uuid(client: PingVisionAPIClient, division_uuid: str, status_name: str) -> str:
+    statuses = client.list_submission_statuses(division=division_uuid)
+    matched = [s for s in statuses if s["name"].lower() == status_name.lower()]
+    if not matched:
+        available = [s["name"] for s in statuses]
+        raise RuntimeError(f"Status {status_name!r} not found. Available: {available}")
+    return matched[0]["uuid"]
+
+
+def find_division_uuid(client: PingVisionAPIClient, team_name: str | None, division: str | None) -> str:
+    teams = client.list_teams()
+    if not teams:
+        raise RuntimeError("No teams found for this API token.")
+    if division:
+        matched = [
+            t for t in teams
+            if t["division_uuid"] == division
+            or t.get("division_name", "").lower() == division.lower()
+            or t.get("division_short_name", "").lower() == division.lower()
+        ]
+        if not matched:
+            available = [(t.get("division_short_name") or t["division_name"], t["division_uuid"]) for t in teams]
+            raise RuntimeError(f"Division {division!r} not found. Available: {available}")
+        return matched[0]["division_uuid"]
+    if team_name:
+        matched = [t for t in teams if t["team_name"] == team_name]
+        if not matched:
+            available = [t["team_name"] for t in teams]
+            raise RuntimeError(f"Team {team_name!r} not found. Available: {available}")
+        return matched[0]["division_uuid"]
+    if len(teams) == 1:
+        return teams[0]["division_uuid"]
+    names = [t["team_name"] for t in teams]
+    raise RuntimeError(f"Multiple teams found: {names}. Specify one with --team or --division.")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Set PingVision submission workflow status.")
+    parser.add_argument("identifiers", nargs="+", help="pingids or client_refs to update")
+    parser.add_argument("--status", required=True, help="Target workflow status name (e.g. Closed, Declined)")
+    parser.add_argument("--env", default="prod", help="API environment (prod, staging, local). Default: prod")
+    parser.add_argument("--api-url", help="Override API URL (e.g. http://localhost:8002)")
+    parser.add_argument("--team", help="Team name for status lookup (required if multiple teams)")
+    parser.add_argument("--division", help="Division UUID (alternative to --team)")
+    parser.add_argument("--dry-run", action="store_true", help="Print what would happen without making changes")
+    args = parser.parse_args()
+
+    kwargs = {}
+    if args.api_url:
+        kwargs["api_url"] = args.api_url
+    else:
+        kwargs["environment"] = args.env
+
+    client = PingVisionAPIClient(**kwargs)
+
+    division_uuid = find_division_uuid(client, args.team, args.division)
+    status_uuid = find_status_uuid(client, division_uuid, args.status)
+    print(f"Status {args.status!r} UUID: {status_uuid}")
+
+    id_map = resolve_pingids(client, args.identifiers)
+
+    success, skipped, failed = 0, 0, 0
+    for ident, pingid in id_map.items():
+        if pingid is None:
+            skipped += 1
+            continue
+        label = pingid if ident == pingid else f"{pingid} (client_ref={ident!r})"
+        if args.dry_run:
+            print(f"  DRY RUN: would set {label} -> {args.status!r}")
+            success += 1
+            continue
+        try:
+            client.change_status(pingid=pingid, workflow_status_id=status_uuid)
+            print(f"  Updated {label} -> {args.status!r}")
+            success += 1
+        except Exception as e:
+            print(f"  ERROR updating {label}: {e}", file=sys.stderr)
+            failed += 1
+
+    print(f"\nDone. {success} updated, {skipped} skipped, {failed} failed.")
+    if failed:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

pingintel_api-1.4.8/src/pingintel_api/__about__.py

@@ -0,0 +1 @@
+__version__ = "1.4.8"

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/pingdata/pingdata_api_client.py

@@ -162,7 +162,7 @@ class PingDataAPIClient(APIClientBase):
             delegate_to=delegate_to,
         )
         request_id = response_data["id"]
-        message = response_data["message"]
+        message = response_data.get("message", "")
 
         self.logger.info(
             f"+ Dispatched {request_id}: {message}.  Now, polling for results at {self.bulk_enhance_async_get_status_url(request_id=request_id)}."
@@ -299,3 +299,21 @@ class PingDataAPIClient(APIClientBase):
         raise_for_status(response)
         response_data = response.json()
         return response_data
+
+    def fetch_bulk_enhance_output(self, request_id: str, filename: str, output_path: str | None = None) -> bytes:
+        """
+        Download a result file from a completed bulk enhance job.
+
+        :param request_id: The bulk enhance job ID.
+        :param filename: The output filename (from result.outputs[].filename).
+        :param output_path: If provided, write the result to this local file path.
+        :return: Raw response bytes.
+        """
+        url = self.api_url + f"/api/v1/bulk_enhance/{request_id}/output/{filename}"
+        response = self.get(url)
+        raise_for_status(response)
+        if output_path:
+            with open(output_path, "wb") as fd:
+                for chunk in response.iter_content(chunk_size=128):
+                    fd.write(chunk)
+        return response.content

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/pingdata/types.py

@@ -124,9 +124,6 @@ class SingleLocation(TypedDict):
     address: NotRequired[str | None]
     latitude: NotRequired[float | None]
     longitude: NotRequired[float | None]
-    limits__building_limit: NotRequired[float | None]
-    limits__bpp_limit: NotRequired[float | None]
-    limits__bi_limit: NotRequired[float | None]
     address_line_1: NotRequired[str | None]
     address_line_2: NotRequired[str | None]
     city: NotRequired[str | None]
@@ -135,9 +132,10 @@ class SingleLocation(TypedDict):
     country: NotRequired[str | None]
     county: NotRequired[str | None]
     bldg_name: NotRequired[str | None]
-    # ping_occupancy_data: NotRequired[str | None]
-    # llm_text_blob: NotRequired[str | None]
-    # address_field_data: NotRequired[str | None]
+    lightbox_assessment_id: NotRequired[str | None]
+    lightbox_building_id: NotRequired[str | None]
+    lightbox_parcel_id: NotRequired[str | None]
+    lightbox_parcel_wkt: NotRequired[str | None]
     occupancy__type_desc: NotRequired[str | None]
     occupancy__desc_ping: NotRequired[str | None]
     occupancy__code_air: NotRequired[str | None]
@@ -149,10 +147,14 @@ class SingleLocation(TypedDict):
     const__wall_type: NotRequired[str | None]
     const__bldg_year_built: NotRequired[int | None]
     const__num_stories: NotRequired[int | None]
+    const__num_stories_below_gnd: NotRequired[int | None]
     const__bldg_area: NotRequired[int | None]
+    limits__building_limit: NotRequired[float | None]
+    limits__bpp_limit: NotRequired[float | None]
+    limits__bi_limit: NotRequired[float | None]
+    limits__signs_and_other_limit: NotRequired[float | None]
     dtc_include_coastline_within_miles: NotRequired[float | None]
     dtc_return_connected_coastlines: NotRequired[bool | None]
-    insured_name: NotRequired[str | None]
 
 
 Location = SingleLocation
@@ -160,6 +162,8 @@ Location = SingleLocation
 
 class BatchLocation(SingleLocation):
     id: str
+    sources: NotRequired[list[str] | None]
+    datasource_config: NotRequired[dict | None]
 
 
 class EnhanceResponse(TypedDict):

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/pingvisionapi_cmd.py

@@ -316,6 +316,52 @@ def list_submission_statuses(ctx, division):
     pprint.pprint(results)
 
 
+@cli.command()
+@click.pass_context
+@click.option("--pretty", is_flag=True, default=False)
+@click.option("--pingid", help="Filter by Ping ID")
+@click.option("--division", help="Filter by division UUID or short name")
+@click.option("--team", help="Filter by team UUID or short name")
+@click.option("--start", help="Start datetime filter (YYYYMMDDHHmmss UTC)")
+@click.option("--cursor-id", help="Cursor ID for pagination")
+@click.option("-l", "--page-size", "--limit", default=50)
+def events(ctx, pretty, pingid, division, team, start, cursor_id, page_size):
+    """List submission events."""
+    import datetime
+
+    client = get_client(ctx)
+
+    if not any([pingid, division, team]):
+        raise click.UsageError("One or more of --pingid, --division, or --team must be provided.")
+
+    start_dt = None
+    if start:
+        start_dt = datetime.datetime.strptime(start, "%Y%m%d%H%M%S")
+
+    results = client.list_submission_events(
+        pingid=pingid,
+        division=division,
+        team=team,
+        start=start_dt,
+        cursor_id=cursor_id,
+        page_size=page_size,
+    )
+    if pretty:
+        print(f"{'Ping ID':<20}{'Event Type':<6}{'Created':<20}{'Message'}")
+        for event in results["results"]:
+            created = event["created_time"]
+            try:
+                created = time.strftime("%Y-%m-%d %H:%M", time.strptime(created, "%Y-%m-%dT%H:%M:%S.%fZ"))
+            except ValueError:
+                pass
+            print(f"{event['pingid']:<20}{event['event_type']:<6}{created:<20}{event.get('message', '')}")
+        cursor = results.get("cursor_id")
+        if cursor:
+            print(f"\nNext cursor: {cursor}")
+    else:
+        pprint.pprint(results)
+
+
 def main():
     cli()
 

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/sov_fixer/sov_fixer_api_client.py

@@ -42,6 +42,8 @@ class SOVFixerAPIClient(APIClientBase):
         allow_ping_data_api=None,
         workflow=None,
         skip_prior_update_reuse: bool = False,
+        company: str | None = None,
+        team: str | None = None,
     ):
         """
         Start a SOV Fixer request from one or more files asynchronously.
@@ -77,6 +79,10 @@ class SOVFixerAPIClient(APIClientBase):
             data["allow_ping_data_api"] = allow_ping_data_api
         if workflow is not None:
             data["workflow"] = workflow
+        if company is not None:
+            data["company"] = company
+        if team is not None:
+            data["team"] = team
 
         data["skip_prior_update_reuse"] = skip_prior_update_reuse
 
@@ -250,7 +256,7 @@ class SOVFixerAPIClient(APIClientBase):
             if request_status == "PENDING":
                 self.logger.info("  - Has not yet been queued for processing.")
                 time.sleep(POLL_SECS)
-            elif request_status == "IN_PROGRESS":
+            elif request_status in t.INCOMPLETE_STATUSES:
                 self.logger.info(f"  - Still in progress ({pct_complete}% complete): {last_status}")
                 time.sleep(POLL_SECS)
             else:
@@ -340,27 +346,28 @@ class SOVFixerAPIClient(APIClientBase):
         search=None,
         origin: Literal["api", "email"] | None = None,
         status: Literal["P", "I", "E", "R", "C", "F"] | None = None,
-        organization__short_name=None,
+        company__short_name: str | list[str] | None = None,
+        division__short_name: str | list[str] | None = None,
+        pingid: str | None = None,
+        completed_time__gt: str | None = None,
+        completed_time__gte: str | None = None,
+        completed_time__lt: str | None = None,
+        completed_time__lte: str | None = None,
     ) -> t.ActivityResponse:
         """List activity in the SOV Fixer system.
-        id: str
-            The ID of the activity to retrieve.
-        cursor_id: str
-            The cursor ID to use for pagination. Do not set on the first call, but provide the value from each previous call to the next to get the next page.
-        prev_cursor_id: str
-            See cursor_id, but this goes backwards.
-        page_size: int
-            The number of results to return per page. Default is 50.
-        fields: str
-            The fields to include in the response. Default is all fields.
-        search: str
-            A search term to filter results by.
-        origin: str
-            Filter by the origin of the activity. Can be "api" or "email".
-        status: str
-            Filter by the status of the activity. Can be "P" (pending), "I" (in progress), "E" (enriching), "R" (re-enriching), "C" (complete), or "F" (failed).
-        organization__short_name: str
-            Filter by the short name of the organization that created the activity
+
+        id: filter by sovid.
+        cursor_id: pagination cursor from a previous response.
+        prev_cursor_id: reverse pagination cursor.
+        page_size: max results per page (default 50, max 250).
+        fields: list of field names to include on each result.
+        search: global case-insensitive search substring.
+        origin: filter by "api" or "email".
+        status: filter by status
+        company__short_name: filter by company short name(s).
+        division__short_name: filter by division short name(s).
+        pingid: filter by Ping ID.
+        completed_time__gt/gte/lt/lte: filter by completed_time (format: YYYYMMDDHHmmss, UTC).
         """
         parameters = {}
         if id:
@@ -379,8 +386,20 @@ class SOVFixerAPIClient(APIClientBase):
             parameters["origin"] = origin
         if status:
             parameters["status"] = status
-        if organization__short_name:
-            parameters["organization__short_name"] = organization__short_name
+        if company__short_name:
+            parameters["company__short_name"] = company__short_name
+        if division__short_name:
+            parameters["division__short_name"] = division__short_name
+        if pingid:
+            parameters["pingid"] = pingid
+        if completed_time__gt:
+            parameters["completed_time__gt"] = completed_time__gt
+        if completed_time__gte:
+            parameters["completed_time__gte"] = completed_time__gte
+        if completed_time__lt:
+            parameters["completed_time__lt"] = completed_time__lt
+        if completed_time__lte:
+            parameters["completed_time__lte"] = completed_time__lte
 
         url = self.api_url + "/api/v1/sov/activity"
         response = self.get(url, params=parameters)
@@ -464,20 +483,19 @@ class SOVFixerAPIClient(APIClientBase):
         sudid: str,
         extra_data=None,
         policy_terms=None,
-        policy_terms_format_name=None,
+        outputter_name: str | None = None,
         output_formats=None,
         metadata=None,
         integrations=None,
         delegate_to_team: UUID | str | int | None = None,
     ) -> t.SOVUpdateAsyncAPIResponse:
         url = self.api_url + f"/api/v1/sov/update/{sudid}/start"
-        data = {}
-        if extra_data:
-            data["extra_data"] = extra_data
+        data: dict = {}
+        data["extra_data"] = extra_data or {}
         if policy_terms:
             data["policy_terms"] = policy_terms
-        if policy_terms_format_name:
-            data["policy_terms_format_name"] = policy_terms_format_name
+        if outputter_name:
+            data["outputter_name"] = outputter_name
         if output_formats:
             data["output_formats"] = output_formats
         if metadata:
@@ -515,7 +533,7 @@ class SOVFixerAPIClient(APIClientBase):
         location_filenames,
         extra_data=None,
         policy_terms=None,
-        policy_terms_format_name=None,
+        outputter_name: str | None = None,
         output_formats=None,
         actually_write=False,
         update_type=None,
@@ -545,7 +563,7 @@ class SOVFixerAPIClient(APIClientBase):
             sudid,
             extra_data=extra_data,
             policy_terms=policy_terms,
-            policy_terms_format_name=policy_terms_format_name,
+            outputter_name=outputter_name,
             output_formats=output_formats,
             metadata=metadata,
             integrations=integrations,
@@ -625,6 +643,7 @@ class SOVFixerAPIClient(APIClientBase):
     def get_or_create_output_async_check_progress(self, output_request_id: str):
         url = self.api_url + f"/api/v1/sov/get_or_create_output/{output_request_id}"
         response = self.get(url)
+        raise_for_status(response)
         return response.json()
 
     def get_or_create_output(
@@ -697,3 +716,105 @@ class SOVFixerAPIClient(APIClientBase):
 
         response_data = response.json()
         return response_data
+
+    def fetch_sov_output(self, sov_id: str, filename: str, output_path: str | None = None) -> bytes:
+        """
+        Download an output file from a completed SOV parsing job.
+
+        :param sov_id: The SOV job ID.
+        :param filename: The output filename (from result.outputs[].filename).
+        :param output_path: If provided, write the result to this local file path.
+        :return: Raw response bytes.
+        """
+        url = self.api_url + f"/api/v1/sov/{sov_id}/output/{filename}"
+        response = self.get(url)
+        raise_for_status(response)
+        if output_path:
+            with open(output_path, "wb") as fd:
+                for chunk in response.iter_content(chunk_size=1024 * 1024):
+                    fd.write(chunk)
+        return response.content
+
+    def get_history_item(self, id: str) -> t.SOVHistoryResponse:
+        """
+        Get a specific historical SOV or SOV Update by its ID.
+
+        :param id: SOV ID (sovid) or SOV Update ID (sudid).
+        :return: Historical SOV data including outputs.
+        """
+        url = self.api_url + f"/api/v1/sov/history/{id}"
+        response = self.get(url)
+        raise_for_status(response)
+        return response.json()
+
+    def get_building(self, item_key: str) -> dict:
+        """
+        Retrieve a specific building by its item key.
+
+        :param item_key: Unique building identifier, e.g. "i-s-e-xxxxxxx!SOV!1".
+        :return: Building data dict.
+        """
+        url = self.api_url + f"/api/v1/building/{item_key}"
+        response = self.get(url)
+        raise_for_status(response)
+        return response.json()
+
+    def list_output_formats(
+        self,
+        sovid: str | None = None,
+        division_uuid: str | None = None,
+        team_uuid: str | None = None,
+    ) -> t.OutputFormatsResponse:
+        """List available output formats for the given context."""
+        url = self.api_url + "/api/v1/output_formats"
+        params = {}
+        if sov_id:
+            params["sovid"] = sovid
+        if division_uuid:
+            params["division_uuid"] = division_uuid
+        if team_uuid:
+            params["team_uuid"] = team_uuid
+        response = self.get(url, params=params)
+        raise_for_status(response)
+        return response.json()
+
+    def get_public_shareable_url(self, sovid: str) -> t.GetPublicShareableUrlResponse:
+        """
+        Get a publicly shareable Ping.Maps URL for the given SOV.
+
+        :param sovid: The SOV ID.
+        :return: Dict with a "url" key containing the shareable URL.
+        """
+        url = self.api_url + f"/api/v1/pli/policy/{sovid}/get_public_shareable_url"
+        response = self.get(url)
+        raise_for_status(response)
+        return response.json()
+
+    def create_submission(
+        self,
+        document_type: str = "SOV",
+        client_ref: str | None = None,
+        extra_data: dict | None = None,
+        filename: str | None = None,
+    ) -> t.CreateSubmissionResponse:
+        """
+        Create a new empty submission. Follow with update_sov_async_add_locations then update_sov_async_start.
+
+        :param document_type: "SOV", "PREM_BDX", "CLAIM_BDX", or "SOV_BDX". Default "SOV".
+        :param client_ref: Optional user reference identifier.
+        :param extra_data: Optional dict of extra_data_* fields (e.g. insured_name, inception_date).
+        :param filename: Optional filename for the submission.
+        :return: Dict with "id" (int) and "message".
+        """
+        url = self.api_url + "/api/v1/submission"
+        data: dict = {"document_type": document_type}
+        if client_ref:
+            data["client_ref"] = client_ref
+        if extra_data:
+            for k, v in extra_data.items():
+                data["extra_data_" + k] = v
+        if filename:
+            data["filename"] = filename
+        response = self.post(url, data=data)
+        raise_for_status(response)
+        return response.json()

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/sov_fixer/types.py

@@ -83,6 +83,7 @@ class SOVUpdateInitiateRequest(TypedDict):
     update_type: NotRequired[str | None]
     callback_url: NotRequired[str | None]
     username: NotRequired[str | None]
+    delegate_to_team: NotRequired[str | int | None]
 
 
 class SOVUpdateResponseResultOutputs(TypedDict):
@@ -165,6 +166,7 @@ class SOVData(TypedDict):
     document_type: str | None
     pct_complete: float | None
     filename: str | None
+    additional_filenames: list[str] | None
     status: str | None
     status_display: str | None
     last_health_status: str | None
@@ -173,12 +175,17 @@ class SOVData(TypedDict):
     output_data: list[OutputData] | None
     origin: str | None
     organization__short_name: str | None
+    company__short_name: str | None
+    team__name: str | None
+    division__short_name: str | None
     global_request_id: str | None
     ping_maps_url: str | None
+    ping_vision_url: str | None
     input_file_url: str | None
     extra_data: dict[str, Any] | None
     updates: dict[str, UpdateData] | None
     all_updates: list[UpdateData] | None
+    latest_revision: int | None
     completed_time: str | None
     created_time: str | None
     subject: str | None
@@ -198,6 +205,9 @@ class ActivityResponse(TypedDict):
     cursor_id: str | None
     prev_cursor_id: str | None
     remaining_count: int
+    has_remaining: bool
+    total_count: int
+    total_size_without_cursors: str
 
 
 class HistoryItem(TypedDict):
@@ -210,8 +220,47 @@ class HistoryItem(TypedDict):
     completed_time: datetime
     record_type: str
     incremental: bool
+    is_data_ready: NotRequired[bool | None]
 
 
 class HistoryResponse(TypedDict):
     cursor_id: str | None
     results: list[HistoryItem]
+
+
+class SOVHistoryOutputItem(TypedDict):
+    url: str
+    output_format: str
+    completed_time: str
+
+
+class SOVHistoryResult(TypedDict):
+    sovid: str
+    previous_sovid: str
+    original_sovid: str
+    sheet_name: str
+    outputs: list[SOVHistoryOutputItem]
+
+
+class SOVHistoryResponse(TypedDict):
+    result: SOVHistoryResult
+
+
+class CreateSubmissionResponse(TypedDict):
+    message: str
+    id: int
+
+
+class GetPublicShareableUrlResponse(TypedDict):
+    url: str
+
+
+class OutputFormatItem(TypedDict):
+    output_format: str
+    label: str
+    is_public: bool
+    output_extension: str | None
+
+
+class OutputFormatsResponse(TypedDict):
+    output_formats: list[OutputFormatItem]

{pingintel_api-1.4.6 → pingintel_api-1.4.8}/src/pingintel_api/sovfixerapi_cmd.py

@@ -502,6 +502,25 @@ def update(
     click.echo(f"Executed SOV Update, SUDID: {sudid}")
 
 
+@cli.command()
+@click.pass_context
+@click.option("--sovid", help="Scope to a specific SOV ID")
+@click.option("--division-uuid", help="Scope to a division UUID")
+@click.option("--team-uuid", help="Scope to a team UUID")
+@click.option("--pretty", is_flag=True, default=False)
+def list_output_formats(ctx, sovid, division_uuid, team_uuid, pretty):
+    """List available output formats."""
+    client = get_client(ctx)
+    results = client.list_output_formats(sovid=sovid, division_uuid=division_uuid, team_uuid=team_uuid)
+    if pretty:
+        print(f"{'Format':<30}{'Label':<40}{'Extension':<12}{'Public'}")
+        for fmt in results["output_formats"]:
+            ext = fmt.get("output_extension") or ""
+            print(f"{fmt['output_format']:<30}{fmt['label']:<40}{ext:<12}{fmt['is_public']}")
+    else:
+        pprint.pprint(results)
+
+
 def main():
     cli()
 

pingintel_api-1.4.6/src/pingintel_api/__about__.py

@@ -1 +0,0 @@
-__version__ = "1.4.6"