feat: Add App Version to Invocation and add filtering on App Version

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 51
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-bfdb7e3d38870a8ba1628f4f83a3a719d470bf4f7fbecb67a6fad110447c9b6a.yml
-openapi_spec_hash: fed29c80f9c25f8a7216b8c6de2051ab
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-da8bfd5cfb5a6d9ccb7e4edd123b49284f4eccb32fc9b6fb7165548535122e12.yml
+openapi_spec_hash: fd6ded34689331831b5c077f71b5f08f
 config_hash: 49c2ff978aaa5ccb4ce324a72f116010

src/kernel/resources/invocations.py

@@ -197,6 +197,7 @@ def list(
         offset: int | Omit = omit,
         since: str | Omit = omit,
         status: Literal["queued", "running", "succeeded", "failed"] | Omit = omit,
+        version: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -225,6 +226,8 @@ def list(
 
           status: Filter results by invocation status.
 
+          version: Filter results by application version.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -250,6 +253,7 @@ def list(
                         "offset": offset,
                         "since": since,
                         "status": status,
+                        "version": version,
                     },
                     invocation_list_params.InvocationListParams,
                 ),
@@ -506,6 +510,7 @@ def list(
         offset: int | Omit = omit,
         since: str | Omit = omit,
         status: Literal["queued", "running", "succeeded", "failed"] | Omit = omit,
+        version: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -534,6 +539,8 @@ def list(
 
           status: Filter results by invocation status.
 
+          version: Filter results by application version.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -559,6 +566,7 @@ def list(
                         "offset": offset,
                         "since": since,
                         "status": status,
+                        "version": version,
                     },
                     invocation_list_params.InvocationListParams,
                 ),

src/kernel/types/invocation_list_params.py

@@ -31,3 +31,6 @@ class InvocationListParams(TypedDict, total=False):
 
     status: Literal["queued", "running", "succeeded", "failed"]
     """Filter results by invocation status."""
+
+    version: str
+    """Filter results by application version."""

src/kernel/types/invocation_list_response.py

@@ -25,6 +25,9 @@ class InvocationListResponse(BaseModel):
     status: Literal["queued", "running", "succeeded", "failed"]
     """Status of the invocation"""
 
+    version: str
+    """Version label for the application"""
+
     finished_at: Optional[datetime] = None
     """
     RFC 3339 Nanoseconds timestamp when the invocation finished (null if still

src/kernel/types/invocation_retrieve_response.py

@@ -25,6 +25,9 @@ class InvocationRetrieveResponse(BaseModel):
     status: Literal["queued", "running", "succeeded", "failed"]
     """Status of the invocation"""
 
+    version: str
+    """Version label for the application"""
+
     finished_at: Optional[datetime] = None
     """
     RFC 3339 Nanoseconds timestamp when the invocation finished (null if still

src/kernel/types/invocation_state_event.py

@@ -25,6 +25,9 @@ class Invocation(BaseModel):
     status: Literal["queued", "running", "succeeded", "failed"]
     """Status of the invocation"""
 
+    version: str
+    """Version label for the application"""
+
     finished_at: Optional[datetime] = None
     """
     RFC 3339 Nanoseconds timestamp when the invocation finished (null if still

src/kernel/types/invocation_update_response.py

@@ -25,6 +25,9 @@ class InvocationUpdateResponse(BaseModel):
     status: Literal["queued", "running", "succeeded", "failed"]
     """Status of the invocation"""
 
+    version: str
+    """Version label for the application"""
+
     finished_at: Optional[datetime] = None
     """
     RFC 3339 Nanoseconds timestamp when the invocation finished (null if still

tests/api_resources/test_invocations.py

@@ -190,6 +190,7 @@ def test_method_list_with_all_params(self, client: Kernel) -> None:
             offset=0,
             since="2025-06-20T12:00:00Z",
             status="queued",
+            version="version",
         )
         assert_matches_type(SyncOffsetPagination[InvocationListResponse], invocation, path=["response"])
 
@@ -480,6 +481,7 @@ async def test_method_list_with_all_params(self, async_client: AsyncKernel) -> N
             offset=0,
             since="2025-06-20T12:00:00Z",
             status="queued",
+            version="version",
         )
         assert_matches_type(AsyncOffsetPagination[InvocationListResponse], invocation, path=["response"])