@dagger.io/dagger 0.9.6 → 0.9.7

package/dist/api/client.gen.d.ts

@@ -49,8 +49,7 @@ export type BuildArg = {
  */
 export declare enum CacheSharingMode {
     /**
-     * Shares the cache volume amongst many build pipelines,
-     * but will serialize the writes
+     * Shares the cache volume amongst many build pipelines, but will serialize the writes
      */
     Locked = "LOCKED",
     /**
@@ -63,7 +62,7 @@ export declare enum CacheSharingMode {
     Shared = "SHARED"
 }
 /**
- * A global cache volume identifier.
+ * The `CacheVolumeID` scalar type represents an identifier for an object of type CacheVolume.
  */
 export type CacheVolumeID = string & {
     __CacheVolumeID: never;
@@ -71,116 +70,108 @@ export type CacheVolumeID = string & {
 export type ContainerAsTarballOpts = {
     /**
      * Identifiers for other platform specific containers.
-     * Used for multi-platform image.
+     *
+     * Used for multi-platform images.
      */
     platformVariants?: Container[];
     /**
      * Force each layer of the image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
      */
     forcedCompression?: ImageLayerCompression;
     /**
-     * Use the specified media types for the image's layers. Defaults to OCI, which
-     * is largely compatible with most recent container runtimes, but Docker may be needed
-     * for older runtimes without OCI support.
+     * Use the specified media types for the image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent container runtimes, but Docker may be needed for older runtimes without OCI support.
      */
     mediaTypes?: ImageMediaTypes;
 };
 export type ContainerBuildOpts = {
     /**
      * Path to the Dockerfile to use.
-     *
-     * Default: './Dockerfile'.
      */
     dockerfile?: string;
-    /**
-     * Additional build arguments.
-     */
-    buildArgs?: BuildArg[];
     /**
      * Target build stage to build.
      */
     target?: string;
+    /**
+     * Additional build arguments.
+     */
+    buildArgs?: BuildArg[];
     /**
      * Secrets to pass to the build.
      *
      * They will be mounted at /run/secrets/[secret-name] in the build container
      *
-     * They can be accessed in the Dockerfile using the "secret" mount type
-     * and mount path /run/secrets/[secret-name]
-     * e.g. RUN --mount=type=secret,id=my-secret curl url?token=$(cat /run/secrets/my-secret)"
+     * They can be accessed in the Dockerfile using the "secret" mount type and mount path /run/secrets/[secret-name], e.g. RUN --mount=type=secret,id=my-secret curl http://example.com?token=$(cat /run/secrets/my-secret)
      */
     secrets?: Secret[];
 };
 export type ContainerExportOpts = {
     /**
      * Identifiers for other platform specific containers.
+     *
      * Used for multi-platform image.
      */
     platformVariants?: Container[];
     /**
      * Force each layer of the exported image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
      */
     forcedCompression?: ImageLayerCompression;
     /**
-     * Use the specified media types for the exported image's layers. Defaults to OCI, which
-     * is largely compatible with most recent container runtimes, but Docker may be needed
-     * for older runtimes without OCI support.
+     * Use the specified media types for the exported image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent container runtimes, but Docker may be needed for older runtimes without OCI support.
      */
     mediaTypes?: ImageMediaTypes;
 };
 export type ContainerImportOpts = {
     /**
-     * Identifies the tag to import from the archive, if the archive bundles
-     * multiple tags.
+     * Identifies the tag to import from the archive, if the archive bundles multiple tags.
      */
     tag?: string;
 };
 export type ContainerPipelineOpts = {
     /**
-     * Pipeline description.
+     * Description of the sub-pipeline.
      */
     description?: string;
     /**
-     * Pipeline labels.
+     * Labels to apply to the sub-pipeline.
      */
     labels?: PipelineLabel[];
 };
 export type ContainerPublishOpts = {
     /**
      * Identifiers for other platform specific containers.
+     *
      * Used for multi-platform image.
      */
     platformVariants?: Container[];
     /**
      * Force each layer of the published image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
      */
     forcedCompression?: ImageLayerCompression;
     /**
-     * Use the specified media types for the published image's layers. Defaults to OCI, which
-     * is largely compatible with most recent registries, but Docker may be needed for older
-     * registries without OCI support.
+     * Use the specified media types for the published image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent registries, but Docker may be needed for older registries without OCI support.
      */
     mediaTypes?: ImageMediaTypes;
 };
 export type ContainerWithDirectoryOpts = {
     /**
-     * Patterns to exclude in the written directory (e.g., ["node_modules/**", ".gitignore", ".git/"]).
+     * Patterns to exclude in the written directory (e.g. ["node_modules/**", ".gitignore", ".git/"]).
      */
     exclude?: string[];
     /**
-     * Patterns to include in the written directory (e.g., ["*.go", "go.mod", "go.sum"]).
+     * Patterns to include in the written directory (e.g. ["*.go", "go.mod", "go.sum"]).
      */
     include?: string[];
     /**
@@ -200,8 +191,7 @@ export type ContainerWithEntrypointOpts = {
 };
 export type ContainerWithEnvVariableOpts = {
     /**
-     * Replace `${VAR}` or $VAR in the value according to the current environment
-     * variables defined in the container (e.g., "/opt/bin:$PATH").
+     * Replace `${VAR}` or `$VAR` in the value according to the current environment variables defined in the container (e.g., "/opt/bin:$PATH").
      */
     expand?: boolean;
 };
@@ -225,15 +215,11 @@ export type ContainerWithExecOpts = {
     /**
      * Provides dagger access to the executed command.
      *
-     * Do not use this option unless you trust the command being executed.
-     * The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
+     * Do not use this option unless you trust the command being executed; the command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      */
     experimentalPrivilegedNesting?: boolean;
     /**
-     * Execute the command with all root capabilities. This is similar to running a command
-     * with "sudo" or executing `docker run` with the `--privileged` flag. Containerization
-     * does not provide any security guarantees when using this option. It should only be used
-     * when absolutely necessary and only with trusted commands.
+     * Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
      */
     insecureRootCapabilities?: boolean;
 };
@@ -250,8 +236,6 @@ export type ContainerWithExposedPortOpts = {
 export type ContainerWithFileOpts = {
     /**
      * Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     permissions?: number;
     /**
@@ -275,9 +259,7 @@ export type ContainerWithMountedCacheOpts = {
     /**
      * A user:group to set for the mounted cache directory.
      *
-     * Note that this changes the ownership of the specified mount along with the
-     * initial filesystem provided by source (if any). It does not have any effect
-     * if/when the cache has already been created.
+     * Note that this changes the ownership of the specified mount along with the initial filesystem provided by source (if any). It does not have any effect if/when the cache has already been created.
      *
      * The user and group can either be an ID (1000:1000) or a name (foo:bar).
      *
@@ -316,9 +298,8 @@ export type ContainerWithMountedSecretOpts = {
     owner?: string;
     /**
      * Permission given to the mounted secret (e.g., 0600).
-     * This option requires an owner to be set to be active.
      *
-     * Default: 0400.
+     * This option requires an owner to be set to be active.
      */
     mode?: number;
 };
@@ -329,8 +310,6 @@ export type ContainerWithNewFileOpts = {
     contents?: string;
     /**
      * Permission given to the written file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     permissions?: number;
     /**
@@ -365,51 +344,38 @@ export type ContainerWithoutExposedPortOpts = {
     protocol?: NetworkProtocol;
 };
 /**
- * A unique container identifier. Null designates an empty container (scratch).
+ * The `ContainerID` scalar type represents an identifier for an object of type Container.
  */
 export type ContainerID = string & {
     __ContainerID: never;
 };
-/**
- * The `DateTime` scalar type represents a DateTime. The DateTime is serialized as an RFC 3339 quoted string
- */
-export type DateTime = string & {
-    __DateTime: never;
-};
 export type DirectoryAsModuleOpts = {
     /**
-     * An optional subpath of the directory which contains the module's source
-     * code.
+     * An optional subpath of the directory which contains the module's source code.
      *
-     * This is needed when the module code is in a subdirectory but requires
-     * parent directories to be loaded in order to execute. For example, the
-     * module source code may need a go.mod, project.toml, package.json, etc. file
-     * from a parent directory.
+     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
      *
-     * If not set, the module source code is loaded from the root of the
-     * directory.
+     * If not set, the module source code is loaded from the root of the directory.
      */
     sourceSubpath?: string;
 };
 export type DirectoryDockerBuildOpts = {
-    /**
-     * Path to the Dockerfile to use (e.g., "frontend.Dockerfile").
-     *
-     * Defaults: './Dockerfile'.
-     */
-    dockerfile?: string;
     /**
      * The platform to build.
      */
     platform?: Platform;
     /**
-     * Build arguments to use in the build.
+     * Path to the Dockerfile to use (e.g., "frontend.Dockerfile").
      */
-    buildArgs?: BuildArg[];
+    dockerfile?: string;
     /**
      * Target build stage to build.
      */
     target?: string;
+    /**
+     * Build arguments to use in the build.
+     */
+    buildArgs?: BuildArg[];
     /**
      * Secrets to pass to the build.
      *
@@ -425,11 +391,11 @@ export type DirectoryEntriesOpts = {
 };
 export type DirectoryPipelineOpts = {
     /**
-     * Pipeline description.
+     * Description of the sub-pipeline.
      */
     description?: string;
     /**
-     * Pipeline labels.
+     * Labels to apply to the sub-pipeline.
      */
     labels?: PipelineLabel[];
 };
@@ -446,42 +412,47 @@ export type DirectoryWithDirectoryOpts = {
 export type DirectoryWithFileOpts = {
     /**
      * Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     permissions?: number;
 };
 export type DirectoryWithNewDirectoryOpts = {
     /**
      * Permission granted to the created directory (e.g., 0777).
-     *
-     * Default: 0755.
      */
     permissions?: number;
 };
 export type DirectoryWithNewFileOpts = {
     /**
      * Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     permissions?: number;
 };
 /**
- * A content-addressed directory identifier.
+ * The `DirectoryID` scalar type represents an identifier for an object of type Directory.
  */
 export type DirectoryID = string & {
     __DirectoryID: never;
 };
+/**
+ * The `EnvVariableID` scalar type represents an identifier for an object of type EnvVariable.
+ */
+export type EnvVariableID = string & {
+    __EnvVariableID: never;
+};
+/**
+ * The `FieldTypeDefID` scalar type represents an identifier for an object of type FieldTypeDef.
+ */
+export type FieldTypeDefID = string & {
+    __FieldTypeDefID: never;
+};
 export type FileExportOpts = {
     /**
-     * If allowParentDirPath is true, the path argument can be a directory path, in which case
-     * the file will be created in that directory.
+     * If allowParentDirPath is true, the path argument can be a directory path, in which case the file will be created in that directory.
      */
     allowParentDirPath?: boolean;
 };
 /**
- * A file identifier.
+ * The `FileID` scalar type represents an identifier for an object of type File.
  */
 export type FileID = string & {
     __FileID: never;
@@ -497,35 +468,53 @@ export type FunctionWithArgOpts = {
     defaultValue?: JSON;
 };
 /**
- * A reference to a FunctionArg.
+ * The `FunctionArgID` scalar type represents an identifier for an object of type FunctionArg.
  */
 export type FunctionArgID = string & {
     __FunctionArgID: never;
 };
 /**
- * A reference to a Function.
+ * The `FunctionCallArgValueID` scalar type represents an identifier for an object of type FunctionCallArgValue.
+ */
+export type FunctionCallArgValueID = string & {
+    __FunctionCallArgValueID: never;
+};
+/**
+ * The `FunctionCallID` scalar type represents an identifier for an object of type FunctionCall.
+ */
+export type FunctionCallID = string & {
+    __FunctionCallID: never;
+};
+/**
+ * The `FunctionID` scalar type represents an identifier for an object of type Function.
  */
 export type FunctionID = string & {
     __FunctionID: never;
 };
 /**
- * A reference to GeneratedCode.
+ * The `GeneratedCodeID` scalar type represents an identifier for an object of type GeneratedCode.
  */
 export type GeneratedCodeID = string & {
     __GeneratedCodeID: never;
 };
 export type GitRefTreeOpts = {
+    /**
+     * DEPRECATED: This option should be passed to `git` instead.
+     */
     sshKnownHosts?: string;
+    /**
+     * DEPRECATED: This option should be passed to `git` instead.
+     */
     sshAuthSocket?: Socket;
 };
 /**
- * A git reference identifier.
+ * The `GitRefID` scalar type represents an identifier for an object of type GitRef.
  */
 export type GitRefID = string & {
     __GitRefID: never;
 };
 /**
- * A git repository identifier.
+ * The `GitRepositoryID` scalar type represents an identifier for an object of type GitRepository.
  */
 export type GitRepositoryID = string & {
     __GitRepositoryID: never;
@@ -545,34 +534,38 @@ export type HostServiceOpts = {
      * Upstream host to forward traffic to.
      */
     host?: string;
-};
-export type HostTunnelOpts = {
     /**
-     * Map each service port to the same port on the host, as if the service were
-     * running natively.
+     * Ports to expose via the service, forwarding through the host network.
      *
-     * Note: enabling may result in port conflicts.
+     * If a port's frontend is unspecified or 0, it defaults to the same as the backend port.
+     *
+     * An empty set of ports is not valid; an error will be returned.
      */
-    native?: boolean;
+    ports: PortForward[];
+};
+export type HostTunnelOpts = {
     /**
      * Configure explicit port forwarding rules for the tunnel.
      *
-     * If a port's frontend is unspecified or 0, a random port will be chosen by
-     * the host.
+     * If a port's frontend is unspecified or 0, a random port will be chosen by the host.
      *
-     * If no ports are given, all of the service's ports are forwarded. If native
-     * is true, each port maps to the same port on the host. If native is false,
-     * each port maps to a random port chosen by the host.
+     * If no ports are given, all of the service's ports are forwarded. If native is true, each port maps to the same port on the host. If native is false, each port maps to a random port chosen by the host.
      *
      * If ports are given and native is true, the ports are additive.
      */
     ports?: PortForward[];
+    /**
+     * Map each service port to the same port on the host, as if the service were running natively.
+     *
+     * Note: enabling may result in port conflicts.
+     */
+    native?: boolean;
 };
 /**
- * The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
+ * The `HostID` scalar type represents an identifier for an object of type Host.
  */
-export type ID = string & {
-    __ID: never;
+export type HostID = string & {
+    __HostID: never;
 };
 /**
  * Compression algorithm to use for image layers.
@@ -590,6 +583,12 @@ export declare enum ImageMediaTypes {
     Dockermediatypes = "DockerMediaTypes",
     Ocimediatypes = "OCIMediaTypes"
 }
+/**
+ * The `InterfaceTypeDefID` scalar type represents an identifier for an object of type InterfaceTypeDef.
+ */
+export type InterfaceTypeDefID = string & {
+    __InterfaceTypeDefID: never;
+};
 /**
  * An arbitrary JSON-encoded value.
  */
@@ -597,7 +596,35 @@ export type JSON = string & {
     __JSON: never;
 };
 /**
- * A reference to a Module.
+ * The `LabelID` scalar type represents an identifier for an object of type Label.
+ */
+export type LabelID = string & {
+    __LabelID: never;
+};
+/**
+ * The `ListTypeDefID` scalar type represents an identifier for an object of type ListTypeDef.
+ */
+export type ListTypeDefID = string & {
+    __ListTypeDefID: never;
+};
+export type ModuleWithSourceOpts = {
+    /**
+     * An optional subpath of the directory which contains the module's source code.
+     *
+     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
+     *
+     * If not set, the module source code is loaded from the root of the directory.
+     */
+    subpath?: string;
+};
+/**
+ * The `ModuleConfigID` scalar type represents an identifier for an object of type ModuleConfig.
+ */
+export type ModuleConfigID = string & {
+    __ModuleConfigID: never;
+};
+/**
+ * The `ModuleID` scalar type represents an identifier for an object of type Module.
  */
 export type ModuleID = string & {
     __ModuleID: never;
@@ -606,15 +633,15 @@ export type ModuleID = string & {
  * Transport layer network protocol associated to a port.
  */
 export declare enum NetworkProtocol {
-    /**
-     * TCP (Transmission Control Protocol)
-     */
     Tcp = "TCP",
-    /**
-     * UDP (User Datagram Protocol)
-     */
     Udp = "UDP"
 }
+/**
+ * The `ObjectTypeDefID` scalar type represents an identifier for an object of type ObjectTypeDef.
+ */
+export type ObjectTypeDefID = string & {
+    __ObjectTypeDefID: never;
+};
 export type PipelineLabel = {
     /**
      * Label name.
@@ -643,15 +670,30 @@ export type PortForward = {
      */
     frontend?: number;
     /**
-     * Protocol to use for traffic.
+     * Transport layer protocol to use for traffic.
      */
     protocol?: NetworkProtocol;
 };
+/**
+ * The `PortID` scalar type represents an identifier for an object of type Port.
+ */
+export type PortID = string & {
+    __PortID: never;
+};
 export type ClientContainerOpts = {
+    /**
+     * DEPRECATED: Use `loadContainerFromID` instead.
+     */
     id?: ContainerID;
+    /**
+     * Platform to initialize the container with.
+     */
     platform?: Platform;
 };
 export type ClientDirectoryOpts = {
+    /**
+     * DEPRECATED: Use `loadDirectoryFromID` isntead.
+     */
     id?: DirectoryID;
 };
 export type ClientGitOpts = {
@@ -659,6 +701,10 @@ export type ClientGitOpts = {
      * Set to true to keep .git directory.
      */
     keepGitDir?: boolean;
+    /**
+     * A service which must be started before the repo is fetched.
+     */
+    experimentalServiceHost?: Service;
     /**
      * Set SSH known hosts
      */
@@ -667,10 +713,6 @@ export type ClientGitOpts = {
      * Set SSH auth socket
      */
     sshAuthSocket?: Socket;
-    /**
-     * A service which must be started before the repo is fetched.
-     */
-    experimentalServiceHost?: Service;
 };
 export type ClientHttpOpts = {
     /**
@@ -683,19 +725,16 @@ export type ClientModuleConfigOpts = {
 };
 export type ClientPipelineOpts = {
     /**
-     * Pipeline description.
+     * Description of the sub-pipeline.
      */
     description?: string;
     /**
-     * Pipeline labels.
+     * Labels to apply to the sub-pipeline.
      */
     labels?: PipelineLabel[];
 };
-export type ClientSocketOpts = {
-    id?: SocketID;
-};
 /**
- * A unique identifier for a secret.
+ * The `SecretID` scalar type represents an identifier for an object of type Secret.
  */
 export type SecretID = string & {
     __SecretID: never;
@@ -711,13 +750,13 @@ export type ServiceEndpointOpts = {
     scheme?: string;
 };
 /**
- * A unique service identifier.
+ * The `ServiceID` scalar type represents an identifier for an object of type Service.
  */
 export type ServiceID = string & {
     __ServiceID: never;
 };
 /**
- * A content-addressed socket identifier.
+ * The `SocketID` scalar type represents an identifier for an object of type Socket.
  */
 export type SocketID = string & {
     __SocketID: never;
@@ -735,7 +774,7 @@ export type TypeDefWithObjectOpts = {
     description?: string;
 };
 /**
- * A reference to a TypeDef.
+ * The `TypeDefID` scalar type represents an identifier for an object of type TypeDef.
  */
 export type TypeDefID = string & {
     __TypeDefID: never;
@@ -745,46 +784,44 @@ export type TypeDefID = string & {
  */
 export declare enum TypeDefKind {
     /**
-     * A boolean value
+     * A boolean value.
      */
-    Booleankind = "BooleanKind",
+    BooleanKind = "BOOLEAN_KIND",
     /**
-     * An integer value
+     * An integer value.
      */
-    Integerkind = "IntegerKind",
+    IntegerKind = "INTEGER_KIND",
     /**
      * A named type of functions that can be matched+implemented by other objects+interfaces.
      *
      * Always paired with an InterfaceTypeDef.
      */
-    Interfacekind = "InterfaceKind",
+    InterfaceKind = "INTERFACE_KIND",
     /**
      * A list of values all having the same type.
      *
      * Always paired with a ListTypeDef.
      */
-    Listkind = "ListKind",
+    ListKind = "LIST_KIND",
     /**
      * A named type defined in the GraphQL schema, with fields and functions.
      *
      * Always paired with an ObjectTypeDef.
      */
-    Objectkind = "ObjectKind",
+    ObjectKind = "OBJECT_KIND",
     /**
-     * A string value
+     * A string value.
      */
-    Stringkind = "StringKind",
+    StringKind = "STRING_KIND",
     /**
      * A special kind used to signify that no value is returned.
      *
-     * This is used for functions that have no return value. The outer TypeDef
-     * specifying this Kind is always Optional, as the Void is never actually
-     * represented.
+     * This is used for functions that have no return value. The outer TypeDef specifying this Kind is always Optional, as the Void is never actually represented.
      */
-    Voidkind = "VoidKind"
+    VoidKind = "VOID_KIND"
 }
 /**
- * The absense of a value.
+ * The absence of a value.
  *
  * A Null Void is used as a placeholder for resolvers that do not return anything.
  */
@@ -809,10 +846,13 @@ export declare class CacheVolume extends BaseClient {
         queryTree?: QueryTree[];
         ctx: Context;
     }, _id?: CacheVolumeID);
+    /**
+     * A unique identifier for this CacheVolume.
+     */
     id: () => Promise<CacheVolumeID>;
 }
 /**
- * An OCI-compatible container, also known as a docker container.
+ * An OCI-compatible container, also known as a Docker container.
  */
 export declare class Container extends BaseClient {
     private readonly _id?;
@@ -836,7 +876,7 @@ export declare class Container extends BaseClient {
         ctx: Context;
     }, _id?: ContainerID, _envVariable?: string, _export?: boolean, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _shellEndpoint?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
     /**
-     * A unique identifier for this container.
+     * A unique identifier for this Container.
      */
     id: () => Promise<ContainerID>;
     /**
@@ -848,32 +888,27 @@ export declare class Container extends BaseClient {
     /**
      * Returns a File representing the container serialized to a tarball.
      * @param opts.platformVariants Identifiers for other platform specific containers.
-     * Used for multi-platform image.
+     *
+     * Used for multi-platform images.
      * @param opts.forcedCompression Force each layer of the image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
-     * @param opts.mediaTypes Use the specified media types for the image's layers. Defaults to OCI, which
-     * is largely compatible with most recent container runtimes, but Docker may be needed
-     * for older runtimes without OCI support.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent container runtimes, but Docker may be needed for older runtimes without OCI support.
      */
     asTarball: (opts?: ContainerAsTarballOpts) => File;
     /**
      * Initializes this container from a Dockerfile build.
      * @param context Directory context used by the Dockerfile.
      * @param opts.dockerfile Path to the Dockerfile to use.
-     *
-     * Default: './Dockerfile'.
-     * @param opts.buildArgs Additional build arguments.
      * @param opts.target Target build stage to build.
+     * @param opts.buildArgs Additional build arguments.
      * @param opts.secrets Secrets to pass to the build.
      *
      * They will be mounted at /run/secrets/[secret-name] in the build container
      *
-     * They can be accessed in the Dockerfile using the "secret" mount type
-     * and mount path /run/secrets/[secret-name]
-     * e.g. RUN --mount=type=secret,id=my-secret curl url?token=$(cat /run/secrets/my-secret)"
+     * They can be accessed in the Dockerfile using the "secret" mount type and mount path /run/secrets/[secret-name], e.g. RUN --mount=type=secret,id=my-secret curl http://example.com?token=$(cat /run/secrets/my-secret)
      */
     build: (context: Directory, opts?: ContainerBuildOpts) => Container;
     /**
@@ -903,41 +938,44 @@ export declare class Container extends BaseClient {
     /**
      * EXPERIMENTAL API! Subject to change/removal at any time.
      *
-     * experimentalWithAllGPUs configures all available GPUs on the host to be accessible to this container.
+     * Configures all available GPUs on the host to be accessible to this container.
+     *
      * This currently works for Nvidia devices only.
      */
     experimentalWithAllGPUs: () => Container;
     /**
      * EXPERIMENTAL API! Subject to change/removal at any time.
      *
-     * experimentalWithGPU configures the provided list of devices to be accesible to this container.
+     * Configures the provided list of devices to be accesible to this container.
+     *
      * This currently works for Nvidia devices only.
+     * @param devices List of devices to be accessible to this container.
      */
     experimentalWithGPU: (devices: string[]) => Container;
     /**
-     * Writes the container as an OCI tarball to the destination file path on the host for the specified platform variants.
+     * Writes the container as an OCI tarball to the destination file path on the host.
      *
      * Return true on success.
-     * It can also publishes platform variants.
+     *
+     * It can also export platform variants.
      * @param path Host's destination path (e.g., "./tarball").
+     *
      * Path can be relative to the engine's workdir or absolute.
      * @param opts.platformVariants Identifiers for other platform specific containers.
+     *
      * Used for multi-platform image.
      * @param opts.forcedCompression Force each layer of the exported image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
-     * @param opts.mediaTypes Use the specified media types for the exported image's layers. Defaults to OCI, which
-     * is largely compatible with most recent container runtimes, but Docker may be needed
-     * for older runtimes without OCI support.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the exported image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent container runtimes, but Docker may be needed for older runtimes without OCI support.
      */
     export: (path: string, opts?: ContainerExportOpts) => Promise<boolean>;
     /**
      * Retrieves the list of exposed ports.
      *
-     * This includes ports already exposed by the image, even if not
-     * explicitly added with dagger.
+     * This includes ports already exposed by the image, even if not explicitly added with dagger.
      */
     exposedPorts: () => Promise<Port[]>;
     /**
@@ -960,16 +998,13 @@ export declare class Container extends BaseClient {
     imageRef: () => Promise<string>;
     /**
      * Reads the container from an OCI tarball.
-     *
-     * NOTE: this involves unpacking the tarball to an OCI store on the host at
-     * $XDG_CACHE_DIR/dagger/oci. This directory can be removed whenever you like.
      * @param source File to read the container from.
-     * @param opts.tag Identifies the tag to import from the archive, if the archive bundles
-     * multiple tags.
+     * @param opts.tag Identifies the tag to import from the archive, if the archive bundles multiple tags.
      */
     import_: (source: File, opts?: ContainerImportOpts) => Container;
     /**
      * Retrieves the value of the specified label.
+     * @param name The name of the label (e.g., "org.opencontainers.artifact.created").
      */
     label: (name: string) => Promise<string>;
     /**
@@ -981,10 +1016,10 @@ export declare class Container extends BaseClient {
      */
     mounts: () => Promise<string[]>;
     /**
-     * Creates a named sub-pipeline
-     * @param name Pipeline name.
-     * @param opts.description Pipeline description.
-     * @param opts.labels Pipeline labels.
+     * Creates a named sub-pipeline.
+     * @param name Name of the sub-pipeline.
+     * @param opts.description Description of the sub-pipeline.
+     * @param opts.labels Labels to apply to the sub-pipeline.
      */
     pipeline: (name: string, opts?: ContainerPipelineOpts) => Container;
     /**
@@ -995,20 +1030,20 @@ export declare class Container extends BaseClient {
      * Publishes this container as a new image to the specified address.
      *
      * Publish returns a fully qualified ref.
+     *
      * It can also publish platform variants.
      * @param address Registry's address to publish the image to.
      *
      * Formatted as [host]/[user]/[repo]:[tag] (e.g. "docker.io/dagger/dagger:main").
      * @param opts.platformVariants Identifiers for other platform specific containers.
+     *
      * Used for multi-platform image.
      * @param opts.forcedCompression Force each layer of the published image to use the specified compression algorithm.
-     * If this is unset, then if a layer already has a compressed blob in the engine's
-     * cache, that will be used (this can result in a mix of compression algorithms for
-     * different layers). If this is unset and a layer has no compressed blob in the
-     * engine's cache, then it will be compressed using Gzip.
-     * @param opts.mediaTypes Use the specified media types for the published image's layers. Defaults to OCI, which
-     * is largely compatible with most recent registries, but Docker may be needed for older
-     * registries without OCI support.
+     *
+     * If this is unset, then if a layer already has a compressed blob in the engine's cache, that will be used (this can result in a mix of compression algorithms for different layers). If this is unset and a layer has no compressed blob in the engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the published image's layers.
+     *
+     * Defaults to OCI, which is largely compatible with most recent registries, but Docker may be needed for older registries without OCI support.
      */
     publish: (address: string, opts?: ContainerPublishOpts) => Promise<string>;
     /**
@@ -1016,8 +1051,7 @@ export declare class Container extends BaseClient {
      */
     rootfs: () => Directory;
     /**
-     * Return a websocket endpoint that, if connected to, will start the container with a TTY streamed
-     * over the websocket.
+     * Return a websocket endpoint that, if connected to, will start the container with a TTY streamed over the websocket.
      *
      * Primarily intended for internal use with the dagger CLI.
      */
@@ -1053,8 +1087,8 @@ export declare class Container extends BaseClient {
      * Retrieves this container plus a directory written at the given path.
      * @param path Location of the written directory (e.g., "/tmp/directory").
      * @param directory Identifier of the directory to write
-     * @param opts.exclude Patterns to exclude in the written directory (e.g., ["node_modules/**", ".gitignore", ".git/"]).
-     * @param opts.include Patterns to include in the written directory (e.g., ["*.go", "go.mod", "go.sum"]).
+     * @param opts.exclude Patterns to exclude in the written directory (e.g. ["node_modules/**", ".gitignore", ".git/"]).
+     * @param opts.include Patterns to include in the written directory (e.g. ["*.go", "go.mod", "go.sum"]).
      * @param opts.owner A user:group to set for the directory and its contents.
      *
      * The user and group can either be an ID (1000:1000) or a name (foo:bar).
@@ -1072,8 +1106,7 @@ export declare class Container extends BaseClient {
      * Retrieves this container plus the given environment variable.
      * @param name The name of the environment variable (e.g., "HOST").
      * @param value The value of the environment variable. (e.g., "localhost").
-     * @param opts.expand Replace `${VAR}` or $VAR in the value according to the current environment
-     * variables defined in the container (e.g., "/opt/bin:$PATH").
+     * @param opts.expand Replace `${VAR}` or `$VAR` in the value according to the current environment variables defined in the container (e.g., "/opt/bin:$PATH").
      */
     withEnvVariable: (name: string, value: string, opts?: ContainerWithEnvVariableOpts) => Container;
     /**
@@ -1087,12 +1120,8 @@ export declare class Container extends BaseClient {
      * @param opts.redirectStderr Redirect the command's standard error to a file in the container (e.g., "/tmp/stderr").
      * @param opts.experimentalPrivilegedNesting Provides dagger access to the executed command.
      *
-     * Do not use this option unless you trust the command being executed.
-     * The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
-     * @param opts.insecureRootCapabilities Execute the command with all root capabilities. This is similar to running a command
-     * with "sudo" or executing `docker run` with the `--privileged` flag. Containerization
-     * does not provide any security guarantees when using this option. It should only be used
-     * when absolutely necessary and only with trusted commands.
+     * Do not use this option unless you trust the command being executed; the command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
+     * @param opts.insecureRootCapabilities Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
      */
     withExec: (args: string[], opts?: ContainerWithExecOpts) => Container;
     /**
@@ -1101,6 +1130,7 @@ export declare class Container extends BaseClient {
      * Exposed ports serve two purposes:
      *
      * - For health checks and introspection, when running services
+     *
      * - For setting the EXPOSE OCI field when publishing the container
      * @param port Port number to expose
      * @param opts.protocol Transport layer network protocol
@@ -1112,8 +1142,6 @@ export declare class Container extends BaseClient {
      * @param path Location of the copied file (e.g., "/tmp/file.txt").
      * @param source Identifier of the file to copy.
      * @param opts.permissions Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      * @param opts.owner A user:group to set for the file.
      *
      * The user and group can either be an ID (1000:1000) or a name (foo:bar).
@@ -1122,8 +1150,7 @@ export declare class Container extends BaseClient {
      */
     withFile: (path: string, source: File, opts?: ContainerWithFileOpts) => Container;
     /**
-     * Indicate that subsequent operations should be featured more prominently in
-     * the UI.
+     * Indicate that subsequent operations should be featured more prominently in the UI.
      */
     withFocus: () => Container;
     /**
@@ -1140,9 +1167,7 @@ export declare class Container extends BaseClient {
      * @param opts.sharing Sharing mode of the cache volume.
      * @param opts.owner A user:group to set for the mounted cache directory.
      *
-     * Note that this changes the ownership of the specified mount along with the
-     * initial filesystem provided by source (if any). It does not have any effect
-     * if/when the cache has already been created.
+     * Note that this changes the ownership of the specified mount along with the initial filesystem provided by source (if any). It does not have any effect if/when the cache has already been created.
      *
      * The user and group can either be an ID (1000:1000) or a name (foo:bar).
      *
@@ -1181,9 +1206,8 @@ export declare class Container extends BaseClient {
      *
      * If the group is omitted, it defaults to the same as the user.
      * @param opts.mode Permission given to the mounted secret (e.g., 0600).
-     * This option requires an owner to be set to be active.
      *
-     * Default: 0400.
+     * This option requires an owner to be set to be active.
      */
     withMountedSecret: (path: string, source: Secret, opts?: ContainerWithMountedSecretOpts) => Container;
     /**
@@ -1196,8 +1220,6 @@ export declare class Container extends BaseClient {
      * @param path Location of the written file (e.g., "/tmp/file.txt").
      * @param opts.contents Content of the file to write (e.g., "Hello world!").
      * @param opts.permissions Permission given to the written file (e.g., 0600).
-     *
-     * Default: 0644.
      * @param opts.owner A user:group to set for the file.
      *
      * The user and group can either be an ID (1000:1000) or a name (foo:bar).
@@ -1208,13 +1230,15 @@ export declare class Container extends BaseClient {
     /**
      * Retrieves this container with a registry authentication for a given address.
      * @param address Registry's address to bind the authentication to.
+     *
      * Formatted as [host]/[user]/[repo]:[tag] (e.g. docker.io/dagger/dagger:main).
      * @param username The username of the registry's account (e.g., "Dagger").
      * @param secret The API key, password or token to authenticate to this registry.
      */
     withRegistryAuth: (address: string, username: string, secret: Secret) => Container;
     /**
-     * Initializes this container from this DirectoryID.
+     * Retrieves the container with the given directory mounted to /.
+     * @param directory Directory to mount.
      */
     withRootfs: (directory: Directory) => Container;
     /**
@@ -1226,8 +1250,7 @@ export declare class Container extends BaseClient {
     /**
      * Establish a runtime dependency on a service.
      *
-     * The service will be started automatically when needed and detached when it is
-     * no longer needed, executing the default command if none is set.
+     * The service will be started automatically when needed and detached when it is no longer needed, executing the default command if none is set.
      *
      * The service will be reachable from the container via the provided hostname alias.
      *
@@ -1278,8 +1301,7 @@ export declare class Container extends BaseClient {
      */
     withoutExposedPort: (port: number, opts?: ContainerWithoutExposedPortOpts) => Container;
     /**
-     * Indicate that subsequent operations should not be featured more prominently
-     * in the UI.
+     * Indicate that subsequent operations should not be featured more prominently in the UI.
      *
      * This is the initial state of all containers.
      */
@@ -1297,6 +1319,7 @@ export declare class Container extends BaseClient {
     /**
      * Retrieves this container without the registry authentication of a given address.
      * @param address Registry's address to remove the authentication from.
+     *
      * Formatted as [host]/[user]/[repo]:[tag] (e.g. docker.io/dagger/dagger:main).
      */
     withoutRegistryAuth: (address: string) => Container;
@@ -1343,21 +1366,16 @@ export declare class Directory extends BaseClient {
         ctx: Context;
     }, _id?: DirectoryID, _export?: boolean, _sync?: DirectoryID);
     /**
-     * The content-addressed identifier of the directory.
+     * A unique identifier for this Directory.
      */
     id: () => Promise<DirectoryID>;
     /**
      * Load the directory as a Dagger module
-     * @param opts.sourceSubpath An optional subpath of the directory which contains the module's source
-     * code.
+     * @param opts.sourceSubpath An optional subpath of the directory which contains the module's source code.
      *
-     * This is needed when the module code is in a subdirectory but requires
-     * parent directories to be loaded in order to execute. For example, the
-     * module source code may need a go.mod, project.toml, package.json, etc. file
-     * from a parent directory.
+     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
      *
-     * If not set, the module source code is loaded from the root of the
-     * directory.
+     * If not set, the module source code is loaded from the root of the directory.
      */
     asModule: (opts?: DirectoryAsModuleOpts) => Module_;
     /**
@@ -1372,12 +1390,10 @@ export declare class Directory extends BaseClient {
     directory: (path: string) => Directory;
     /**
      * Builds a new Docker container from this directory.
-     * @param opts.dockerfile Path to the Dockerfile to use (e.g., "frontend.Dockerfile").
-     *
-     * Defaults: './Dockerfile'.
      * @param opts.platform The platform to build.
-     * @param opts.buildArgs Build arguments to use in the build.
+     * @param opts.dockerfile Path to the Dockerfile to use (e.g., "frontend.Dockerfile").
      * @param opts.target Target build stage to build.
+     * @param opts.buildArgs Build arguments to use in the build.
      * @param opts.secrets Secrets to pass to the build.
      *
      * They will be mounted at /run/secrets/[secret-name].
@@ -1404,10 +1420,10 @@ export declare class Directory extends BaseClient {
      */
     glob: (pattern: string) => Promise<string[]>;
     /**
-     * Creates a named sub-pipeline
-     * @param name Pipeline name.
-     * @param opts.description Pipeline description.
-     * @param opts.labels Pipeline labels.
+     * Creates a named sub-pipeline.
+     * @param name Name of the sub-pipeline.
+     * @param opts.description Description of the sub-pipeline.
+     * @param opts.labels Labels to apply to the sub-pipeline.
      */
     pipeline: (name: string, opts?: DirectoryPipelineOpts) => Directory;
     /**
@@ -1427,16 +1443,12 @@ export declare class Directory extends BaseClient {
      * @param path Location of the copied file (e.g., "/file.txt").
      * @param source Identifier of the file to copy.
      * @param opts.permissions Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     withFile: (path: string, source: File, opts?: DirectoryWithFileOpts) => Directory;
     /**
      * Retrieves this directory plus a new directory created at the given path.
      * @param path Location of the directory created (e.g., "/logs").
      * @param opts.permissions Permission granted to the created directory (e.g., 0777).
-     *
-     * Default: 0755.
      */
     withNewDirectory: (path: string, opts?: DirectoryWithNewDirectoryOpts) => Directory;
     /**
@@ -1444,8 +1456,6 @@ export declare class Directory extends BaseClient {
      * @param path Location of the written file (e.g., "/file.txt").
      * @param contents Content of the written file (e.g., "Hello world!").
      * @param opts.permissions Permission given to the copied file (e.g., 0600).
-     *
-     * Default: 0644.
      */
     withNewFile: (path: string, contents: string, opts?: DirectoryWithNewFileOpts) => Directory;
     /**
@@ -1473,9 +1483,10 @@ export declare class Directory extends BaseClient {
     with: (arg: (param: Directory) => Directory) => Directory;
 }
 /**
- * A simple key value object that represents an environment variable.
+ * An environment variable name and value.
  */
 export declare class EnvVariable extends BaseClient {
+    private readonly _id?;
     private readonly _name?;
     private readonly _value?;
     /**
@@ -1484,22 +1495,21 @@ export declare class EnvVariable extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _name?: string, _value?: string);
+    }, _id?: EnvVariableID, _name?: string, _value?: string);
     /**
-     * The environment variable name.
+     * A unique identifier for this EnvVariable.
      */
+    id: () => Promise<EnvVariableID>;
     name: () => Promise<string>;
-    /**
-     * The environment variable value.
-     */
     value: () => Promise<string>;
 }
 /**
  * A definition of a field on a custom object defined in a Module.
- * A field on an object has a static value, as opposed to a function on an
- * object whose value is computed by invoking code (and can accept arguments).
+ *
+ * A field on an object has a static value, as opposed to a function on an object whose value is computed by invoking code (and can accept arguments).
  */
 export declare class FieldTypeDef extends BaseClient {
+    private readonly _id?;
     private readonly _description?;
     private readonly _name?;
     /**
@@ -1508,18 +1518,13 @@ export declare class FieldTypeDef extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _description?: string, _name?: string);
+    }, _id?: FieldTypeDefID, _description?: string, _name?: string);
     /**
-     * A doc string for the field, if any
+     * A unique identifier for this FieldTypeDef.
      */
+    id: () => Promise<FieldTypeDefID>;
     description: () => Promise<string>;
-    /**
-     * The name of the field in the object
-     */
     name: () => Promise<string>;
-    /**
-     * The type of the field
-     */
     typeDef: () => TypeDef;
 }
 /**
@@ -1529,6 +1534,7 @@ export declare class File extends BaseClient {
     private readonly _id?;
     private readonly _contents?;
     private readonly _export?;
+    private readonly _name?;
     private readonly _size?;
     private readonly _sync?;
     /**
@@ -1537,9 +1543,9 @@ export declare class File extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: FileID, _contents?: string, _export?: boolean, _size?: number, _sync?: FileID);
+    }, _id?: FileID, _contents?: string, _export?: boolean, _name?: string, _size?: number, _sync?: FileID);
     /**
-     * Retrieves the content-addressed identifier of the file.
+     * A unique identifier for this File.
      */
     id: () => Promise<FileID>;
     /**
@@ -1549,12 +1555,15 @@ export declare class File extends BaseClient {
     /**
      * Writes the file to a file path on the host.
      * @param path Location of the written directory (e.g., "output.txt").
-     * @param opts.allowParentDirPath If allowParentDirPath is true, the path argument can be a directory path, in which case
-     * the file will be created in that directory.
+     * @param opts.allowParentDirPath If allowParentDirPath is true, the path argument can be a directory path, in which case the file will be created in that directory.
      */
     export: (path: string, opts?: FileExportOpts) => Promise<boolean>;
     /**
-     * Gets the size of the file, in bytes.
+     * Retrieves the name of the file.
+     */
+    name: () => Promise<string>;
+    /**
+     * Retrieves the size of the file, in bytes.
      */
     size: () => Promise<number>;
     /**
@@ -1578,8 +1587,7 @@ export declare class File extends BaseClient {
 /**
  * Function represents a resolver provided by a Module.
  *
- * A function always evaluates against a parent object and is given a set of
- * named arguments.
+ * A function always evaluates against a parent object and is given a set of named arguments.
  */
 export declare class Function_ extends BaseClient {
     private readonly _id?;
@@ -1593,24 +1601,12 @@ export declare class Function_ extends BaseClient {
         ctx: Context;
     }, _id?: FunctionID, _description?: string, _name?: string);
     /**
-     * The ID of the function
+     * A unique identifier for this Function.
      */
     id: () => Promise<FunctionID>;
-    /**
-     * Arguments accepted by this function, if any
-     */
     args: () => Promise<FunctionArg[]>;
-    /**
-     * A doc string for the function, if any
-     */
     description: () => Promise<string>;
-    /**
-     * The name of the function
-     */
     name: () => Promise<string>;
-    /**
-     * The type returned by this function
-     */
     returnType: () => TypeDef;
     /**
      * Returns the function with the provided argument
@@ -1621,7 +1617,8 @@ export declare class Function_ extends BaseClient {
      */
     withArg: (name: string, typeDef: TypeDef, opts?: FunctionWithArgOpts) => Function_;
     /**
-     * Returns the function with the doc string
+     * Returns the function with the given doc string.
+     * @param description The doc string to set.
      */
     withDescription: (description: string) => Function_;
     /**
@@ -1634,8 +1631,7 @@ export declare class Function_ extends BaseClient {
 /**
  * An argument accepted by a function.
  *
- * This is a specification for an argument at function definition time, not an
- * argument passed at function call time.
+ * This is a specification for an argument at function definition time, not an argument passed at function call time.
  */
 export declare class FunctionArg extends BaseClient {
     private readonly _id?;
@@ -1650,27 +1646,19 @@ export declare class FunctionArg extends BaseClient {
         ctx: Context;
     }, _id?: FunctionArgID, _defaultValue?: JSON, _description?: string, _name?: string);
     /**
-     * The ID of the argument
+     * A unique identifier for this FunctionArg.
      */
     id: () => Promise<FunctionArgID>;
-    /**
-     * A default value to use for this argument when not explicitly set by the caller, if any
-     */
     defaultValue: () => Promise<JSON>;
-    /**
-     * A doc string for the argument, if any
-     */
     description: () => Promise<string>;
-    /**
-     * The name of the argument
-     */
     name: () => Promise<string>;
-    /**
-     * The type of the argument
-     */
     typeDef: () => TypeDef;
 }
+/**
+ * An active function call.
+ */
 export declare class FunctionCall extends BaseClient {
+    private readonly _id?;
     private readonly _name?;
     private readonly _parent?;
     private readonly _parentName?;
@@ -1681,32 +1669,26 @@ export declare class FunctionCall extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _name?: string, _parent?: JSON, _parentName?: string, _returnValue?: Void);
+    }, _id?: FunctionCallID, _name?: string, _parent?: JSON, _parentName?: string, _returnValue?: Void);
     /**
-     * The argument values the function is being invoked with.
+     * A unique identifier for this FunctionCall.
      */
+    id: () => Promise<FunctionCallID>;
     inputArgs: () => Promise<FunctionCallArgValue[]>;
-    /**
-     * The name of the function being called.
-     */
     name: () => Promise<string>;
-    /**
-     * The value of the parent object of the function being called.
-     * If the function is "top-level" to the module, this is always an empty object.
-     */
     parent: () => Promise<JSON>;
-    /**
-     * The name of the parent object of the function being called.
-     * If the function is "top-level" to the module, this is the name of the module.
-     */
     parentName: () => Promise<string>;
     /**
      * Set the return value of the function call to the provided value.
-     * The value should be a string of the JSON serialization of the return value.
+     * @param value JSON serialization of the return value.
      */
     returnValue: (value: JSON) => Promise<Void>;
 }
+/**
+ * A value passed as a named argument to a function call.
+ */
 export declare class FunctionCallArgValue extends BaseClient {
+    private readonly _id?;
     private readonly _name?;
     private readonly _value?;
     /**
@@ -1715,16 +1697,17 @@ export declare class FunctionCallArgValue extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _name?: string, _value?: JSON);
+    }, _id?: FunctionCallArgValueID, _name?: string, _value?: JSON);
     /**
-     * The name of the argument.
+     * A unique identifier for this FunctionCallArgValue.
      */
+    id: () => Promise<FunctionCallArgValueID>;
     name: () => Promise<string>;
-    /**
-     * The value of the argument represented as a string of the JSON serialization.
-     */
     value: () => Promise<JSON>;
 }
+/**
+ * The result of running an SDK's codegen.
+ */
 export declare class GeneratedCode extends BaseClient {
     private readonly _id?;
     /**
@@ -1734,25 +1717,19 @@ export declare class GeneratedCode extends BaseClient {
         queryTree?: QueryTree[];
         ctx: Context;
     }, _id?: GeneratedCodeID);
-    id: () => Promise<GeneratedCodeID>;
     /**
-     * The directory containing the generated code
+     * A unique identifier for this GeneratedCode.
      */
+    id: () => Promise<GeneratedCodeID>;
     code: () => Directory;
-    /**
-     * List of paths to mark generated in version control (i.e. .gitattributes)
-     */
     vcsGeneratedPaths: () => Promise<string[]>;
-    /**
-     * List of paths to ignore in version control (i.e. .gitignore)
-     */
     vcsIgnoredPaths: () => Promise<string[]>;
     /**
-     * Set the list of paths to mark generated in version control
+     * Set the list of paths to mark generated in version control.
      */
     withVCSGeneratedPaths: (paths: string[]) => GeneratedCode;
     /**
-     * Set the list of paths to ignore in version control
+     * Set the list of paths to ignore in version control.
      */
     withVCSIgnoredPaths: (paths: string[]) => GeneratedCode;
     /**
@@ -1763,7 +1740,7 @@ export declare class GeneratedCode extends BaseClient {
     with: (arg: (param: GeneratedCode) => GeneratedCode) => GeneratedCode;
 }
 /**
- * A git ref (tag, branch or commit).
+ * A git ref (tag, branch, or commit).
  */
 export declare class GitRef extends BaseClient {
     private readonly _id?;
@@ -1776,7 +1753,7 @@ export declare class GitRef extends BaseClient {
         ctx: Context;
     }, _id?: GitRefID, _commit?: string);
     /**
-     * Retrieves the content-addressed identifier of the git ref.
+     * A unique identifier for this GitRef.
      */
     id: () => Promise<GitRefID>;
     /**
@@ -1785,6 +1762,8 @@ export declare class GitRef extends BaseClient {
     commit: () => Promise<string>;
     /**
      * The filesystem tree at this ref.
+     * @param opts.sshKnownHosts DEPRECATED: This option should be passed to `git` instead.
+     * @param opts.sshAuthSocket DEPRECATED: This option should be passed to `git` instead.
      */
     tree: (opts?: GitRefTreeOpts) => Directory;
 }
@@ -1801,36 +1780,41 @@ export declare class GitRepository extends BaseClient {
         ctx: Context;
     }, _id?: GitRepositoryID);
     /**
-     * Retrieves the content-addressed identifier of the git repository.
+     * A unique identifier for this GitRepository.
      */
     id: () => Promise<GitRepositoryID>;
     /**
-     * Returns details on one branch.
+     * Returns details of a branch.
      * @param name Branch's name (e.g., "main").
      */
     branch: (name: string) => GitRef;
     /**
-     * Returns details on one commit.
+     * Returns details of a commit.
      * @param id Identifier of the commit (e.g., "b6315d8f2810962c601af73f86831f6866ea798b").
      */
     commit: (id: string) => GitRef;
     /**
-     * Returns details on one tag.
+     * Returns details of a tag.
      * @param name Tag's name (e.g., "v0.3.9").
      */
     tag: (name: string) => GitRef;
 }
 /**
- * Information about the host execution environment.
+ * Information about the host environment.
  */
 export declare class Host extends BaseClient {
+    private readonly _id?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    });
+    }, _id?: HostID);
+    /**
+     * A unique identifier for this Host.
+     */
+    id: () => Promise<HostID>;
     /**
      * Accesses a directory on the host.
      * @param path Location of the directory to access (e.g., ".").
@@ -1845,17 +1829,17 @@ export declare class Host extends BaseClient {
     file: (path: string) => File;
     /**
      * Creates a service that forwards traffic to a specified address via the host.
-     * @param ports Ports to expose via the service, forwarding through the host network.
+     * @param opts.host Upstream host to forward traffic to.
+     * @param opts.ports Ports to expose via the service, forwarding through the host network.
      *
-     * If a port's frontend is unspecified or 0, it defaults to the same as the
-     * backend port.
+     * If a port's frontend is unspecified or 0, it defaults to the same as the backend port.
      *
      * An empty set of ports is not valid; an error will be returned.
-     * @param opts.host Upstream host to forward traffic to.
      */
-    service: (ports: PortForward[], opts?: HostServiceOpts) => Service;
+    service: (opts?: HostServiceOpts) => Service;
     /**
      * Sets a secret given a user-defined name and the file path on the host, and returns the secret.
+     *
      * The file is limited to a size of 512000 bytes.
      * @param name The user defined name for this secret.
      * @param path Location of the file to set as a secret.
@@ -1864,20 +1848,16 @@ export declare class Host extends BaseClient {
     /**
      * Creates a tunnel that forwards traffic from the host to a service.
      * @param service Service to send traffic from the tunnel.
-     * @param opts.native Map each service port to the same port on the host, as if the service were
-     * running natively.
-     *
-     * Note: enabling may result in port conflicts.
      * @param opts.ports Configure explicit port forwarding rules for the tunnel.
      *
-     * If a port's frontend is unspecified or 0, a random port will be chosen by
-     * the host.
+     * If a port's frontend is unspecified or 0, a random port will be chosen by the host.
      *
-     * If no ports are given, all of the service's ports are forwarded. If native
-     * is true, each port maps to the same port on the host. If native is false,
-     * each port maps to a random port chosen by the host.
+     * If no ports are given, all of the service's ports are forwarded. If native is true, each port maps to the same port on the host. If native is false, each port maps to a random port chosen by the host.
      *
      * If ports are given and native is true, the ports are additive.
+     * @param opts.native Map each service port to the same port on the host, as if the service were running natively.
+     *
+     * Note: enabling may result in port conflicts.
      */
     tunnel: (service: Service, opts?: HostTunnelOpts) => Service;
     /**
@@ -1890,6 +1870,7 @@ export declare class Host extends BaseClient {
  * A definition of a custom interface defined in a Module.
  */
 export declare class InterfaceTypeDef extends BaseClient {
+    private readonly _id?;
     private readonly _description?;
     private readonly _name?;
     private readonly _sourceModuleName?;
@@ -1899,28 +1880,21 @@ export declare class InterfaceTypeDef extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _description?: string, _name?: string, _sourceModuleName?: string);
+    }, _id?: InterfaceTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
-     * The doc string for the interface, if any
+     * A unique identifier for this InterfaceTypeDef.
      */
+    id: () => Promise<InterfaceTypeDefID>;
     description: () => Promise<string>;
-    /**
-     * Functions defined on this interface, if any
-     */
     functions: () => Promise<Function_[]>;
-    /**
-     * The name of the interface
-     */
     name: () => Promise<string>;
-    /**
-     * If this InterfaceTypeDef is associated with a Module, the name of the module. Unset otherwise.
-     */
     sourceModuleName: () => Promise<string>;
 }
 /**
  * A simple key value object that represents a label.
  */
 export declare class Label extends BaseClient {
+    private readonly _id?;
     private readonly _name?;
     private readonly _value?;
     /**
@@ -1929,104 +1903,91 @@ export declare class Label extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _name?: string, _value?: string);
+    }, _id?: LabelID, _name?: string, _value?: string);
     /**
-     * The label name.
+     * A unique identifier for this Label.
      */
+    id: () => Promise<LabelID>;
     name: () => Promise<string>;
-    /**
-     * The label value.
-     */
     value: () => Promise<string>;
 }
 /**
  * A definition of a list type in a Module.
  */
 export declare class ListTypeDef extends BaseClient {
+    private readonly _id?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    });
+    }, _id?: ListTypeDefID);
     /**
-     * The type of the elements in the list
+     * A unique identifier for this ListTypeDef.
      */
+    id: () => Promise<ListTypeDefID>;
     elementTypeDef: () => TypeDef;
 }
+/**
+ * A Dagger module.
+ */
 export declare class Module_ extends BaseClient {
     private readonly _id?;
     private readonly _description?;
     private readonly _name?;
     private readonly _sdk?;
     private readonly _serve?;
-    private readonly _sourceDirectorySubPath?;
+    private readonly _sourceDirectorySubpath?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void, _sourceDirectorySubPath?: string);
+    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void, _sourceDirectorySubpath?: string);
     /**
-     * The ID of the module
+     * A unique identifier for this Module.
      */
     id: () => Promise<ModuleID>;
-    /**
-     * Modules used by this module
-     */
     dependencies: () => Promise<Module_[]>;
-    /**
-     * The dependencies as configured by the module
-     */
     dependencyConfig: () => Promise<string[]>;
-    /**
-     * The doc string of the module, if any
-     */
     description: () => Promise<string>;
-    /**
-     * The code generated by the SDK's runtime
-     */
     generatedCode: () => GeneratedCode;
     /**
-     * Interfaces served by this module
+     * Retrieves the module with the objects loaded via its SDK.
      */
+    initialize: () => Module_;
     interfaces: () => Promise<TypeDef[]>;
-    /**
-     * The name of the module
-     */
     name: () => Promise<string>;
-    /**
-     * Objects served by this module
-     */
     objects: () => Promise<TypeDef[]>;
-    /**
-     * The SDK used by this module. Either a name of a builtin SDK or a module ref pointing to the SDK's implementation.
-     */
     sdk: () => Promise<string>;
     /**
      * Serve a module's API in the current session.
-     *     Note: this can only be called once per session.
-     *     In the future, it could return a stream or service to remove the side effect.
+     *
+     * Note: this can only be called once per session. In the future, it could return a stream or service to remove the side effect.
      */
     serve: () => Promise<Void>;
-    /**
-     * The directory containing the module's source code
-     */
     sourceDirectory: () => Directory;
-    /**
-     * The module's subpath within the source directory
-     */
-    sourceDirectorySubPath: () => Promise<string>;
+    sourceDirectorySubpath: () => Promise<string>;
     /**
      * This module plus the given Interface type and associated functions
      */
     withInterface: (iface: TypeDef) => Module_;
     /**
-     * This module plus the given Object type and associated functions
+     * This module plus the given Object type and associated functions.
      */
     withObject: (object: TypeDef) => Module_;
+    /**
+     * Retrieves the module with basic configuration loaded, ready for initialization.
+     * @param directory The directory containing the module's source code.
+     * @param opts.subpath An optional subpath of the directory which contains the module's source code.
+     *
+     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
+     *
+     * If not set, the module source code is loaded from the root of the directory.
+     */
+    withSource: (directory: Directory, opts?: ModuleWithSourceOpts) => Module_;
     /**
      * Call the provided function with current Module.
      *
@@ -2038,6 +1999,7 @@ export declare class Module_ extends BaseClient {
  * Static configuration for a module (e.g. parsed contents of dagger.json)
  */
 export declare class ModuleConfig extends BaseClient {
+    private readonly _id?;
     private readonly _name?;
     private readonly _root?;
     private readonly _sdk?;
@@ -2047,36 +2009,23 @@ export declare class ModuleConfig extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _name?: string, _root?: string, _sdk?: string);
+    }, _id?: ModuleConfigID, _name?: string, _root?: string, _sdk?: string);
     /**
-     * Modules that this module depends on.
+     * A unique identifier for this ModuleConfig.
      */
+    id: () => Promise<ModuleConfigID>;
     dependencies: () => Promise<string[]>;
-    /**
-     * Exclude these file globs when loading the module root.
-     */
     exclude: () => Promise<string[]>;
-    /**
-     * Include only these file globs when loading the module root.
-     */
     include: () => Promise<string[]>;
-    /**
-     * The name of the module.
-     */
     name: () => Promise<string>;
-    /**
-     * The root directory of the module's project, which may be above the module source code.
-     */
     root: () => Promise<string>;
-    /**
-     * Either the name of a built-in SDK ('go', 'python', etc.) OR a module reference pointing to the SDK's module implementation.
-     */
     sdk: () => Promise<string>;
 }
 /**
  * A definition of a custom object defined in a Module.
  */
 export declare class ObjectTypeDef extends BaseClient {
+    private readonly _id?;
     private readonly _description?;
     private readonly _name?;
     private readonly _sourceModuleName?;
@@ -2086,36 +2035,23 @@ export declare class ObjectTypeDef extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _description?: string, _name?: string, _sourceModuleName?: string);
+    }, _id?: ObjectTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
-     * The function used to construct new instances of this object, if any
+     * A unique identifier for this ObjectTypeDef.
      */
