feat: Persist and echo deployment source identity

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 127
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-d7ab1ecb886cb7f86e7ce0926207db423a6650e8e12e7283a71f8682fbb472ae.yml
-openapi_spec_hash: 9323b0ba38d2d50b8506be4d7401c04d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-d61b5e5ca18ce30a6b4d05483bcd67969ce0f4aee2e9e8c379be4f22f1362b01.yml
+openapi_spec_hash: 23121d1c1552e41177b472c4c39d154e
 config_hash: 77ee715aa17061166f9a02b264a21b8d

src/kernel/types/deployment_create_response.py

@@ -35,6 +35,39 @@ class DeploymentCreateResponse(BaseModel):
     values.
     """
 
+    source_checksum: Optional[str] = None
+    """Hex-encoded SHA-256 checksum of the source archive.
+
+    For file uploads, this hashes the uploaded archive; for GitHub-sourced
+    deployments, this hashes the GitHub archive downloaded by the API. Omitted for
+    deployments created before this field was recorded.
+    """
+
+    source_path: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the subpath within the repository that was used
+    as the deploy root. Omitted when the repo root was used or for file uploads.
+    """
+
+    source_ref: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the git ref as requested at deploy time (branch,
+    tag, or commit SHA — not resolved to a commit). Omitted for file uploads.
+    """
+
+    source_type: Optional[Literal["file", "github"]] = None
+    """Origin of the deployed source code.
+
+    This is read-only response provenance; `file` indicates an uploaded archive and
+    `github` indicates a repository fetched by the API.
+    """
+
+    source_url: Optional[str] = None
+    """For GitHub-sourced deployments, the repository URL that was fetched.
+
+    Omitted for file uploads.
+    """
+
     status_reason: Optional[str] = None
     """Status reason"""
 

src/kernel/types/deployment_list_response.py

@@ -35,6 +35,39 @@ class DeploymentListResponse(BaseModel):
     values.
     """
 
+    source_checksum: Optional[str] = None
+    """Hex-encoded SHA-256 checksum of the source archive.
+
+    For file uploads, this hashes the uploaded archive; for GitHub-sourced
+    deployments, this hashes the GitHub archive downloaded by the API. Omitted for
+    deployments created before this field was recorded.
+    """
+
+    source_path: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the subpath within the repository that was used
+    as the deploy root. Omitted when the repo root was used or for file uploads.
+    """
+
+    source_ref: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the git ref as requested at deploy time (branch,
+    tag, or commit SHA — not resolved to a commit). Omitted for file uploads.
+    """
+
+    source_type: Optional[Literal["file", "github"]] = None
+    """Origin of the deployed source code.
+
+    This is read-only response provenance; `file` indicates an uploaded archive and
+    `github` indicates a repository fetched by the API.
+    """
+
+    source_url: Optional[str] = None
+    """For GitHub-sourced deployments, the repository URL that was fetched.
+
+    Omitted for file uploads.
+    """
+
     status_reason: Optional[str] = None
     """Status reason"""
 

src/kernel/types/deployment_retrieve_response.py

@@ -35,6 +35,39 @@ class DeploymentRetrieveResponse(BaseModel):
     values.
     """
 
+    source_checksum: Optional[str] = None
+    """Hex-encoded SHA-256 checksum of the source archive.
+
+    For file uploads, this hashes the uploaded archive; for GitHub-sourced
+    deployments, this hashes the GitHub archive downloaded by the API. Omitted for
+    deployments created before this field was recorded.
+    """
+
+    source_path: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the subpath within the repository that was used
+    as the deploy root. Omitted when the repo root was used or for file uploads.
+    """
+
+    source_ref: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the git ref as requested at deploy time (branch,
+    tag, or commit SHA — not resolved to a commit). Omitted for file uploads.
+    """
+
+    source_type: Optional[Literal["file", "github"]] = None
+    """Origin of the deployed source code.
+
+    This is read-only response provenance; `file` indicates an uploaded archive and
+    `github` indicates a repository fetched by the API.
+    """
+
+    source_url: Optional[str] = None
+    """For GitHub-sourced deployments, the repository URL that was fetched.
+
+    Omitted for file uploads.
+    """
+
     status_reason: Optional[str] = None
     """Status reason"""
 

src/kernel/types/deployment_state_event.py

@@ -35,6 +35,39 @@ class Deployment(BaseModel):
     values.
     """
 
+    source_checksum: Optional[str] = None
+    """Hex-encoded SHA-256 checksum of the source archive.
+
+    For file uploads, this hashes the uploaded archive; for GitHub-sourced
+    deployments, this hashes the GitHub archive downloaded by the API. Omitted for
+    deployments created before this field was recorded.
+    """
+
+    source_path: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the subpath within the repository that was used
+    as the deploy root. Omitted when the repo root was used or for file uploads.
+    """
+
+    source_ref: Optional[str] = None
+    """
+    For GitHub-sourced deployments, the git ref as requested at deploy time (branch,
+    tag, or commit SHA — not resolved to a commit). Omitted for file uploads.
+    """
+
+    source_type: Optional[Literal["file", "github"]] = None
+    """Origin of the deployed source code.
+
+    This is read-only response provenance; `file` indicates an uploaded archive and
+    `github` indicates a repository fetched by the API.
+    """
+
+    source_url: Optional[str] = None
+    """For GitHub-sourced deployments, the repository URL that was fetched.
+
+    Omitted for file uploads.
+    """
+
     status_reason: Optional[str] = None
     """Status reason"""