pierre-sdk 0.1.0.dev4__py3-none-any.whl

pierre/_generated/schemas.py

@@ -0,0 +1,1437 @@
+# Generated by sdkgen. Do not edit this file.
+"""The named schemas of the API, with the wire name of each field."""
+
+from typing import Dict, List, Literal, Optional, Union
+
+from pierre._compat import NotRequired, TypedDict
+
+__all__ = [
+    "ArchiveOptions",
+    "BaseRepo",
+    "BaseRepoAuth",
+    "BlameLine",
+    "BlobChunk",
+    "Branch",
+    "BranchListItem",
+    "Commit",
+    "CommitWriteResponse",
+    "DiffChunk",
+    "DiffStats",
+    "FileDiff",
+    "FileEntry",
+    "FileLastCommit",
+    "FileOperation",
+    "FileWithMetadata",
+    "FilteredFile",
+    "GitCredential",
+    "GitIdentity",
+    "GitPushEvent",
+    "GitSyncFailedEvent",
+    "GitSyncStartedEvent",
+    "GitSyncSucceededEvent",
+    "GrepContext",
+    "GrepFileFilters",
+    "GrepFileMatch",
+    "GrepLimits",
+    "GrepLine",
+    "GrepPagination",
+    "GrepQuery",
+    "GrepResolvedQuery",
+    "GrepResolvedRef",
+    "MergeSourceState",
+    "MergeTargetState",
+    "Meta",
+    "MetaIPs",
+    "MetaProvider",
+    "NotesRef",
+    "NotesWriteResponse",
+    "NotesWriteResult",
+    "PreviewMergeBlob",
+    "PreviewMergeConflict",
+    "PreviewMergeFilteredConflict",
+    "RefUpdateResult",
+    "ReposArchiveGetRequest",
+    "ReposBlameGetResponse",
+    "ReposBranchesCreateRequest",
+    "ReposBranchesCreateResponse",
+    "ReposBranchesDeleteRequest",
+    "ReposBranchesDeleteResponse",
+    "ReposBranchesGetResponse",
+    "ReposBranchesListResponse",
+    "ReposCommitsCreateFromDiffRequest",
+    "ReposCommitsCreateRequest",
+    "ReposCommitsGetResponse",
+    "ReposCommitsListResponse",
+    "ReposCommitsRestoreRequest",
+    "ReposCommitsRestoreResponse",
+    "ReposCreateRequest",
+    "ReposCreateResponse",
+    "ReposDeleteResponse",
+    "ReposDiffGetResponse",
+    "ReposFilesListResponse",
+    "ReposFilesMetadataListResponse",
+    "ReposGitCredentialsCreateRequest",
+    "ReposGitCredentialsUpdateRequest",
+    "ReposGrepRequest",
+    "ReposGrepResponse",
+    "ReposListResponse",
+    "ReposMergeRequest",
+    "ReposMergeResponse",
+    "ReposNotesAppendRequest",
+    "ReposNotesCreateRequest",
+    "ReposNotesDeleteRequest",
+    "ReposNotesGetResponse",
+    "ReposNotesRefsListResponse",
+    "ReposPreviewMergeResponse",
+    "ReposTagsCreateRequest",
+    "ReposTagsCreateResponse",
+    "ReposTagsDeleteResponse",
+    "ReposTagsGetResponse",
+    "ReposTagsListResponse",
+    "ReposUpdateRequest",
+    "ReposUpdateResponse",
+    "ReposUpstreamDeleteResponse",
+    "ReposUpstreamPullRequest",
+    "ReposUpstreamPullResponse",
+    "Repository",
+    "RestoredCommit",
+    "Tag",
+    "TagListItem",
+    "UpstreamConfig",
+    "UpstreamRepo",
+    "WebhookRepository",
+    "WrittenCommit",
+]
+
+
+class ArchiveOptions(TypedDict):
+    """Output settings for an archive, such as a prefix for every file path."""
+
+    # Prefix to add to every file path inside the archive.
+    prefix: NotRequired[str]
+
+
+class BaseRepo(TypedDict):
+    """Code Storage repository that a new repository copies once. The deprecated form, with provider and operation, also describes a sync or a fork."""
+
+    # Authentication for the source repository. A copy requires auth.token.
+    auth: NotRequired["BaseRepoAuth"]
+    # Deprecated: use the top-level default_branch for a copy or a sync.
+    default_branch: NotRequired[str]
+    # Name of the Code Storage repository to copy. In the deprecated form, the repository name on the provider.
+    name: str
+    # Deprecated: base_repo without provider is a copy, and upstream is a sync. In the deprecated form, sync (the default) or fork.
+    operation: NotRequired[Union[Literal["fork", "sync"], str]]
+    # Deprecated: omit it for a copy, and use upstream.owner for a sync.
+    owner: NotRequired[str]
+    # Deprecated: omit it for a copy, and use upstream for a sync. In the deprecated form, the provider of the source.
+    provider: NotRequired[
+        Union[
+            Literal[
+                "bitbucket",
+                "code.storage",
+                "codeberg",
+                "forgejo",
+                "gitea",
+                "github",
+                "gitlab",
+                "sourcehut",
+                "sr.ht",
+            ],
+            str,
+        ]
+    ]
+    # Branch, tag, or commit SHA to copy. It defaults to the HEAD of the source repository.
+    ref: NotRequired[str]
+    # Deprecated: use ref, which accepts a commit SHA.
+    sha: NotRequired[str]
+    # Deprecated: use upstream.host.
+    upstream_host: NotRequired[str]
+
+
+class BaseRepoAuth(TypedDict):
+    """Authentication used to access the base repository for sync or fork operations."""
+
+    # Deprecated: use upstream.access for a public GitHub sync. A copy needs no auth_type.
+    auth_type: NotRequired[Union[Literal["jwt", "public"], str]]
+    # JWT with git:read on the source repository. A copy requires it.
+    token: NotRequired[str]
+
+
+class BlameLine(TypedDict):
+    """Single blame entry describing the commit and author responsible for a line."""
+
+    # Author email of the commit that last touched this line.
+    author_email: str
+    # Author of the commit that last touched this line.
+    author_name: str
+    # Author timestamp in RFC 3339 format.
+    author_time: str
+    # Commit SHA that last touched this line.
+    commit_sha: str
+    # Committer email of the commit that last touched this line.
+    committer_email: str
+    # Committer of the commit that last touched this line.
+    committer_name: str
+    # Committer timestamp in RFC 3339 format.
+    committer_time: str
+    # Line number in the current file.
+    line_number: int
+    # Line number in the original file before any renames or moves.
+    original_line_number: int
+    # Original repository-relative path the line was introduced at.
+    original_path: str
+    # Commit SHA prior to the current commit when known.
+    previous_commit_sha: NotRequired[str]
+    # First line of the commit message.
+    summary: str
+
+
+class BlobChunk(TypedDict):
+    """Part of the content of one file in a create-commit NDJSON body. Send the chunks of a file in order, and set `eof` on the last one."""
+
+    # Ties the chunk to a file operation.
+    content_id: str
+    # Base64-encoded payload (decoded payload must be at most 4 MiB per chunk).
+    data: str
+    # Set true on the final chunk for that content_id.
+    eof: bool
+
+
+class Branch(TypedDict):
+    """A branch."""
+
+    # ISO 8601 creation timestamp.
+    created_at: str
+    # HEAD commit SHA for the branch.
+    head_sha: str
+    # Branch name.
+    name: str
+
+
+class BranchListItem(Branch):
+    """A branch in a list, with its pagination cursor."""
+
+    # Opaque pagination token for this branch entry.
+    cursor: str
+
+
+class Commit(TypedDict):
+    """Commit metadata. For a signed commit, repos.commits.get also returns the armored signature and the signed payload."""
+
+    # Commit author email.
+    author_email: str
+    # Commit author name.
+    author_name: str
+    # Commit committer timestamp in RFC 3339 format. A rebase or cherry-pick sets it to a later time than the author timestamp.
+    committer_date: NotRequired[str]
+    # Commit committer email.
+    committer_email: str
+    # Commit committer name.
+    committer_name: str
+    # Commit author timestamp in RFC 3339 format.
+    date: str
+    # The commit message. In repos.commits.get responses, the full message. In repos.commits.list responses, only the subject line: the first paragraph of the message as one line, without the body and the trailers.
+    message: str
+    # Parent commit SHAs in Git parent order. Empty for root commits.
+    parent_shas: List[str]
+    # The signed payload: the raw commit object with the gpgsig header removed. This is the exact data the signature is computed over. Present in repos.commits.get responses when the commit is signed.
+    payload: NotRequired[str]
+    # The commit SHA.
+    sha: str
+    # Armored signature from the commit's gpgsig header (OpenPGP or SSH). Present in repos.commits.get responses when the commit is signed.
+    signature: NotRequired[str]
+
+
+class CommitWriteResponse(TypedDict):
+    """Result of applying an NDJSON commit pack, including the resulting commit and branch update."""
+
+    # Commit object information generated by the storage service.
+    commit: "WrittenCommit"
+    # Final branch update outcome.
+    result: "RefUpdateResult"
+
+
+class DiffChunk(TypedDict):
+    """Part of the Git patch in a create-commit-from-diff NDJSON body. Send the chunks in order, and set `eof` on the last one."""
+
+    # Base64-encoded diff bytes. Decoded payloads must be at most 4 MiB. Combined diff must be compatible with git apply --cached --binary.
+    data: str
+    # Set true on the final chunk to signal end-of-stream.
+    eof: bool
+
+
+class DiffStats(TypedDict):
+    """Aggregate diff statistics across all files."""
+
+    # Total added lines across the diff.
+    additions: int
+    # Total line changes (additions plus deletions).
+    changes: int
+    # Total deleted lines across the diff.
+    deletions: int
+    # Number of files changed.
+    files: int
+
+
+class FileDiff(TypedDict):
+    """Per-file diff entry including the raw unified diff text."""
+
+    # Added lines in this file.
+    additions: int
+    # File size in bytes.
+    bytes: int
+    # Deleted lines in this file.
+    deletions: int
+    # Whether the file ends with a newline.
+    is_eof: bool
+    # Previous file path for renamed files.
+    old_path: NotRequired[str]
+    # Repository-relative file path (new location for renames).
+    path: str
+    # Raw unified diff content.
+    raw: str
+    # Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).
+    state: str
+
+
+class FileEntry(TypedDict):
+    """Tree entry in a list-files response, including the repository-rooted path, six-digit Git mode, and derived type."""
+
+    # Six-digit Git mode for the entry.
+    mode: str
+    # Repository-rooted path.
+    path: str
+    # Entry type: blob, tree, symlink, or submodule.
+    type: str
+
+
+class FileLastCommit(TypedDict):
+    """Commit metadata shared by one or more files in a list-files-with-metadata response."""
+
+    # Author display name for the commit.
+    author: str
+    # RFC 3339 author date for the commit.
+    date: str
+    # The subject line of the commit message: the first paragraph of the message as one line, without the body and the trailers. repos.commits.get returns the full message.
+    message: str
+    # History-order rank relative to the resolved ref: 0 is the commit closest to the ref tip (newest in history), larger values are older. Derived from a topological walk rather than author dates, so callers can rank a folder's latest change by the smallest order among its files.
+    order: int
+
+
+class FileOperation(TypedDict):
+    """A file that a commit adds, replaces, or deletes."""
+
+    # Identifier that blob chunks reference for this file. Required for upsert.
+    content_id: NotRequired[str]
+    # File mode such as 100644 or 100755. Defaults to 100644.
+    mode: NotRequired[str]
+    # upsert (default) to add or replace content, or delete to remove a file.
+    operation: NotRequired[str]
+    # Repository-relative path, with no leading slash.
+    path: str
+
+
+class FileWithMetadata(TypedDict):
+    """File entry in a list-files-with-metadata response, including mode, type, and the SHA of the most recent commit that touched it."""
+
+    # Commit SHA of the most recent commit that touched this file.
+    last_commit_sha: str
+    # File mode as stored in Git, for example 100644.
+    mode: str
+    # Repository-relative file path.
+    path: str
+    # File size in bytes.
+    size: int
+    # Derived file type: blob, tree, symlink, or submodule.
+    type: str
+
+
+class FilteredFile(TypedDict):
+    """Per-file diff entry that was excluded from inline diff output because of size or file-type rules."""
+
+    # File size in bytes.
+    bytes: int
+    # Whether the file ends with a newline.
+    is_eof: bool
+    # Previous file path for renamed files.
+    old_path: NotRequired[str]
+    # Repository-relative file path (new location for renames). Excluded from inline diff content because of size or file-type rules.
+    path: str
+    # Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).
+    state: str
+
+
+class GitCredential(TypedDict):
+    """Stored Git credential summary returned after a credential is created or updated."""
+
+    # Credential creation timestamp in ISO 8601 format.
+    created_at: NotRequired[str]
+    # Credential ID returned when the credential is created.
+    id: str
+
+
+class GitIdentity(TypedDict):
+    """Author or committer identity for a commit."""
+
+    # Email address.
+    email: str
+    # Display name.
+    name: str
+
+
+class GitPushEvent(TypedDict):
+    """A Git ref update. The type field and the X-Pierre-Event header identify this payload as push."""
+
+    # The event type. `verify_webhook` always sets it.
+    type: Literal["push"]
+    # The new commit SHA. All zeros for a deleted ref.
+    after: str
+    # The previous commit SHA. All zeros for a newly created ref.
+    before: str
+    # Deprecated: use org. The internal ID of the customer that owns the repository.
+    customer_id: str
+    # The organization name. It is the iss claim of the JWTs that the organization signs. It can be absent on older deliveries.
+    org: NotRequired[str]
+    # When the push occurred, as an RFC 3339 timestamp.
+    pushed_at: str
+    # The full Git ref name, for example refs/heads/main.
+    ref: str
+    # The repository that produced the event.
+    repository: "WebhookRepository"
+
+
+class GitSyncFailedEvent(TypedDict):
+    """Sent when a repository sync run fails, including failures after retries are exhausted and infrastructure failures. Internal cancellations do not produce this event. run_count includes the run that just finished."""
+
+    # The event type. `verify_webhook` always sets it.
+    type: Literal["repo.sync.failed"]
+    # When the sync run finished, as an RFC 3339 timestamp.
+    completed_at: str
+    # The failure message.
+    error: str
+    # Whether the repository had never synced successfully before this run began.
+    is_first_sync: bool
+    # The sync lifecycle ID. It can be absent on older deliveries.
+    lifecycle_id: NotRequired[str]
+    # The organization name. It is the iss claim of the JWTs that the organization signs. It can be absent on older deliveries.
+    org: NotRequired[str]
+    # The repository that produced the event.
+    repository: "WebhookRepository"
+    # Completed sync runs. For started events, this excludes the current run. For succeeded and failed events, it includes the current run.
+    run_count: int
+    # When the sync run began, as an RFC 3339 timestamp.
+    started_at: str
+
+
+class GitSyncStartedEvent(TypedDict):
+    """Sent when a repository sync run begins, before the upstream fetch starts. run_count counts previously completed runs."""
+
+    # The event type. `verify_webhook` always sets it.
+    type: Literal["repo.sync.started"]
+    # Whether the repository had never synced successfully before this run began.
+    is_first_sync: bool
+    # The sync lifecycle ID. It can be absent on older deliveries.
+    lifecycle_id: NotRequired[str]
+    # The organization name. It is the iss claim of the JWTs that the organization signs. It can be absent on older deliveries.
+    org: NotRequired[str]
+    # The repository that produced the event.
+    repository: "WebhookRepository"
+    # Completed sync runs. For started events, this excludes the current run. For succeeded and failed events, it includes the current run.
+    run_count: int
+    # When the sync run began, as an RFC 3339 timestamp.
+    started_at: str
+
+
+class GitSyncSucceededEvent(TypedDict):
+    """Sent when a repository sync run completes successfully. run_count includes the run that just finished."""
+
+    # The event type. `verify_webhook` always sets it.
+    type: Literal["repo.sync.succeeded"]
+    # When the sync run finished, as an RFC 3339 timestamp.
+    completed_at: str
+    # Whether the repository had never synced successfully before this run began.
+    is_first_sync: bool
+    # The sync lifecycle ID. It can be absent on older deliveries.
+    lifecycle_id: NotRequired[str]
+    # The organization name. It is the iss claim of the JWTs that the organization signs. It can be absent on older deliveries.
+    org: NotRequired[str]
+    # The repository that produced the event.
+    repository: "WebhookRepository"
+    # Completed sync runs. For started events, this excludes the current run. For succeeded and failed events, it includes the current run.
+    run_count: int
+    # When the sync run began, as an RFC 3339 timestamp.
+    started_at: str
+
+
+class GrepContext(TypedDict):
+    """Number of context lines to return before and after each match."""
+
+    # Number of lines to include after each match.
+    after: NotRequired[int]
+    # Number of lines to include before each match.
+    before: NotRequired[int]
+
+
+class GrepFileFilters(TypedDict):
+    """Glob and extension filters that select the files to search."""
+
+    # Glob patterns for files to exclude.
+    exclude_globs: NotRequired[List[str]]
+    # File extensions to filter by (e.g. [".js", ".py"]).
+    extension_filters: NotRequired[List[str]]
+    # Glob patterns for files to include.
+    include_globs: NotRequired[List[str]]
+
+
+class GrepFileMatch(TypedDict):
+    """Matches grouped under a single file path."""
+
+    # Lines returned for the match, including optional context lines.
+    lines: List["GrepLine"]
+    # Repository-relative file path that matched.
+    path: str
+
+
+class GrepLimits(TypedDict):
+    """Limits on the total lines and on the matches for each file in a grep response."""
+
+    # Maximum total lines to return (default 2000, max 2000).
+    max_lines: NotRequired[int]
+    # Maximum matches returned per file (default 200).
+    max_matches_per_file: NotRequired[int]
+
+
+class GrepLine(TypedDict):
+    """Single line returned by grep, either a match or a surrounding context line."""
+
+    # Line number in the file.
+    line_number: int
+    # Line text content.
+    text: str
+    # match for lines satisfying the pattern, or context for surrounding context lines.
+    type: str
+
+
+class GrepPagination(TypedDict):
+    """Cursor and page size for grep matches."""
+
+    # Pagination cursor returned by a previous grep response.
+    cursor: NotRequired[str]
+    # Maximum number of matches to return (default 200).
+    limit: NotRequired[int]
+
+
+class GrepQuery(TypedDict):
+    """Pattern to search for, and whether the search is case-sensitive."""
+
+    # Defaults to true when omitted.
+    case_sensitive: NotRequired[bool]
+    # Regular expression or literal pattern to search for.
+    pattern: str
+
+
+class GrepResolvedQuery(TypedDict):
+    """Query settings that the server used for the search."""
+
+    # Echoed case-sensitivity setting.
+    case_sensitive: bool
+    # Echoed pattern that was searched.
+    pattern: str
+
+
+class GrepResolvedRef(TypedDict):
+    """Ref and resolved commit that the search ran against."""
+
+    # Resolved commit SHA the grep ran against.
+    commit: str
+    # Ref that was grepped.
+    ref: str
+
+
+class MergeSourceState(TypedDict):
+    """Resolved source ref state for a merge response."""
+
+    # Deprecated: use ref. Source branch name.
+    branch: str
+    # Whether the source ref was resolved under the ephemeral namespace.
+    ephemeral: bool
+    # The source ref the merge reads.
+    ref: str
+    # Resolved source SHA.
+    sha: str
+
+
+class MergeTargetState(TypedDict):
+    """Resolved target ref state for a merge response, including the previous and new tip SHAs."""
+
+    # Target branch name.
+    branch: str
+    # Whether the target ref was resolved under the ephemeral namespace.
+    ephemeral: bool
+    # New target tip SHA after the merge.
+    new_sha: str
+    # Previous target tip SHA before the merge.
+    old_sha: str
+
+
+class Meta(TypedDict):
+    """Cloud location and inbound IP addresses of the Code Storage cluster that serves the current organisation."""
+
+    # Public IPv4 addresses, in CIDR notation, that accept inbound traffic for the organisation. Allow these in firewall rules that restrict outbound connections to Code Storage.
+    ips: "MetaIPs"
+    # Cloud provider and region that host the organisation.
+    provider: "MetaProvider"
+
+
+class MetaIPs(TypedDict):
+    """Inbound IPv4 address ranges of the cluster, grouped by the kind of traffic they accept."""
+
+    # Addresses that accept HTTP API traffic. Empty when no addresses are published for the organisation's cluster.
+    api: List[str]
+    # Addresses that accept Git over HTTPS traffic. Empty when no addresses are published for the organisation's cluster.
+    git: List[str]
+
+
+class MetaProvider(TypedDict):
+    """Cloud provider and region of the cluster that serves the current organisation."""
+
+    # Cloud provider that hosts the organisation, such as aws or gcp. Empty when the gateway cannot determine its location.
+    name: str
+    # Cloud provider region that hosts the organisation. Empty when the gateway cannot determine its location.
+    region: str
+
+
+class NotesRef(TypedDict):
+    """Git notes ref entry including its full ref name and current tip SHA."""
+
+    # Opaque pagination token for this notes ref entry.
+    cursor: str
+    # Full notes ref name.
+    ref: str
+    # Current tip SHA stored in the notes ref.
+    sha: str
+
+
+class NotesWriteResponse(TypedDict):
+    """Result of a notes write operation, including the resulting notes ref state."""
+
+    # Previous notes ref commit SHA.
+    base_commit: NotRequired[str]
+    # New notes ref SHA after the operation.
+    new_ref_sha: str
+    # The notes ref the operation updates.
+    notes_ref: str
+    # Operation result with success, status, and optional message.
+    result: "NotesWriteResult"
+    # The commit SHA the note is attached to.
+    sha: str
+    # Deprecated: use notes_ref. The notes ref the operation updates.
+    target_ref: str
+
+
+class NotesWriteResult(TypedDict):
+    """Result of a notes write: whether it succeeded, a status, and an optional message."""
+
+    # Optional human-readable message.
+    message: NotRequired[str]
+    # Status code (e.g. ok).
+    status: str
+    # Whether the operation succeeded.
+    success: bool
+
+
+class PreviewMergeBlob(TypedDict):
+    """Single Git blob rendered as part of a merge conflict preview."""
+
+    # Whether the blob appears to be binary content.
+    binary: bool
+    # UTF-8 text content when available and not binary.
+    content: NotRequired[str]
+    # Git object ID for this blob.
+    oid: NotRequired[str]
+    # Whether content was truncated by server-side limits.
+    truncated: bool
+
+
+class PreviewMergeConflict(TypedDict):
+    """Inline conflict content for a single conflicted repository path."""
+
+    # Base stage blob.
+    base: "PreviewMergeBlob"
+    # Target branch stage blob.
+    ours: "PreviewMergeBlob"
+    # Repository path for this conflict.
+    path: str
+    # Best-effort merged blob content, usually with conflict markers for text conflicts.
+    result: "PreviewMergeBlob"
+    # Source branch stage blob.
+    theirs: "PreviewMergeBlob"
+
+
+class PreviewMergeFilteredConflict(TypedDict):
+    """Conflict omitted from inline content because of request or server limits."""
+
+    # Repository path omitted from inline conflict content.
+    path: str
+    # Reason the conflict content was omitted.
+    reason: str
+
+
+class RefUpdateResult(TypedDict):
+    """Branch update outcome for an operation that writes a commit."""
+
+    # Deprecated: use target_branch. The branch the operation updates.
+    branch: str
+    # Optional human-readable message.
+    message: NotRequired[str]
+    # New tip SHA after the update.
+    new_sha: str
+    # Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).
+    old_sha: str
+    # Status code (ok, conflict, precondition_failed, etc.).
+    status: Union[
+        Literal[
+            "conflict",
+            "failed",
+            "forbidden",
+            "internal",
+            "invalid",
+            "not_found",
+            "ok",
+            "payload_too_large",
+            "precondition_failed",
+            "timeout",
+            "unauthorized",
+            "unavailable",
+        ],
+        str,
+    ]
+    # Whether the operation succeeded.
+    success: bool
+    # The branch the operation updates.
+    target_branch: str
+
+
+class ReposArchiveGetRequest(TypedDict):
+    """Archive options describing the ref to snapshot and the include or exclude filters applied to the resulting tarball."""
+
+    # Optional archive output settings.
+    archive: NotRequired["ArchiveOptions"]
+    # Exclude files matching these glob patterns after include filtering.
+    exclude_globs: NotRequired[List[str]]
+    # Only include files matching these glob patterns.
+    include_globs: NotRequired[List[str]]
+    # Maximum blob size to include in the archive, in bytes.
+    max_blob_size: NotRequired[int]
+    # Branch, tag, or commit to archive. When omitted, the default branch or HEAD is used.
+    ref: NotRequired[str]
+
+
+class ReposBlameGetResponse(TypedDict):
+    """Per-line blame information for the requested file at the resolved revision."""
+
+    # Commit SHA the blame was computed at.
+    commit_sha: str
+    # Per-line blame results in file order.
+    lines: List["BlameLine"]
+    # Repository-relative file path that was blamed.
+    path: str
+    # Resolved ref used for the blame.
+    ref: str
+
+
+class ReposBranchesCreateRequest(TypedDict):
+    """Create-branch request body describing the new branch and its base ref."""
+
+    # Deprecated: use base_ref. Preferred source branch name.
+    base_branch: NotRequired[str]
+    # Whether the base branch should be resolved from the ephemeral namespace.
+    base_is_ephemeral: NotRequired[bool]
+    # Optional source ref or revision. Provide base_ref or the deprecated base_branch.
+    base_ref: NotRequired[str]
+    # Allow non-fast-forward updates when recreating an existing named branch. Requires target_branch.
+    force: NotRequired[bool]
+    # Optional pack hint. A branch name the backend prefers as the delta base when it builds the thin pack. It does not change the source or the result.
+    preferred_base: NotRequired[str]
+    # Optional destination branch name. Omit it to let the server allocate a name.
+    target_branch: NotRequired[str]
+    # Whether the new branch should be created in the ephemeral namespace.
+    target_is_ephemeral: NotRequired[bool]
+
+
+class ReposBranchesCreateResponse(TypedDict):
+    """Result of creating a branch, including the resulting ref state."""
+
+    # Resolved commit SHA at the new branch tip.
+    commit_sha: NotRequired[str]
+    # Human-readable result message.
+    message: str
+    # Destination branch name.
+    target_branch: str
+    # Whether the created branch is ephemeral.
+    target_is_ephemeral: bool
+
+
+class ReposBranchesDeleteRequest(TypedDict):
+    """Deprecated branch deletion body. Use the target_branch and ephemeral query parameters."""
+
+    # Deprecated: use the ephemeral query parameter. Delete the branch from the ephemeral namespace instead of the default namespace.
+    ephemeral: NotRequired[bool]
+    # Deprecated: use the target_branch query parameter. Branch name to delete.
+    name: NotRequired[str]
+    # Deprecated: use the target_branch query parameter. Branch name to delete. Must not start with refs/.
+    target_branch: NotRequired[str]
+
+
+class ReposBranchesDeleteResponse(TypedDict):
+    """Result of deleting a branch."""
+
+    # Whether the deleted branch lived in the ephemeral namespace.
+    ephemeral: bool
+    # Human-readable result message.
+    message: str
+    # Deprecated: use target_branch. Deleted branch name.
+    name: str
+    # Deleted branch name.
+    target_branch: str
+
+
+class ReposBranchesGetResponse(TypedDict):
+    """One branch that matches an exact short name."""
+
+    # The branch that has the requested name.
+    branch: "Branch"
+
+
+class ReposBranchesListResponse(TypedDict):
+    """Paginated list of branches for the repository."""
+
+    # List of branch objects.
+    branches: List["BranchListItem"]
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+
+
+class ReposCommitsCreateFromDiffRequest(TypedDict):
+    """Metadata line of a create-commit-from-diff NDJSON body: the target branch and the commit message and identities. The `diff_chunk` lines that follow carry the patch."""
+
+    # Author identity for the commit.
+    author: "GitIdentity"
+    # Source branch to seed from when target_branch does not exist yet.
+    base_branch: NotRequired[str]
+    # When true, interpret base_branch as ephemeral.
+    base_is_ephemeral: NotRequired[bool]
+    # Commit message for the new commit.
+    commit_message: str
+    # Committer identity. Defaults to author when omitted.
+    committer: NotRequired["GitIdentity"]
+    # Deprecated: use target_is_ephemeral. When true, write the target branch under the ephemeral namespace.
+    ephemeral: NotRequired[bool]
+    # Deprecated: use base_is_ephemeral. When true, interpret base_branch as ephemeral.
+    ephemeral_base: NotRequired[bool]
+    # Deprecated: use expected_target_sha. Guard ensuring the branch tip matches before applying the patch.
+    expected_head_sha: NotRequired[str]
+    # Guard ensuring the target branch tip matches before applying the patch.
+    expected_target_sha: NotRequired[str]
+    # Destination branch name.
+    target_branch: str
+    # When true, write the target branch under the ephemeral namespace.
+    target_is_ephemeral: NotRequired[bool]
+
+
+class ReposCommitsCreateRequest(TypedDict):
+    """Metadata line of a create-commit NDJSON body: the target branch, the commit message and identities, and the file operations. The `blob_chunk` lines that follow carry the file content."""
+
+    # Author identity for the commit.
+    author: "GitIdentity"
+    # Source branch to copy when target_branch does not yet exist.
+    base_branch: NotRequired[str]
+    # When true, interpret base_branch as ephemeral.
+    base_is_ephemeral: NotRequired[bool]
+    # Commit message for the new commit.
+    commit_message: str
+    # Committer identity. Defaults to author when omitted.
+    committer: NotRequired["GitIdentity"]
+    # Deprecated: use target_is_ephemeral. When true, write the target branch under the ephemeral namespace.
+    ephemeral: NotRequired[bool]
+    # Deprecated: use base_is_ephemeral. When true, interpret base_branch as ephemeral.
+    ephemeral_base: NotRequired[bool]
+    # Deprecated: use expected_target_sha. Commit SHA that must match the branch tip before writing.
+    expected_head_sha: NotRequired[str]
+    # Commit SHA that must match the target branch tip before writing. Omit to fast-forward unconditionally.
+    expected_target_sha: NotRequired[str]
+    # File operations applied in this commit.
+    files: List["FileOperation"]
+    # Destination branch name (no refs/ prefix).
+    target_branch: str
+    # When true, write the target branch under the ephemeral namespace.
+    target_is_ephemeral: NotRequired[bool]
+
+
+class ReposCommitsGetResponse(TypedDict):
+    """Commit metadata for a single resolved revision, without diff content."""
+
+    # Resolved commit metadata.
+    commit: "Commit"
+
+
+class ReposCommitsListResponse(TypedDict):
+    """Paginated commit history for the repository, optionally filtered by branch."""
+
+    # List of commit objects.
+    commits: List["Commit"]
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+
+
+class ReposCommitsRestoreRequest(TypedDict):
+    """Metadata line of a restore-commit NDJSON body: the branch to reset, the revision to reset it to, and the commit identities. The body has no other line."""
+
+    # Author identity for the restore commit.
+    author: "GitIdentity"
+    # Branch, tag, or commit to reset the branch to. Provide base_ref or the deprecated target_commit_sha.
+    base_ref: NotRequired[str]
+    # Commit message for the restore commit. Defaults to a message that names the branch and the commit.
+    commit_message: NotRequired[str]
+    # Committer identity. Defaults to author when omitted.
+    committer: NotRequired["GitIdentity"]
+    # Deprecated: use expected_target_sha. Guard ensuring the current tip matches before applying the restore.
+    expected_head_sha: NotRequired[str]
+    # Guard ensuring the target branch tip matches before applying the restore.
+    expected_target_sha: NotRequired[str]
+    # Branch name to reset (no refs/ prefix).
+    target_branch: str
+    # Deprecated: use base_ref. Commit to reset the branch to.
+    target_commit_sha: NotRequired[str]
+
+
+class ReposCommitsRestoreResponse(TypedDict):
+    """Result of a restore commit operation, including the created commit and the branch update."""
+
+    # Created restore commit metadata.
+    commit: "RestoredCommit"
+    # Branch update result.
+    result: "RefUpdateResult"
+
+
+class ReposCreateRequest(TypedDict):
+    """Create-repository request body. It supplies the optional repository name, default branch, and Git Sync or fork configuration."""
+
+    # Code Storage repository to copy once. The new repository keeps no link to it. Do not set it together with upstream.
+    base_repo: NotRequired["BaseRepo"]
+    # Default branch for the new repository. When omitted, a copy takes the default branch of the source, a sync from GitHub takes the default branch of the GitHub repository, and any other repository uses main.
+    default_branch: NotRequired[str]
+    # Name of the new repository. It can contain a slash.
+    repo_name: NotRequired[str]
+    # External Git host to keep syncing from. The link lasts, and the repository can sync again. Do not set it together with base_repo.
+    upstream: NotRequired["UpstreamConfig"]
+
+
+class ReposCreateResponse(TypedDict):
+    """Result of creating a repository, including its repository name."""
+
+    # Deprecated: use repo_name. Repository name or path, not a full URL.
+    http_url: str
+    # Human-readable result: the repository was created, or it already exists. The status gives the same result: 201 or 200.
+    message: str
+    # Deprecated: use repo_name. Stable repository identifier.
+    repo_id: str
+    # Repository name or path. It can contain a slash. It matches the JWT repo claim.
+    repo_name: str
+
+
+class ReposDeleteResponse(TypedDict):
+    """Confirmation that the repository deletion has been accepted."""
+
+    # Human-readable deletion status message.
+    message: str
+    # Deprecated: use repo_name. Stable repository identifier.
+    repo_id: str
+    # Repository name or path. It can contain a slash. It matches the JWT repo claim.
+    repo_name: str
+
+
+class ReposDiffGetResponse(TypedDict):
+    """Diff for a single commit, including merge base when applicable, aggregate stats, and per-file changes."""
+
+    # The commit that the base revision (base_ref) resolved to. Empty for a single-commit diff. Use it to record the exact base of the comparison.
+    base_sha: NotRequired[str]
+    # Files returned with inline diff content.
+    files: List["FileDiff"]
+    # Files filtered out of inline diff output because of size or file-type rules.
+    filtered_files: List["FilteredFile"]
+    # The merge base of base_ref and ref: the commit where the diff starts. Empty for a single-commit diff.
+    merge_base_sha: NotRequired[str]
+    # The commit SHA to diff.
+    sha: str
+    # Aggregate diff statistics.
+    stats: "DiffStats"
+
+
+class ReposFilesListResponse(TypedDict):
+    """Paginated tree entries in the repository at the resolved revision."""
+
+    # Tree entries for the resolved revision.
+    entries: List["FileEntry"]
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+    # Flat blob-only path list. Mirrors the path of every entry whose type is "blob". Convenience shape for callers that just want file paths; use entries when you need type/mode.
+    paths: List[str]
+    # The resolved reference (branch name or commit SHA) that was used.
+    ref: str
+
+
+class ReposFilesMetadataListResponse(TypedDict):
+    """Files in the repository at the resolved revision, each annotated with mode, type, and the latest commit that changed it."""
+
+    # Commit metadata keyed by last_commit_sha so repeated commits are only sent once.
+    commits: Dict[str, "FileLastCommit"]
+    # Files in the resolved revision, each annotated with the latest commit that changed it.
+    files: List["FileWithMetadata"]
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+    # The resolved ref or commit used to generate the listing.
+    ref: str
+
+
+class ReposGitCredentialsCreateRequest(TypedDict):
+    """Request body for storing a new HTTPS Git credential when the repository is identified via the URL path."""
+
+    # Password or access token for the upstream provider.
+    password: str
+    # Username for HTTPS authentication. Optional. With no username, requests to the upstream send the token as the password with the username `x-token-auth` for Bitbucket and `oauth2` for GitLab, and as the username for Gitea, Forgejo, and Codeberg. sr.ht takes no credential over HTTPS: it serves private repositories and pushes only over SSH.
+    username: NotRequired[str]
+
+
+class ReposGitCredentialsUpdateRequest(TypedDict):
+    """Request body for rotating an existing HTTPS Git credential when the credential is identified via the URL path."""
+
+    # Updated password or access token for the upstream provider.
+    password: str
+    # Username for HTTPS authentication. Optional. With no username, requests to the upstream send the token as the password with the username `x-token-auth` for Bitbucket and `oauth2` for GitLab, and as the username for Gitea, Forgejo, and Codeberg. sr.ht takes no credential over HTTPS: it serves private repositories and pushes only over SSH. An omitted username clears the stored one.
+    username: NotRequired[str]
+
+
+class ReposGrepRequest(TypedDict):
+    """Grep request describing the pattern, ref, filters, limits, and pagination for a repository content search."""
+
+    # Lines of context to include before and after each match.
+    context: NotRequired["GrepContext"]
+    # Whether ref should be resolved from the ephemeral namespace.
+    ephemeral: NotRequired[bool]
+    # Optional include and exclude filters applied before matching.
+    file_filters: NotRequired["GrepFileFilters"]
+    # Maximum line and per-file match limits.
+    limits: NotRequired["GrepLimits"]
+    # Cursor-based pagination controls for large result sets.
+    pagination: NotRequired["GrepPagination"]
+    # Optional path prefixes used to narrow the search before pattern matching.
+    paths: NotRequired[List[str]]
+    # Pattern configuration.
+    query: "GrepQuery"
+    # Preferred branch, tag, or commit to search.
+    ref: NotRequired[str]
+    # Deprecated: use ref. Legacy ref field retained for backwards compatibility.
+    rev: NotRequired[str]
+
+
+class ReposGrepResponse(TypedDict):
+    """Grep results grouped per file, including the resolved ref and pagination state."""
+
+    # Whether additional matches remain.
+    has_more: bool
+    # True when the result set is incomplete because the server-side output cap was reached. Matches beyond the cap exist in the repo but cannot be retrieved by paging: narrow the query (pattern, paths, file filters) or raise max_lines if it was set below the maximum. next_cursor still pages through everything collected below the cap.
+    incomplete_results: bool
+    # Files that matched the query, each with matching and context lines.
+    matches: List["GrepFileMatch"]
+    # Opaque cursor for the next page, if any.
+    next_cursor: Optional[str]
+    # The effective query settings used by the server.
+    query: "GrepResolvedQuery"
+    # Resolved repository ref and commit used for the search.
+    repo: "GrepResolvedRef"
+
+
+class ReposListResponse(TypedDict):
+    """Paginated list of repositories for the current organisation."""
+
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+    # Repositories in the current page.
+    repos: List["Repository"]
+
+
+class ReposMergeRequest(TypedDict):
+    """Merge request body specifying source and target branches, optional pinned source SHA, merge strategy, optional squash flag, and optional retry-on-target-move behavior, which is currently unsupported for GitHub-backed public targets."""
+
+    # Permit merges between unrelated histories.
+    allow_unrelated_histories: NotRequired[bool]
+    # Author identity used when the backend creates a merge commit. Required for merge-commit strategies.
+    author: NotRequired["GitIdentity"]
+    # Commit message used when a merge commit is created.
+    commit_message: NotRequired[str]
+    # Committer identity for the merge commit. Defaults to author when omitted.
+    committer: NotRequired["GitIdentity"]
+    # Optional source commit guard. The merge uses this commit instead of the current tip of source_ref, and fails if source_ref does not contain it when the merge starts. A later advance of source_ref does not change the merged commit.
+    expected_source_sha: NotRequired[str]
+    # Optional branch tip guard. The merge fails if the target has moved since this SHA.
+    expected_target_sha: NotRequired[str]
+    # Deprecated: use source_ref. Source branch to merge from.
+    source_branch: NotRequired[str]
+    # Whether source_ref should be resolved from the ephemeral namespace.
+    source_is_ephemeral: NotRequired[bool]
+    # Branch or refs/heads ref to merge from. The merge reads the source and never updates it. Provide source_ref or the deprecated source_branch.
+    source_ref: NotRequired[str]
+    # When true, collapse the source into a single new commit whose only parent is the current target tip. Defaults to false, which preserves the standard merge/fast-forward behavior. Incompatible with the ff_only strategy.
+    squash: NotRequired[bool]
+    # Merge strategy. merge creates a merge commit when needed, ff_only rejects non-fast-forward merges, and ff_prefer fast-forwards when possible before falling back to a merge commit.
+    strategy: Union[Literal["ff_only", "ff_prefer", "merge"], str]
+    # Destination branch to update. A merge always updates a branch.
+    target_branch: str
+    # Whether target_branch should be resolved from the ephemeral namespace.
+    target_is_ephemeral: NotRequired[bool]
+
+
+class ReposMergeResponse(TypedDict):
+    """Merge outcome including the resulting commit, source and target state, merge base information, and retry attempt counters when applicable."""
+
+    # Commit SHA for the merge result. For a fast-forward or no-op, this is the resulting target tip.
+    commit_sha: str
+    # Merge base SHA when one exists and the backend reports it.
+    merge_base_sha: NotRequired[str]
+    # Number of commits promoted from source onto target.
+    promoted_commits: int
+    # Merge outcome: merge_commit, fast_forward, no_op, squash, or unknown.
+    result: str
+    # Source ref metadata with branch, ephemeral, and resolved sha.
+    source: "MergeSourceState"
+    # Target ref metadata with branch, ephemeral, previous old_sha, and resulting new_sha.
+    target: "MergeTargetState"
+    # Tree SHA for the resulting commit or target tip.
+    tree_sha: str
+
+
+class ReposNotesAppendRequest(TypedDict):
+    """Append-note request describing the Git object, the text to add, and the optional notes ref guard."""
+
+    # Author object with name and email for the notes commit.
+    author: NotRequired["GitIdentity"]
+    # Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.
+    expected_notes_ref_sha: NotRequired[str]
+    # Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.
+    expected_ref_sha: NotRequired[str]
+    # Plain text to add to the note.
+    note: str
+    # Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.
+    notes_ref: NotRequired[str]
+    # Git object the note attaches to: a full object SHA (a commit, tree, blob, or annotated tag), or a branch, tag, or other revision that resolves to a commit. Provide object_ref or the deprecated sha.
+    object_ref: NotRequired[str]
+    # Deprecated: use notes_ref. Optional notes ref to target.
+    ref: NotRequired[str]
+    # Deprecated: use object_ref. Git object SHA to attach the note to.
+    sha: NotRequired[str]
+
+
+class ReposNotesCreateRequest(TypedDict):
+    """Create-note request describing the Git object, the note content, and the optional notes ref guard."""
+
+    # Deprecated: use POST /notes/append to append. add creates a note and fails if one already exists. append adds text to the note, and creates the note if none exists.
+    action: NotRequired[str]
+    # Author object with name and email for the notes commit.
+    author: NotRequired["GitIdentity"]
+    # Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.
+    expected_notes_ref_sha: NotRequired[str]
+    # Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.
+    expected_ref_sha: NotRequired[str]
+    # Plain-text note content. Required.
+    note: NotRequired[str]
+    # Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.
+    notes_ref: NotRequired[str]
+    # Git object the note attaches to: a full object SHA (a commit, tree, blob, or annotated tag), or a branch, tag, or other revision that resolves to a commit. Provide object_ref or the deprecated sha.
+    object_ref: NotRequired[str]
+    # Deprecated: use notes_ref. Optional notes ref to target.
+    ref: NotRequired[str]
+    # Deprecated: use object_ref. Git object SHA to attach the note to.
+    sha: NotRequired[str]
+
+
+class ReposNotesDeleteRequest(TypedDict):
+    """Deprecated delete-note body. Use the object_ref, notes_ref, and expected_notes_ref_sha query parameters."""
+
+    # Deprecated: a delete ignores action.
+    action: NotRequired[str]
+    # Deprecated: no replacement. Without author, the notes commit of a delete has the default author. Author object with name and email for the notes commit.
+    author: NotRequired["GitIdentity"]
+    # Deprecated: use the expected_notes_ref_sha query parameter. Optional compare-and-swap guard for the notes ref.
+    expected_notes_ref_sha: NotRequired[str]
+    # Deprecated: use the expected_notes_ref_sha query parameter. Optional compare-and-swap guard for the notes ref.
+    expected_ref_sha: NotRequired[str]
+    # Deprecated: a delete ignores note.
+    note: NotRequired[str]
+    # Deprecated: use the notes_ref query parameter. Optional notes ref to target.
+    notes_ref: NotRequired[str]
+    # Deprecated: use the object_ref query parameter. Git object the note attaches to.
+    object_ref: NotRequired[str]
+    # Deprecated: use the notes_ref query parameter. Optional notes ref to target.
+    ref: NotRequired[str]
+    # Deprecated: use the object_ref query parameter. Git object SHA the note attaches to.
+    sha: NotRequired[str]
+
+
+class ReposNotesGetResponse(TypedDict):
+    """A single Git note attached to a commit, including the current notes ref tip."""
+
+    # The note content.
+    note: str
+    # Current SHA of the notes ref the note was read from.
+    ref_sha: str
+    # The commit SHA.
+    sha: str
+
+
+class ReposNotesRefsListResponse(TypedDict):
+    """Paginated list of Git notes refs under the requested prefix."""
+
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+    # Normalized notes ref prefix used for the listing.
+    prefix: str
+    # List of notes refs.
+    refs: List["NotesRef"]
+
+
+class ReposPreviewMergeResponse(TypedDict):
+    """Read-only merge preview result, including clean or conflicted status and optional inline conflict content."""
+
+    # Repository paths that conflicted during the merge preview.
+    conflict_paths: List[str]
+    # Inline conflict content, populated only when include_content=true.
+    conflicts: List["PreviewMergeConflict"]
+    # Conflicts omitted from inline content because of request or server limits.
+    filtered_conflicts: NotRequired[List["PreviewMergeFilteredConflict"]]
+    # Merge base SHA used for the preview.
+    merge_base_sha: NotRequired[str]
+    # Operation result if applied: merge_commit, fast_forward, or no_op.
+    result: Union[Literal["fast_forward", "merge_commit", "no_op"], str]
+    # Source branch requested by the caller.
+    source_branch: str
+    # Resolved source branch tip SHA.
+    source_tip_sha: str
+    # Preview status: clean or conflicted.
+    status: Union[Literal["clean", "conflicted"], str]
+    # Target branch requested by the caller.
+    target_branch: str
+    # Resolved target branch tip SHA.
+    target_tip_sha: str
+
+
+class ReposTagsCreateRequest(TypedDict):
+    """Create-tag request body describing the new tag and the commit it points to."""
+
+    # Tag name. Must be a valid Git ref name and must not start with refs/.
+    name: str
+    # Branch, tag, or commit the tag should point to. Provide ref or the deprecated target.
+    ref: NotRequired[str]
+    # Deprecated: use ref. Commit the tag should point to.
+    target: NotRequired[str]
+
+
+class ReposTagsCreateResponse(TypedDict):
+    """Result of creating a tag."""
+
+    # Human-readable result message.
+    message: str
+    # Tag name.
+    name: str
+    # Commit SHA the tag points to.
+    sha: str
+
+
+class ReposTagsDeleteResponse(TypedDict):
+    """Result of deleting a tag."""
+
+    # Human-readable result message.
+    message: str
+    # Tag name.
+    name: str
+
+
+class ReposTagsGetResponse(TypedDict):
+    """One tag that matches an exact short name."""
+
+    # The tag that has the requested name.
+    tag: "Tag"
+
+
+class ReposTagsListResponse(TypedDict):
+    """Paginated list of tags for the repository."""
+
+    # Whether another page is available.
+    has_more: bool
+    # Opaque cursor for the next page. Pass it as `cursor` to read the next page. Absent when there are no more results.
+    next_cursor: NotRequired[str]
+    # List of tag objects.
+    tags: List["TagListItem"]
+
+
+class ReposUpdateRequest(TypedDict):
+    """Repository settings to patch, such as the default branch."""
+
+    # New default branch name for the Code Storage repository.
+    default_branch: NotRequired[str]
+
+
+class ReposUpdateResponse(TypedDict):
+    """Repository state after applying the patch."""
+
+    # Updated default branch name.
+    default_branch: str
+    # Deprecated: use repo_name. Stable repository identifier.
+    id: str
+    # Deprecated: use repo_name. Stable repository identifier.
+    repo_id: str
+    # Repository name or path. It can contain a slash. It matches the JWT repo claim.
+    repo_name: str
+    # Deprecated: use repo_name. Repository name or path, not a full URL.
+    url: str
+
+
+class ReposUpstreamDeleteResponse(TypedDict):
+    """Confirmation that the upstream link has been detached from the repository."""
+
+    # Human-readable detach status message.
+    message: str
+
+
+class ReposUpstreamPullRequest(TypedDict):
+    """Deprecated upstream pull body. Its fields have no effect, so send no body."""
+
+    # Deprecated: omit it. The field has no effect, and no response returns a token for it. A pull syncs every branch and tag of the upstream.
+    after: NotRequired[str]
+    # Deprecated: omit it. The field has no effect: a pull syncs every branch and tag of the upstream.
+    ref: NotRequired[str]
+
+
+class ReposUpstreamPullResponse(TypedDict):
+    """Acknowledgement that an upstream sync has been initiated; the sync itself runs asynchronously."""
+
+    # Human-readable status message.
+    message: str
+
+
+class Repository(TypedDict):
+    """A repository, including its Git Sync upstream when one is configured."""
+
+    # Deprecated: use upstream. The upstream of the repository, when it has one.
+    base_repo: NotRequired["UpstreamRepo"]
+    # ISO 8601 creation timestamp.
+    created_at: str
+    # Default branch name.
+    default_branch: str
+    # Deprecated: use repo_name. Stable repository identifier.
+    repo_id: str
+    # Repository name or path. It can contain a slash. It matches the JWT repo claim.
+    repo_name: str
+    # External Git host that the repository keeps syncing from. Absent when the repository has no upstream.
+    upstream: NotRequired["UpstreamRepo"]
+    # Deprecated: use repo_name. Repository name or path, not a full URL.
+    url: str
+
+
+class RestoredCommit(TypedDict):
+    """Commit object generated by a restore-commit operation."""
+
+    # SHA of the new restore commit.
+    commit_sha: str
+    # Size of the generated pack in bytes.
+    pack_bytes: int
+    # Branch that was reset.
+    target_branch: str
+    # Tree SHA of the restore commit.
+    tree_sha: str
+
+
+class Tag(TypedDict):
+    """A tag."""
+
+    # Tag name.
+    name: str
+    # Dereferenced commit SHA for the tag.
+    sha: str
+
+
+class TagListItem(Tag):
+    """A tag in a list, with its pagination cursor."""
+
+    # Opaque pagination token for this tag entry.
+    cursor: str
+
+
+class UpstreamConfig(TypedDict):
+    """External Git host that a new repository keeps syncing from."""
+
+    # GitHub only. app (the default) reads through the GitHub App installation of the organization. public mirrors a public repository without an installation, and syncs only on request.
+    access: NotRequired[Union[Literal["app", "public"], str]]
+    # Bare hostname of a self-hosted provider, such as gitlab.example.com. It defaults to the public host of the provider.
+    host: NotRequired[str]
+    # Repository name on the upstream provider.
+    name: str
+    # Repository owner or namespace on the upstream provider.
+    owner: str
+    # External Git host of the upstream repository.
+    provider: Union[
+        Literal[
+            "bitbucket", "codeberg", "forgejo", "gitea", "github", "gitlab", "sourcehut", "sr.ht"
+        ],
+        str,
+    ]
+
+
+class UpstreamRepo(TypedDict):
+    """Git Sync upstream of a repository."""
+
+    # Upstream repository name.
+    name: NotRequired[str]
+    # Upstream repository owner or namespace.
+    owner: NotRequired[str]
+    # Upstream provider name.
+    provider: str
+
+
+class WebhookRepository(TypedDict):
+    """The repository that produced the event."""
+
+    # The internal repository ID.
+    id: str
+    # The repository name, for example team/project. It can be absent on older deliveries.
+    repo_name: NotRequired[str]
+    # Deprecated: use repo_name, which has the same value. The repository name, for example team/project.
+    url: str
+
+
+class WrittenCommit(TypedDict):
+    """Commit object information generated when a pack is applied."""
+
+    # Number of blobs included in the pack.
+    blob_count: int
+    # SHA of the new commit.
+    commit_sha: str
+    # Size of the generated pack in bytes.
+    pack_bytes: int
+    # Branch the commit was written to.
+    target_branch: str
+    # Tree SHA of the new commit.
+    tree_sha: str