+    id: () => Promise<ObjectTypeDefID>;
     constructor_: () => Function_;
-    /**
-     * The doc string for the object, if any
-     */
     description: () => Promise<string>;
-    /**
-     * Static fields defined on this object, if any
-     */
     fields: () => Promise<FieldTypeDef[]>;
-    /**
-     * Functions defined on this object, if any
-     */
     functions: () => Promise<Function_[]>;
-    /**
-     * The name of the object
-     */
     name: () => Promise<string>;
-    /**
-     * If this ObjectTypeDef is associated with a Module, the name of the module. Unset otherwise.
-     */
     sourceModuleName: () => Promise<string>;
 }
 /**
  * A port exposed by a container.
  */
 export declare class Port extends BaseClient {
+    private readonly _id?;
     private readonly _description?;
     private readonly _port?;
     private readonly _protocol?;
@@ -2125,20 +2061,18 @@ export declare class Port extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _description?: string, _port?: number, _protocol?: NetworkProtocol);
+    }, _id?: PortID, _description?: string, _port?: number, _protocol?: NetworkProtocol);
     /**
-     * The port description.
+     * A unique identifier for this Port.
      */
+    id: () => Promise<PortID>;
     description: () => Promise<string>;
-    /**
-     * The port number.
-     */
     port: () => Promise<number>;
