gitd-client 0.0.0-stage → 0.7.0

package/dist/gen/gitd/v1/gitd_pb.d.ts

@@ -0,0 +1,1258 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file gitd/v1/gitd.proto.
+ */
+export declare const file_gitd_v1_gitd: GenFile;
+/**
+ * What opens repositories whose address starts with `url_prefix`, on any host:
+ * e.g. `https://github.com/acme/` or `https://gitlab.example.com/acme/tools/`. A port in
+ * it is ignored, as it is in a repository's address: ports are the host's (gitd.toml).
+ *
+ * @generated from message gitd.v1.Credential
+ */
+export type Credential = Message<"gitd.v1.Credential"> & {
+    /**
+     * @generated from field: string url_prefix = 1;
+     */
+    urlPrefix: string;
+    /**
+     * @generated from oneof gitd.v1.Credential.secret
+     */
+    secret: {
+        /**
+         * Sent as `Authorization: Basic <https_user>:<token>`. A repository this opens is
+         * read over HTTPS even when it was written as `git@` or `ssh://`.
+         *
+         * @generated from field: string https_token = 2;
+         */
+        value: string;
+        case: "httpsToken";
+    } | {
+        /**
+         * A private key that is already on this server.
+         *
+         * @generated from field: string ssh_key_path = 3;
+         */
+        value: string;
+        case: "sshKeyPath";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * The user name that goes with `https_token`. Empty is the one the host expects for a
+     * token: `oauth2` on gitlab.com, `x-token-auth` on bitbucket.org and `x-access-token`
+     * anywhere else (GitHub, and Gitea and Forgejo, which take any name). A self-hosted
+     * GitLab wants `oauth2`, and a Bitbucket app password the account's own name.
+     *
+     * @generated from field: string https_user = 4;
+     */
+    httpsUser: string;
+};
+/**
+ * Describes the message gitd.v1.Credential.
+ * Use `create(CredentialSchema)` to create a new message.
+ */
+export declare const CredentialSchema: GenMessage<Credential>;
+/**
+ * Where a workspace points: a branch, or a commit, or the repository's default branch.
+ *
+ * @generated from message gitd.v1.Revision
+ */
+export type Revision = Message<"gitd.v1.Revision"> & {
+    /**
+     * @generated from oneof gitd.v1.Revision.target
+     */
+    target: {
+        /**
+         * @generated from field: string branch = 1;
+         */
+        value: string;
+        case: "branch";
+    } | {
+        /**
+         * @generated from field: string commit = 2;
+         */
+        value: string;
+        case: "commit";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.Revision.
+ * Use `create(RevisionSchema)` to create a new message.
+ */
+export declare const RevisionSchema: GenMessage<Revision>;
+/**
+ * @generated from message gitd.v1.Progress
+ */
+export type Progress = Message<"gitd.v1.Progress"> & {
+    /**
+     * What git is doing: "Receiving objects", "Resolving deltas", "Submodule vendor/web".
+     *
+     * @generated from field: string phase = 1;
+     */
+    phase: string;
+    /**
+     * 0 to 100, or -1 when git does not say.
+     *
+     * @generated from field: int32 percent = 2;
+     */
+    percent: number;
+    /**
+     * Which repository it is about, for an operation that touches several.
+     *
+     * @generated from field: string repository = 3;
+     */
+    repository: string;
+};
+/**
+ * Describes the message gitd.v1.Progress.
+ * Use `create(ProgressSchema)` to create a new message.
+ */
+export declare const ProgressSchema: GenMessage<Progress>;
+/**
+ * @generated from message gitd.v1.SubmoduleState
+ */
+export type SubmoduleState = Message<"gitd.v1.SubmoduleState"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * @generated from field: string url = 2;
+     */
+    url: string;
+    /**
+     * @generated from field: string commit = 3;
+     */
+    commit: string;
+    /**
+     * @generated from field: bool checked_out = 4;
+     */
+    checkedOut: boolean;
+};
+/**
+ * Describes the message gitd.v1.SubmoduleState.
+ * Use `create(SubmoduleStateSchema)` to create a new message.
+ */
+export declare const SubmoduleStateSchema: GenMessage<SubmoduleState>;
+/**
+ * A submodule that could not be brought in, and why. The rest of the operation went on.
+ *
+ * @generated from message gitd.v1.PendingSubmodule
+ */
+export type PendingSubmodule = Message<"gitd.v1.PendingSubmodule"> & {
+    /**
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * @generated from field: string path = 2;
+     */
+    path: string;
+    /**
+     * @generated from field: gitd.v1.GitFailure failure = 3;
+     */
+    failure?: GitFailure | undefined;
+};
+/**
+ * Describes the message gitd.v1.PendingSubmodule.
+ * Use `create(PendingSubmoduleSchema)` to create a new message.
+ */
+export declare const PendingSubmoduleSchema: GenMessage<PendingSubmodule>;
+/**
+ * Attached to every error as a detail.
+ *
+ * @generated from message gitd.v1.GitFailure
+ */
+export type GitFailure = Message<"gitd.v1.GitFailure"> & {
+    /**
+     * @generated from field: gitd.v1.GitFailure.Reason reason = 1;
+     */
+    reason: GitFailure_Reason;
+    /**
+     * The last useful line git wrote, e.g. "remote: Repository not found.".
+     *
+     * @generated from field: string git_said = 2;
+     */
+    gitSaid: string;
+    /**
+     * The repository the failure is about.
+     *
+     * @generated from field: string repository = 3;
+     */
+    repository: string;
+};
+/**
+ * Describes the message gitd.v1.GitFailure.
+ * Use `create(GitFailureSchema)` to create a new message.
+ */
+export declare const GitFailureSchema: GenMessage<GitFailure>;
+/**
+ * @generated from enum gitd.v1.GitFailure.Reason
+ */
+export declare enum GitFailure_Reason {
+    /**
+     * @generated from enum value: REASON_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: REASON_AUTH_REQUIRED = 1;
+     */
+    AUTH_REQUIRED = 1,
+    /**
+     * @generated from enum value: REASON_AUTH_REFUSED = 2;
+     */
+    AUTH_REFUSED = 2,
+    /**
+     * @generated from enum value: REASON_NOT_FOUND = 3;
+     */
+    NOT_FOUND = 3,
+    /**
+     * @generated from enum value: REASON_BAD_ADDRESS = 4;
+     */
+    BAD_ADDRESS = 4,
+    /**
+     * @generated from enum value: REASON_PATH_REFUSED = 5;
+     */
+    PATH_REFUSED = 5,
+    /**
+     * @generated from enum value: REASON_BUSY = 6;
+     */
+    BUSY = 6,
+    /**
+     * @generated from enum value: REASON_TIMEOUT = 7;
+     */
+    TIMEOUT = 7,
+    /**
+     * @generated from enum value: REASON_CORRUPT = 8;
+     */
+    CORRUPT = 8,
+    /**
+     * @generated from enum value: REASON_GIT_FAILED = 9;
+     */
+    GIT_FAILED = 9,
+    /**
+     * @generated from enum value: REASON_NOTHING_NEW = 10;
+     */
+    NOTHING_NEW = 10,
+    /**
+     * The branch is outside the prefix publishing is limited to.
+     *
+     * @generated from enum value: REASON_BRANCH_REFUSED = 11;
+     */
+    BRANCH_REFUSED = 11,
+    /**
+     * The workspace's git configuration sets something gitd does not run git under, such
+     * as a filter or a hook path: whoever writes in the workspace could otherwise have gitd
+     * run a command of theirs.
+     *
+     * @generated from enum value: REASON_CONFIG_REFUSED = 12;
+     */
+    CONFIG_REFUSED = 12
+}
+/**
+ * Describes the enum gitd.v1.GitFailure.Reason.
+ */
+export declare const GitFailure_ReasonSchema: GenEnum<GitFailure_Reason>;
+/**
+ * @generated from message gitd.v1.PrepareRequest
+ */
+export type PrepareRequest = Message<"gitd.v1.PrepareRequest"> & {
+    /**
+     * The repository: `https://host/owner/[group/…]name`, `user@host:owner/name` or
+     * `ssh://user@host[:port]/owner/name`, with or without `.git`.
+     *
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * An absolute path inside one of the roots gitd is configured with.
+     *
+     * @generated from field: string path = 2;
+     */
+    path: string;
+    /**
+     * @generated from field: gitd.v1.Revision revision = 3;
+     */
+    revision?: Revision | undefined;
+    /**
+     * @generated from field: bool with_submodules = 4;
+     */
+    withSubmodules: boolean;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 5;
+     */
+    credentials: Credential[];
+    /**
+     * The repository's whole history, for `git log` and `git blame` to go back as far as in
+     * a clone; later updates keep it.
+     * Otherwise only what is checked out, without the history behind it; submodules are
+     * always so.
+     *
+     * @generated from field: bool full_history = 6;
+     */
+    fullHistory: boolean;
+    /**
+     * How to make it, when there is a preference: STRATEGY_COPY writes every file even where
+     * an overlay could be mounted. Unspecified is gitd's choice, the fastest this machine
+     * allows. A strategy that cannot run here falls back to copy; the result says which ran.
+     *
+     * @generated from field: gitd.v1.Strategy strategy = 7;
+     */
+    strategy: Strategy;
+};
+/**
+ * Describes the message gitd.v1.PrepareRequest.
+ * Use `create(PrepareRequestSchema)` to create a new message.
+ */
+export declare const PrepareRequestSchema: GenMessage<PrepareRequest>;
+/**
+ * The directories of an overlay workspace: the template below, read only, and the
+ * workspace's own layer above.
+ *
+ * @generated from message gitd.v1.Layers
+ */
+export type Layers = Message<"gitd.v1.Layers"> & {
+    /**
+     * @generated from field: string lower = 1;
+     */
+    lower: string;
+    /**
+     * @generated from field: string upper = 2;
+     */
+    upper: string;
+    /**
+     * @generated from field: string work = 3;
+     */
+    work: string;
+};
+/**
+ * Describes the message gitd.v1.Layers.
+ * Use `create(LayersSchema)` to create a new message.
+ */
+export declare const LayersSchema: GenMessage<Layers>;
+/**
+ * @generated from message gitd.v1.PrepareResponse
+ */
+export type PrepareResponse = Message<"gitd.v1.PrepareResponse"> & {
+    /**
+     * @generated from oneof gitd.v1.PrepareResponse.event
+     */
+    event: {
+        /**
+         * @generated from field: gitd.v1.Progress progress = 1;
+         */
+        value: Progress;
+        case: "progress";
+    } | {
+        /**
+         * @generated from field: gitd.v1.WorkspaceResult result = 2;
+         */
+        value: WorkspaceResult;
+        case: "result";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.PrepareResponse.
+ * Use `create(PrepareResponseSchema)` to create a new message.
+ */
+export declare const PrepareResponseSchema: GenMessage<PrepareResponse>;
+/**
+ * @generated from message gitd.v1.WorkspaceResult
+ */
+export type WorkspaceResult = Message<"gitd.v1.WorkspaceResult"> & {
+    /**
+     * @generated from field: string commit = 1;
+     */
+    commit: string;
+    /**
+     * @generated from field: string branch = 2;
+     */
+    branch: string;
+    /**
+     * @generated from field: repeated gitd.v1.PendingSubmodule pending_submodules = 3;
+     */
+    pendingSubmodules: PendingSubmodule[];
+    /**
+     * How the workspace was made, and its layers when by overlay.
+     *
+     * @generated from field: gitd.v1.Strategy strategy = 4;
+     */
+    strategy: Strategy;
+    /**
+     * @generated from field: gitd.v1.Layers layers = 5;
+     */
+    layers?: Layers | undefined;
+    /**
+     * The patterns the repository's .gitattributes sends to git LFS, e.g. "*.onnx": those files
+     * are pointers in the workspace, as gitd does not download LFS objects. Empty when the
+     * repository uses no LFS.
+     *
+     * @generated from field: repeated string lfs_patterns = 6;
+     */
+    lfsPatterns: string[];
+};
+/**
+ * Describes the message gitd.v1.WorkspaceResult.
+ * Use `create(WorkspaceResultSchema)` to create a new message.
+ */
+export declare const WorkspaceResultSchema: GenMessage<WorkspaceResult>;
+/**
+ * @generated from message gitd.v1.UpdateRequest
+ */
+export type UpdateRequest = Message<"gitd.v1.UpdateRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * Empty means the branch the workspace follows, also after a rollback left it detached.
+     *
+     * @generated from field: string branch = 2;
+     */
+    branch: string;
+    /**
+     * @generated from field: bool with_submodules = 3;
+     */
+    withSubmodules: boolean;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 4;
+     */
+    credentials: Credential[];
+};
+/**
+ * Describes the message gitd.v1.UpdateRequest.
+ * Use `create(UpdateRequestSchema)` to create a new message.
+ */
+export declare const UpdateRequestSchema: GenMessage<UpdateRequest>;
+/**
+ * @generated from message gitd.v1.UpdateResponse
+ */
+export type UpdateResponse = Message<"gitd.v1.UpdateResponse"> & {
+    /**
+     * @generated from oneof gitd.v1.UpdateResponse.event
+     */
+    event: {
+        /**
+         * @generated from field: gitd.v1.Progress progress = 1;
+         */
+        value: Progress;
+        case: "progress";
+    } | {
+        /**
+         * @generated from field: gitd.v1.WorkspaceResult result = 2;
+         */
+        value: WorkspaceResult;
+        case: "result";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.UpdateResponse.
+ * Use `create(UpdateResponseSchema)` to create a new message.
+ */
+export declare const UpdateResponseSchema: GenMessage<UpdateResponse>;
+/**
+ * @generated from message gitd.v1.CheckoutRequest
+ */
+export type CheckoutRequest = Message<"gitd.v1.CheckoutRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * Required: the commit to move to.
+     *
+     * @generated from field: string commit = 2;
+     */
+    commit: string;
+    /**
+     * @generated from field: bool with_submodules = 3;
+     */
+    withSubmodules: boolean;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 4;
+     */
+    credentials: Credential[];
+};
+/**
+ * Describes the message gitd.v1.CheckoutRequest.
+ * Use `create(CheckoutRequestSchema)` to create a new message.
+ */
+export declare const CheckoutRequestSchema: GenMessage<CheckoutRequest>;
+/**
+ * @generated from message gitd.v1.CheckoutResponse
+ */
+export type CheckoutResponse = Message<"gitd.v1.CheckoutResponse"> & {
+    /**
+     * @generated from oneof gitd.v1.CheckoutResponse.event
+     */
+    event: {
+        /**
+         * @generated from field: gitd.v1.Progress progress = 1;
+         */
+        value: Progress;
+        case: "progress";
+    } | {
+        /**
+         * @generated from field: gitd.v1.WorkspaceResult result = 2;
+         */
+        value: WorkspaceResult;
+        case: "result";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.CheckoutResponse.
+ * Use `create(CheckoutResponseSchema)` to create a new message.
+ */
+export declare const CheckoutResponseSchema: GenMessage<CheckoutResponse>;
+/**
+ * @generated from message gitd.v1.SyncSubmodulesRequest
+ */
+export type SyncSubmodulesRequest = Message<"gitd.v1.SyncSubmodulesRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * Only this submodule, by repository URL. Empty means all of them.
+     *
+     * @generated from field: string only_url = 2;
+     */
+    onlyUrl: string;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 3;
+     */
+    credentials: Credential[];
+};
+/**
+ * Describes the message gitd.v1.SyncSubmodulesRequest.
+ * Use `create(SyncSubmodulesRequestSchema)` to create a new message.
+ */
+export declare const SyncSubmodulesRequestSchema: GenMessage<SyncSubmodulesRequest>;
+/**
+ * @generated from message gitd.v1.SyncSubmodulesResponse
+ */
+export type SyncSubmodulesResponse = Message<"gitd.v1.SyncSubmodulesResponse"> & {
+    /**
+     * @generated from oneof gitd.v1.SyncSubmodulesResponse.event
+     */
+    event: {
+        /**
+         * @generated from field: gitd.v1.Progress progress = 1;
+         */
+        value: Progress;
+        case: "progress";
+    } | {
+        /**
+         * @generated from field: gitd.v1.SyncSubmodulesResult result = 2;
+         */
+        value: SyncSubmodulesResult;
+        case: "result";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.SyncSubmodulesResponse.
+ * Use `create(SyncSubmodulesResponseSchema)` to create a new message.
+ */
+export declare const SyncSubmodulesResponseSchema: GenMessage<SyncSubmodulesResponse>;
+/**
+ * @generated from message gitd.v1.SyncSubmodulesResult
+ */
+export type SyncSubmodulesResult = Message<"gitd.v1.SyncSubmodulesResult"> & {
+    /**
+     * @generated from field: repeated gitd.v1.SubmoduleState submodules = 1;
+     */
+    submodules: SubmoduleState[];
+    /**
+     * @generated from field: repeated gitd.v1.PendingSubmodule pending_submodules = 2;
+     */
+    pendingSubmodules: PendingSubmodule[];
+};
+/**
+ * Describes the message gitd.v1.SyncSubmodulesResult.
+ * Use `create(SyncSubmodulesResultSchema)` to create a new message.
+ */
+export declare const SyncSubmodulesResultSchema: GenMessage<SyncSubmodulesResult>;
+/**
+ * @generated from message gitd.v1.DescribeRequest
+ */
+export type DescribeRequest = Message<"gitd.v1.DescribeRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+};
+/**
+ * Describes the message gitd.v1.DescribeRequest.
+ * Use `create(DescribeRequestSchema)` to create a new message.
+ */
+export declare const DescribeRequestSchema: GenMessage<DescribeRequest>;
+/**
+ * @generated from message gitd.v1.DescribeResponse
+ */
+export type DescribeResponse = Message<"gitd.v1.DescribeResponse"> & {
+    /**
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * @generated from field: string commit = 2;
+     */
+    commit: string;
+    /**
+     * @generated from field: string branch = 3;
+     */
+    branch: string;
+    /**
+     * Whether something on disk differs from the commit, as somebody running git in it may
+     * leave it.
+     *
+     * @generated from field: bool modified = 4;
+     */
+    modified: boolean;
+    /**
+     * @generated from field: repeated gitd.v1.SubmoduleState submodules = 5;
+     */
+    submodules: SubmoduleState[];
+    /**
+     * How the workspace was made, and its layers when by overlay. Workspaces made before
+     * gitd said so read as STRATEGY_COPY.
+     *
+     * @generated from field: gitd.v1.Strategy strategy = 6;
+     */
+    strategy: Strategy;
+    /**
+     * @generated from field: gitd.v1.Layers layers = 7;
+     */
+    layers?: Layers | undefined;
+    /**
+     * The patterns its .gitattributes sends to git LFS, whose files are pointers here.
+     *
+     * @generated from field: repeated string lfs_patterns = 8;
+     */
+    lfsPatterns: string[];
+};
+/**
+ * Describes the message gitd.v1.DescribeResponse.
+ * Use `create(DescribeResponseSchema)` to create a new message.
+ */
+export declare const DescribeResponseSchema: GenMessage<DescribeResponse>;
+/**
+ * @generated from message gitd.v1.RemoveRequest
+ */
+export type RemoveRequest = Message<"gitd.v1.RemoveRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+};
+/**
+ * Describes the message gitd.v1.RemoveRequest.
+ * Use `create(RemoveRequestSchema)` to create a new message.
+ */
+export declare const RemoveRequestSchema: GenMessage<RemoveRequest>;
+/**
+ * @generated from message gitd.v1.RemoveResponse
+ */
+export type RemoveResponse = Message<"gitd.v1.RemoveResponse"> & {};
+/**
+ * Describes the message gitd.v1.RemoveResponse.
+ * Use `create(RemoveResponseSchema)` to create a new message.
+ */
+export declare const RemoveResponseSchema: GenMessage<RemoveResponse>;
+/**
+ * @generated from message gitd.v1.AdoptRequest
+ */
+export type AdoptRequest = Message<"gitd.v1.AdoptRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+};
+/**
+ * Describes the message gitd.v1.AdoptRequest.
+ * Use `create(AdoptRequestSchema)` to create a new message.
+ */
+export declare const AdoptRequestSchema: GenMessage<AdoptRequest>;
+/**
+ * @generated from message gitd.v1.AdoptResponse
+ */
+export type AdoptResponse = Message<"gitd.v1.AdoptResponse"> & {
+    /**
+     * @generated from oneof gitd.v1.AdoptResponse.event
+     */
+    event: {
+        /**
+         * @generated from field: gitd.v1.Progress progress = 1;
+         */
+        value: Progress;
+        case: "progress";
+    } | {
+        /**
+         * @generated from field: gitd.v1.AdoptResult result = 2;
+         */
+        value: AdoptResult;
+        case: "result";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message gitd.v1.AdoptResponse.
+ * Use `create(AdoptResponseSchema)` to create a new message.
+ */
+export declare const AdoptResponseSchema: GenMessage<AdoptResponse>;
+/**
+ * @generated from message gitd.v1.AdoptResult
+ */
+export type AdoptResult = Message<"gitd.v1.AdoptResult"> & {
+    /**
+     * Disk the workspace no longer holds because its pool does.
+     *
+     * @generated from field: int64 bytes_released = 1;
+     */
+    bytesReleased: bigint;
+};
+/**
+ * Describes the message gitd.v1.AdoptResult.
+ * Use `create(AdoptResultSchema)` to create a new message.
+ */
+export declare const AdoptResultSchema: GenMessage<AdoptResult>;
+/**
+ * @generated from message gitd.v1.PublishRequest
+ */
+export type PublishRequest = Message<"gitd.v1.PublishRequest"> & {
+    /**
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * A branch that does not exist yet: nothing is ever pushed over one that does. It must
+     * start with `[publish] branch_prefix`, when the configuration sets one.
+     *
+     * @generated from field: string branch = 2;
+     */
+    branch: string;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 3;
+     */
+    credentials: Credential[];
+};
+/**
+ * Describes the message gitd.v1.PublishRequest.
+ * Use `create(PublishRequestSchema)` to create a new message.
+ */
+export declare const PublishRequestSchema: GenMessage<PublishRequest>;
+/**
+ * @generated from message gitd.v1.PublishedRepository
+ */
+export type PublishedRepository = Message<"gitd.v1.PublishedRepository"> & {
+    /**
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * Where it is in the workspace: empty for the workspace's own repository.
+     *
+     * @generated from field: string path = 2;
+     */
+    path: string;
+    /**
+     * @generated from field: string commit = 3;
+     */
+    commit: string;
+    /**
+     * The subjects of the commits it brings, newest first: what a pull request is about.
+     *
+     * @generated from field: repeated string subjects = 4;
+     */
+    subjects: string[];
+};
+/**
+ * Describes the message gitd.v1.PublishedRepository.
+ * Use `create(PublishedRepositorySchema)` to create a new message.
+ */
+export declare const PublishedRepositorySchema: GenMessage<PublishedRepository>;
+/**
+ * @generated from message gitd.v1.PublishResponse
+ */
+export type PublishResponse = Message<"gitd.v1.PublishResponse"> & {
+    /**
+     * @generated from field: string branch = 1;
+     */
+    branch: string;
+    /**
+     * @generated from field: gitd.v1.PublishedRepository repository = 2;
+     */
+    repository?: PublishedRepository | undefined;
+    /**
+     * @generated from field: repeated gitd.v1.PublishedRepository submodules = 3;
+     */
+    submodules: PublishedRepository[];
+};
+/**
+ * Describes the message gitd.v1.PublishResponse.
+ * Use `create(PublishResponseSchema)` to create a new message.
+ */
+export declare const PublishResponseSchema: GenMessage<PublishResponse>;
+/**
+ * @generated from message gitd.v1.ProbeRequest
+ */
+export type ProbeRequest = Message<"gitd.v1.ProbeRequest"> & {
+    /**
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * @generated from field: repeated gitd.v1.Credential credentials = 2;
+     */
+    credentials: Credential[];
+};
+/**
+ * Describes the message gitd.v1.ProbeRequest.
+ * Use `create(ProbeRequestSchema)` to create a new message.
+ */
+export declare const ProbeRequestSchema: GenMessage<ProbeRequest>;
+/**
+ * @generated from message gitd.v1.ProbeResponse
+ */
+export type ProbeResponse = Message<"gitd.v1.ProbeResponse"> & {
+    /**
+     * @generated from field: gitd.v1.ProbeResponse.Access access = 1;
+     */
+    access: ProbeResponse_Access;
+    /**
+     * @generated from field: repeated string branches = 2;
+     */
+    branches: string[];
+    /**
+     * The branch the repository's HEAD points at.
+     *
+     * @generated from field: string default_branch = 3;
+     */
+    defaultBranch: string;
+    /**
+     * @generated from field: gitd.v1.GitFailure failure = 4;
+     */
+    failure?: GitFailure | undefined;
+    /**
+     * The commit each branch points at, by branch: what a submodule's gitlink is set to.
+     *
+     * @generated from field: map<string, string> commits = 5;
+     */
+    commits: {
+        [key: string]: string;
+    };
+};
+/**
+ * Describes the message gitd.v1.ProbeResponse.
+ * Use `create(ProbeResponseSchema)` to create a new message.
+ */
+export declare const ProbeResponseSchema: GenMessage<ProbeResponse>;
+/**
+ * @generated from enum gitd.v1.ProbeResponse.Access
+ */
+export declare enum ProbeResponse_Access {
+    /**
+     * @generated from enum value: ACCESS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Read with nothing.
+     *
+     * @generated from enum value: ACCESS_PUBLIC = 1;
+     */
+    PUBLIC = 1,
+    /**
+     * Read with the credentials given.
+     *
+     * @generated from enum value: ACCESS_REACHABLE = 2;
+     */
+    REACHABLE = 2,
+    /**
+     * Not readable with what was given.
+     *
+     * @generated from enum value: ACCESS_DENIED = 3;
+     */
+    DENIED = 3
+}
+/**
+ * Describes the enum gitd.v1.ProbeResponse.Access.
+ */
+export declare const ProbeResponse_AccessSchema: GenEnum<ProbeResponse_Access>;
+/**
+ * @generated from message gitd.v1.RetireRequest
+ */
+export type RetireRequest = Message<"gitd.v1.RetireRequest"> & {
+    /**
+     * At least a day: a pool used moments ago is likely to be wanted again.
+     *
+     * @generated from field: int64 unused_for_seconds = 1;
+     */
+    unusedForSeconds: bigint;
+};
+/**
+ * Describes the message gitd.v1.RetireRequest.
+ * Use `create(RetireRequestSchema)` to create a new message.
+ */
+export declare const RetireRequestSchema: GenMessage<RetireRequest>;
+/**
+ * @generated from message gitd.v1.RetireResponse
+ */
+export type RetireResponse = Message<"gitd.v1.RetireResponse"> & {
+    /**
+     * @generated from field: int32 retired = 1;
+     */
+    retired: number;
+    /**
+     * @generated from field: int64 freed_bytes = 2;
+     */
+    freedBytes: bigint;
+};
+/**
+ * Describes the message gitd.v1.RetireResponse.
+ * Use `create(RetireResponseSchema)` to create a new message.
+ */
+export declare const RetireResponseSchema: GenMessage<RetireResponse>;
+/**
+ * @generated from message gitd.v1.InfoRequest
+ */
+export type InfoRequest = Message<"gitd.v1.InfoRequest"> & {};
+/**
+ * Describes the message gitd.v1.InfoRequest.
+ * Use `create(InfoRequestSchema)` to create a new message.
+ */
+export declare const InfoRequestSchema: GenMessage<InfoRequest>;
+/**
+ * @generated from message gitd.v1.InfoResponse
+ */
+export type InfoResponse = Message<"gitd.v1.InfoResponse"> & {
+    /**
+     * @generated from field: string version = 1;
+     */
+    version: string;
+    /**
+     * What `git version` says, e.g. "git version 2.48.1".
+     *
+     * @generated from field: string git_version = 2;
+     */
+    gitVersion: string;
+    /**
+     * How many pools there are and the disk they take, as of the last maintenance round.
+     *
+     * @generated from field: int32 pools = 3;
+     */
+    pools: number;
+    /**
+     * @generated from field: int64 pools_bytes = 4;
+     */
+    poolsBytes: bigint;
+    /**
+     * How new workspaces are made on this machine, and why: what gitd detected at start.
+     *
+     * @generated from field: gitd.v1.Strategy strategy = 5;
+     */
+    strategy: Strategy;
+    /**
+     * @generated from field: string strategy_reason = 6;
+     */
+    strategyReason: string;
+    /**
+     * How many templates there are and the disk they take, as of the last maintenance round.
+     *
+     * @generated from field: int32 templates = 7;
+     */
+    templates: number;
+    /**
+     * @generated from field: int64 templates_bytes = 8;
+     */
+    templatesBytes: bigint;
+};
+/**
+ * Describes the message gitd.v1.InfoResponse.
+ * Use `create(InfoResponseSchema)` to create a new message.
+ */
+export declare const InfoResponseSchema: GenMessage<InfoResponse>;
+/**
+ * @generated from message gitd.v1.AuditRequest
+ */
+export type AuditRequest = Message<"gitd.v1.AuditRequest"> & {
+    /**
+     * Only the entries from this time on; all of them when unset.
+     *
+     * @generated from field: google.protobuf.Timestamp since = 1;
+     */
+    since?: Timestamp | undefined;
+    /**
+     * Only the publishes of this repository, as its URL is written in the entries.
+     *
+     * @generated from field: string url = 2;
+     */
+    url: string;
+    /**
+     * At most this many, newest first: 100 when unset, never more than 1000.
+     *
+     * @generated from field: int32 limit = 3;
+     */
+    limit: number;
+};
+/**
+ * Describes the message gitd.v1.AuditRequest.
+ * Use `create(AuditRequestSchema)` to create a new message.
+ */
+export declare const AuditRequestSchema: GenMessage<AuditRequest>;
+/**
+ * @generated from message gitd.v1.AuditResponse
+ */
+export type AuditResponse = Message<"gitd.v1.AuditResponse"> & {
+    /**
+     * @generated from field: repeated gitd.v1.AuditEntry entries = 1;
+     */
+    entries: AuditEntry[];
+};
+/**
+ * Describes the message gitd.v1.AuditResponse.
+ * Use `create(AuditResponseSchema)` to create a new message.
+ */
+export declare const AuditResponseSchema: GenMessage<AuditResponse>;
+/**
+ * One publish, done or refused, as the audit log keeps it: one per line of the log file,
+ * in this message's JSON form.
+ *
+ * @generated from message gitd.v1.AuditEntry
+ */
+export type AuditEntry = Message<"gitd.v1.AuditEntry"> & {
+    /**
+     * @generated from field: google.protobuf.Timestamp time = 1;
+     */
+    time?: Timestamp | undefined;
+    /**
+     * The workspace's path, as the caller gave it.
+     *
+     * @generated from field: string workspace = 2;
+     */
+    workspace: string;
+    /**
+     * The workspace's repository; empty when the workspace could not be opened.
+     *
+     * @generated from field: string url = 3;
+     */
+    url: string;
+    /**
+     * @generated from field: string branch = 4;
+     */
+    branch: string;
+    /**
+     * What was pushed: the workspace's repository, then each submodule. Unset when refused.
+     *
+     * @generated from field: gitd.v1.PublishedRepository repository = 5;
+     */
+    repository?: PublishedRepository | undefined;
+    /**
+     * @generated from field: repeated gitd.v1.PublishedRepository submodules = 6;
+     */
+    submodules: PublishedRepository[];
+    /**
+     * Why it was refused. Unset when it was published.
+     *
+     * @generated from field: gitd.v1.GitFailure refusal = 7;
+     */
+    refusal?: GitFailure | undefined;
+};
+/**
+ * Describes the message gitd.v1.AuditEntry.
+ * Use `create(AuditEntrySchema)` to create a new message.
+ */
+export declare const AuditEntrySchema: GenMessage<AuditEntry>;
+/**
+ * How a workspace was made.
+ *
+ * @generated from enum gitd.v1.Strategy
+ */
+export declare enum Strategy {
+    /**
+     * @generated from enum value: STRATEGY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Every file written.
+     *
+     * @generated from enum value: STRATEGY_COPY = 1;
+     */
+    COPY = 1,
+    /**
+     * A layer of its own mounted on a shared template, read only: milliseconds, and only
+     * what changes takes disk.
+     *
+     * @generated from enum value: STRATEGY_OVERLAY = 2;
+     */
+    OVERLAY = 2,
+    /**
+     * The template cloned block by block: almost no disk.
+     *
+     * @generated from enum value: STRATEGY_REFLINK = 3;
+     */
+    REFLINK = 3
+}
+/**
+ * Describes the enum gitd.v1.Strategy.
+ */
+export declare const StrategySchema: GenEnum<Strategy>;
+/**
+ * @generated from service gitd.v1.WorkspaceService
+ */
+export declare const WorkspaceService: GenService<{
+    /**
+     * Create a workspace at a path, from the repository's pool, at a branch or a commit.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Prepare
+     */
+    prepare: {
+        methodKind: "server_streaming";
+        input: typeof PrepareRequestSchema;
+        output: typeof PrepareResponseSchema;
+    };
+    /**
+     * Bring a workspace to the tip of its branch.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Update
+     */
+    update: {
+        methodKind: "server_streaming";
+        input: typeof UpdateRequestSchema;
+        output: typeof UpdateResponseSchema;
+    };
+    /**
+     * Move a workspace to a commit, as a rollback does; the pool fetches it when it lacks it.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Checkout
+     */
+    checkout: {
+        methodKind: "server_streaming";
+        input: typeof CheckoutRequestSchema;
+        output: typeof CheckoutResponseSchema;
+    };
+    /**
+     * Check out every submodule the workspace declares, or one.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.SyncSubmodules
+     */
+    syncSubmodules: {
+        methodKind: "server_streaming";
+        input: typeof SyncSubmodulesRequestSchema;
+        output: typeof SyncSubmodulesResponseSchema;
+    };
+    /**
+     * What the workspace is on disk right now, without the network.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Describe
+     */
+    describe: {
+        methodKind: "unary";
+        input: typeof DescribeRequestSchema;
+        output: typeof DescribeResponseSchema;
+    };
+    /**
+     * Delete a workspace. Its pool stays.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Remove
+     */
+    remove: {
+        methodKind: "unary";
+        input: typeof RemoveRequestSchema;
+        output: typeof RemoveResponseSchema;
+    };
+    /**
+     * Take an existing clone in, linking it to a pool without fetching anything.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Adopt
+     */
+    adopt: {
+        methodKind: "server_streaming";
+        input: typeof AdoptRequestSchema;
+        output: typeof AdoptResponseSchema;
+    };
+    /**
+     * Push what was committed in a workspace to a new branch, with a token, so a pull or merge
+     * request can be opened from it. New commits of its submodules go first, each to a
+     * branch of the same name in its own repository. The branch must start with the
+     * configured prefix, if there is one; every publish, done or refused, is in the audit log.
+     *
+     * @generated from rpc gitd.v1.WorkspaceService.Publish
+     */
+    publish: {
+        methodKind: "unary";
+        input: typeof PublishRequestSchema;
+        output: typeof PublishResponseSchema;
+    };
+}>;
+/**
+ * @generated from service gitd.v1.RepositoryService
+ */
+export declare const RepositoryService: GenService<{
+    /**
+     * Whether a repository can be read with these credentials, and its branches.
+     *
+     * @generated from rpc gitd.v1.RepositoryService.Probe
+     */
+    probe: {
+        methodKind: "unary";
+        input: typeof ProbeRequestSchema;
+        output: typeof ProbeResponseSchema;
+    };
+}>;
+/**
+ * @generated from service gitd.v1.ServerService
+ */
+export declare const ServerService: GenService<{
+    /**
+     * Which gitd answers, and on which git, so a client can tell whether it may use it.
+     *
+     * @generated from rpc gitd.v1.ServerService.Info
+     */
+    info: {
+        methodKind: "unary";
+        input: typeof InfoRequestSchema;
+        output: typeof InfoResponseSchema;
+    };
+    /**
+     * Remove now the pools no workspace borrows from and nothing has used for at least
+     * `unused_for_seconds`, as the maintenance round does after `retire_after`.
+     *
+     * @generated from rpc gitd.v1.ServerService.Retire
+     */
+    retire: {
+        methodKind: "unary";
+        input: typeof RetireRequestSchema;
+        output: typeof RetireResponseSchema;
+    };
+    /**
+     * The audit log: every publish, done or refused, newest first.
+     *
+     * @generated from rpc gitd.v1.ServerService.Audit
+     */
+    audit: {
+        methodKind: "unary";
+        input: typeof AuditRequestSchema;
+        output: typeof AuditResponseSchema;
+    };
+}>;