-    /**
-     * The transport layer network protocol.
-     */
     protocol: () => Promise<NetworkProtocol>;
 }
+/**
+ * The root of the DAG.
+ */
 export declare class Client extends BaseClient {
     private readonly _checkVersionCompatibility?;
     private readonly _defaultPlatform?;
@@ -2149,6 +2083,14 @@ export declare class Client extends BaseClient {
         queryTree?: QueryTree[];
         ctx: Context;
     }, _checkVersionCompatibility?: boolean, _defaultPlatform?: Platform);
+    /**
+     * Retrieves a content-addressed blob.
+     * @param digest Digest of the blob
+     * @param size Size of the blob
+     * @param mediaType Media type of the blob
+     * @param uncompressed Digest of the uncompressed blob
+     */
+    blob: (digest: string, size: number, mediaType: string, uncompressed: string) => Directory;
     /**
      * Constructs a cache volume for a given cache key.
      * @param key A string identifier to target this cache volume (e.g., "modules-cache").
@@ -2156,20 +2098,21 @@ export declare class Client extends BaseClient {
     cacheVolume: (key: string) => CacheVolume;
     /**
      * Checks if the current Dagger Engine is compatible with an SDK's required version.
-     * @param version The SDK's required version.
+     * @param version Version required by the SDK.
      */
     checkVersionCompatibility: (version: string) => Promise<boolean>;
     /**
-     * Creates a scratch container or loads one by ID.
+     * Creates a scratch container.
      *
-     * Optional platform argument initializes new containers to execute and publish
-     * as that platform. Platform defaults to that of the builder's host.
+     * Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.
+     * @param opts.id DEPRECATED: Use `loadContainerFromID` instead.
+     * @param opts.platform Platform to initialize the container with.
      */
     container: (opts?: ClientContainerOpts) => Container;
     /**
      * The FunctionCall context that the SDK caller is currently executing in.
-     * If the caller is not currently executing in a function, this will return
-     * an error.
+     *
+     * If the caller is not currently executing in a function, this will return an error.
      */
     currentFunctionCall: () => FunctionCall;
     /**
@@ -2181,36 +2124,39 @@ export declare class Client extends BaseClient {
      */
     currentTypeDefs: () => Promise<TypeDef[]>;
     /**
-     * The default platform of the builder.
+     * The default platform of the engine.
      */
     defaultPlatform: () => Promise<Platform>;
     /**
-     * Creates an empty directory or loads one by ID.
+     * Creates an empty directory.
+     * @param opts.id DEPRECATED: Use `loadDirectoryFromID` isntead.
      */
     directory: (opts?: ClientDirectoryOpts) => Directory;
     /**
-     * Loads a file by ID.
      * @deprecated Use loadFileFromID instead.
      */
     file: (id: FileID) => File;
     /**
-     * Create a function.
+     * Creates a function.
+     * @param name Name of the function, in its original format from the implementation language.
+     * @param returnType Return type of the function.
      */
     function_: (name: string, returnType: TypeDef) => Function_;
     /**
-     * Create a code generation result, given a directory containing the generated
-     * code.
+     * Create a code generation result, given a directory containing the generated code.
      */
     generatedCode: (code: Directory) => GeneratedCode;
     /**
-     * Queries a git repository.
-     * @param url Url of the git repository.
-     * Can be formatted as `https://{host}/{owner}/{repo}`, `git@{host}:{owner}/{repo}`
+     * Queries a Git repository.
+     * @param url URL of the git repository.
+     *
+     * Can be formatted as `https://{host}/{owner}/{repo}`, `git@{host}:{owner}/{repo}`.
+     *
      * Suffix ".git" is optional.
      * @param opts.keepGitDir Set to true to keep .git directory.
+     * @param opts.experimentalServiceHost A service which must be started before the repo is fetched.
      * @param opts.sshKnownHosts Set SSH known hosts
      * @param opts.sshAuthSocket Set SSH auth socket
-     * @param opts.experimentalServiceHost A service which must be started before the repo is fetched.
      */
     git: (url: string, opts?: ClientGitOpts) => GitRepository;
     /**
@@ -2228,47 +2174,91 @@ export declare class Client extends BaseClient {
      */
     loadCacheVolumeFromID: (id: CacheVolumeID) => CacheVolume;
     /**
-     * Loads a container from an ID.
+     * Load a Container from its ID.
      */
     loadContainerFromID: (id: ContainerID) => Container;
     /**
      * Load a Directory from its ID.
      */
     loadDirectoryFromID: (id: DirectoryID) => Directory;
+    /**
+     * Load a EnvVariable from its ID.
+     */
+    loadEnvVariableFromID: (id: EnvVariableID) => EnvVariable;
+    /**
+     * Load a FieldTypeDef from its ID.
+     */
+    loadFieldTypeDefFromID: (id: FieldTypeDefID) => FieldTypeDef;
     /**
      * Load a File from its ID.
      */
     loadFileFromID: (id: FileID) => File;
     /**
-     * Load a function argument by ID.
+     * Load a FunctionArg from its ID.
      */
     loadFunctionArgFromID: (id: FunctionArgID) => FunctionArg;
     /**
-     * Load a function by ID.
+     * Load a FunctionCallArgValue from its ID.
+     */
+    loadFunctionCallArgValueFromID: (id: FunctionCallArgValueID) => FunctionCallArgValue;
+    /**
+     * Load a FunctionCall from its ID.
+     */
+    loadFunctionCallFromID: (id: FunctionCallID) => FunctionCall;
+    /**
+     * Load a Function from its ID.
      */
     loadFunctionFromID: (id: FunctionID) => Function_;
     /**
-     * Load a GeneratedCode by ID.
+     * Load a GeneratedCode from its ID.
      */
     loadGeneratedCodeFromID: (id: GeneratedCodeID) => GeneratedCode;
     /**
-     * Load a git ref from its ID.
+     * Load a GitRef from its ID.
      */
     loadGitRefFromID: (id: GitRefID) => GitRef;
     /**
-     * Load a git repository from its ID.
+     * Load a GitRepository from its ID.
      */
     loadGitRepositoryFromID: (id: GitRepositoryID) => GitRepository;
     /**
-     * Load a module by ID.
+     * Load a Host from its ID.
+     */
+    loadHostFromID: (id: HostID) => Host;
+    /**
+     * Load a InterfaceTypeDef from its ID.
+     */
+    loadInterfaceTypeDefFromID: (id: InterfaceTypeDefID) => InterfaceTypeDef;
+    /**
+     * Load a Label from its ID.
+     */
+    loadLabelFromID: (id: LabelID) => Label;
+    /**
+     * Load a ListTypeDef from its ID.
+     */
+    loadListTypeDefFromID: (id: ListTypeDefID) => ListTypeDef;
+    /**
+     * Load a ModuleConfig from its ID.
+     */
+    loadModuleConfigFromID: (id: ModuleConfigID) => ModuleConfig;
+    /**
+     * Load a Module from its ID.
      */
     loadModuleFromID: (id: ModuleID) => Module_;
+    /**
+     * Load a ObjectTypeDef from its ID.
+     */
+    loadObjectTypeDefFromID: (id: ObjectTypeDefID) => ObjectTypeDef;
+    /**
+     * Load a Port from its ID.
+     */
+    loadPortFromID: (id: PortID) => Port;
     /**
      * Load a Secret from its ID.
      */
     loadSecretFromID: (id: SecretID) => Secret;
     /**
-     * Loads a service from ID.
+     * Load a Service from its ID.
      */
     loadServiceFromID: (id: ServiceID) => Service;
     /**
@@ -2276,7 +2266,7 @@ export declare class Client extends BaseClient {
      */
     loadSocketFromID: (id: SocketID) => Socket;
     /**
-     * Load a TypeDef by ID.
+     * Load a TypeDef from its ID.
      */
     loadTypeDefFromID: (id: TypeDefID) => TypeDef;
     /**
@@ -2289,18 +2279,18 @@ export declare class Client extends BaseClient {
     moduleConfig: (sourceDirectory: Directory, opts?: ClientModuleConfigOpts) => ModuleConfig;
     /**
      * Creates a named sub-pipeline.
-     * @param name Pipeline name.
-     * @param opts.description Pipeline description.
-     * @param opts.labels Pipeline labels.
+     * @param name Name of the sub-pipeline.
+     * @param opts.description Description of the sub-pipeline.
+     * @param opts.labels Labels to apply to the sub-pipeline.
      */
     pipeline: (name: string, opts?: ClientPipelineOpts) => Client;
     /**
-     * Loads a secret from its ID.
-     * @deprecated Use loadSecretFromID instead
+     * Reference a secret by name.
      */
-    secret: (id: SecretID) => Secret;
+    secret: (name: string) => Secret;
     /**
      * Sets a secret given a user defined name to its plaintext and returns the secret.
+     *
      * The plaintext value is limited to a size of 128000 bytes.
      * @param name The user defined name for this secret
      * @param plaintext The plaintext of the secret
@@ -2310,7 +2300,7 @@ export declare class Client extends BaseClient {
      * Loads a socket by its ID.
      * @deprecated Use loadSocketFromID instead.
      */
-    socket: (opts?: ClientSocketOpts) => Socket;
+    socket: (id: SocketID) => Socket;
     /**
      * Create a new TypeDef.
      */
@@ -2336,7 +2326,7 @@ export declare class Secret extends BaseClient {
         ctx: Context;
     }, _id?: SecretID, _plaintext?: string);
     /**
-     * The identifier for this secret.
+     * A unique identifier for this Secret.
      */
     id: () => Promise<SecretID>;
     /**
@@ -2344,6 +2334,9 @@ export declare class Secret extends BaseClient {
      */
     plaintext: () => Promise<string>;
 }
+/**
+ * A content-addressed service providing TCP connectivity.
+ */
 export declare class Service extends BaseClient {
     private readonly _id?;
     private readonly _endpoint?;
@@ -2358,7 +2351,7 @@ export declare class Service extends BaseClient {
         ctx: Context;
     }, _id?: ServiceID, _endpoint?: string, _hostname?: string, _start?: ServiceID, _stop?: ServiceID);
     /**
-     * A unique identifier for this service.
+     * A unique identifier for this Service.
      */
     id: () => Promise<ServiceID>;
     /**
@@ -2390,6 +2383,9 @@ export declare class Service extends BaseClient {
      */
     stop: () => Promise<Service>;
 }
+/**
+ * A Unix or TCP/IP socket that can be mounted into a container.
+ */
 export declare class Socket extends BaseClient {
     private readonly _id?;
     /**
@@ -2400,7 +2396,7 @@ export declare class Socket extends BaseClient {
         ctx: Context;
     }, _id?: SocketID);
     /**
-     * The content-addressed identifier of the socket.
+     * A unique identifier for this Socket.
      */
     id: () => Promise<SocketID>;
 }
@@ -2418,29 +2414,14 @@ export declare class TypeDef extends BaseClient {
         queryTree?: QueryTree[];
         ctx: Context;
     }, _id?: TypeDefID, _kind?: TypeDefKind, _optional?: boolean);
-    id: () => Promise<TypeDefID>;
     /**
-     * If kind is INTERFACE, the interface-specific type definition.
-     * If kind is not INTERFACE, this will be null.
+     * A unique identifier for this TypeDef.
      */
+    id: () => Promise<TypeDefID>;
     asInterface: () => InterfaceTypeDef;
-    /**
-     * If kind is LIST, the list-specific type definition.
-     * If kind is not LIST, this will be null.
-     */
     asList: () => ListTypeDef;
-    /**
-     * If kind is OBJECT, the object-specific type definition.
-     * If kind is not OBJECT, this will be null.
-     */
     asObject: () => ObjectTypeDef;
-    /**
-     * The kind of type this is (e.g. primitive, list, object)
-     */
     kind: () => Promise<TypeDefKind>;
-    /**
-     * Whether this type can be set to null. Defaults to false.
-     */
     optional: () => Promise<boolean>;
     /**
      * Adds a function for constructing a new instance of an Object TypeDef, failing if the type is not an object.
@@ -2472,9 +2453,7 @@ export declare class TypeDef extends BaseClient {
     /**
      * Returns a TypeDef of kind Object with the provided name.
      *
-     * Note that an object's fields and functions may be omitted if the intent is
-     * only to refer to an object. This is how functions are able to return their
-     * own object, or any other circular reference.
+     * Note that an object's fields and functions may be omitted if the intent is only to refer to an object. This is how functions are able to return their own object, or any other circular reference.
      */
     withObject: (name: string, opts?: TypeDefWithObjectOpts) => TypeDef;
     /**