@dagger.io/dagger 0.9.6 → 0.9.7

package/dist/api/client.gen.js

@@ -27,8 +27,7 @@ class BaseClient {
 export var CacheSharingMode;
 (function (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
      */
     CacheSharingMode["Locked"] = "LOCKED";
     /**
@@ -63,13 +62,7 @@ export var ImageMediaTypes;
  */
 export var NetworkProtocol;
 (function (NetworkProtocol) {
-    /**
-     * TCP (Transmission Control Protocol)
-     */
     NetworkProtocol["Tcp"] = "TCP";
-    /**
-     * UDP (User Datagram Protocol)
-     */
     NetworkProtocol["Udp"] = "UDP";
 })(NetworkProtocol || (NetworkProtocol = {}));
 /**
@@ -78,43 +71,41 @@ export var NetworkProtocol;
 export var TypeDefKind;
 (function (TypeDefKind) {
     /**
-     * A boolean value
+     * A boolean value.
      */
-    TypeDefKind["Booleankind"] = "BooleanKind";
+    TypeDefKind["BooleanKind"] = "BOOLEAN_KIND";
     /**
-     * An integer value
+     * An integer value.
      */
-    TypeDefKind["Integerkind"] = "IntegerKind";
+    TypeDefKind["IntegerKind"] = "INTEGER_KIND";
     /**
      * A named type of functions that can be matched+implemented by other objects+interfaces.
      *
      * Always paired with an InterfaceTypeDef.
      */
-    TypeDefKind["Interfacekind"] = "InterfaceKind";
+    TypeDefKind["InterfaceKind"] = "INTERFACE_KIND";
     /**
      * A list of values all having the same type.
      *
      * Always paired with a ListTypeDef.
      */
-    TypeDefKind["Listkind"] = "ListKind";
+    TypeDefKind["ListKind"] = "LIST_KIND";
     /**
      * A named type defined in the GraphQL schema, with fields and functions.
      *
      * Always paired with an ObjectTypeDef.
      */
-    TypeDefKind["Objectkind"] = "ObjectKind";
+    TypeDefKind["ObjectKind"] = "OBJECT_KIND";
     /**
-     * A string value
+     * A string value.
      */
-    TypeDefKind["Stringkind"] = "StringKind";
+    TypeDefKind["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.
      */
-    TypeDefKind["Voidkind"] = "VoidKind";
+    TypeDefKind["VoidKind"] = "VOID_KIND";
 })(TypeDefKind || (TypeDefKind = {}));
 /**
  * A directory whose contents persist across runs.
@@ -128,6 +119,9 @@ export class CacheVolume extends BaseClient {
         super(parent);
         this._id = _id;
     }
+    /**
+     * A unique identifier for this CacheVolume.
+     */
     id = async () => {
         if (this._id) {
             return this._id;
@@ -142,7 +136,7 @@ export class CacheVolume extends BaseClient {
     };
 }
 /**
- * An OCI-compatible container, also known as a docker container.
+ * An OCI-compatible container, also known as a Docker container.
  */
 export class Container extends BaseClient {
     _id = undefined;
@@ -178,7 +172,7 @@ export class Container extends BaseClient {
         this._workdir = _workdir;
     }
     /**
-     * A unique identifier for this container.
+     * A unique identifier for this Container.
      */
     id = async () => {
         if (this._id) {
@@ -211,15 +205,14 @@ export 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) => {
         const metadata = {
@@ -241,17 +234,13 @@ export class Container extends BaseClient {
      * 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, opts) => {
         return new Container({
@@ -334,18 +323,24 @@ export class Container extends BaseClient {
                 operation: "envVariables",
             },
             {
-                operation: "name value",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new EnvVariable({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadEnvVariableFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.name, r.value));
+        }, r.id));
     };
     /**
      * 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 = () => {
@@ -362,8 +357,10 @@ export class Container extends BaseClient {
     /**
      * 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) => {
         return new Container({
@@ -378,22 +375,23 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * 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 = async (path, opts) => {
         if (this._export) {
@@ -415,8 +413,7 @@ export class Container extends BaseClient {
     /**
      * 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 = async () => {
         const response = await computeQuery([
@@ -425,13 +422,18 @@ export class Container extends BaseClient {
                 operation: "exposedPorts",
             },
             {
-                operation: "description port protocol",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new Port({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadPortFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.description, r.port, r.protocol));
+        }, r.id));
     };
     /**
      * Retrieves a file at the given path.
@@ -486,12 +488,8 @@ export class Container extends BaseClient {
     };
     /**
      * 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, opts) => {
         return new Container({
@@ -507,6 +505,7 @@ export class Container extends BaseClient {
     };
     /**
      * Retrieves the value of the specified label.
+     * @param name The name of the label (e.g., "org.opencontainers.artifact.created").
      */
     label = async (name) => {
         if (this._label) {
@@ -531,13 +530,18 @@ export class Container extends BaseClient {
                 operation: "labels",
             },
             {
-                operation: "name value",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new Label({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadLabelFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.name, r.value));
+        }, r.id));
     };
     /**
      * Retrieves the list of paths where a directory is mounted.
@@ -552,10 +556,10 @@ export class Container extends BaseClient {
         return response;
     };
     /**
-     * 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, opts) => {
         return new Container({
@@ -588,20 +592,20 @@ export 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 = async (address, opts) => {
         if (this._publish) {
@@ -635,8 +639,7 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * 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.
      */
@@ -735,8 +738,8 @@ export 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).
@@ -776,8 +779,7 @@ export 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, value, opts) => {
         return new Container({
@@ -802,12 +804,8 @@ export 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, opts) => {
         return new Container({
@@ -827,6 +825,7 @@ export 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
@@ -852,8 +851,6 @@ export 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).
@@ -873,8 +870,7 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * 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 = () => {
         return new Container({
@@ -912,9 +908,7 @@ export 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).
      *
@@ -989,9 +983,8 @@ export 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, source, opts) => {
         return new Container({
@@ -1026,8 +1019,6 @@ export 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).
@@ -1049,6 +1040,7 @@ export 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.
@@ -1066,7 +1058,8 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * Initializes this container from this DirectoryID.
+     * Retrieves the container with the given directory mounted to /.
+     * @param directory Directory to mount.
      */
     withRootfs = (directory) => {
         return new Container({
@@ -1100,8 +1093,7 @@ export 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.
      *
@@ -1242,8 +1234,7 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * 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.
      */
@@ -1293,6 +1284,7 @@ export 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) => {
@@ -1396,7 +1388,7 @@ export class Directory extends BaseClient {
         this._sync = _sync;
     }
     /**
-     * The content-addressed identifier of the directory.
+     * A unique identifier for this Directory.
      */
     id = async () => {
         if (this._id) {
@@ -1412,16 +1404,11 @@ export class Directory extends BaseClient {
     };
     /**
      * 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) => {
         return new Module_({
@@ -1469,12 +1456,10 @@ export class Directory extends BaseClient {
     };
     /**
      * 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].
@@ -1553,10 +1538,10 @@ export class Directory extends BaseClient {
         return response;
     };
     /**
-     * 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, opts) => {
         return new Directory({
@@ -1606,8 +1591,6 @@ export 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, source, opts) => {
         return new Directory({
@@ -1625,8 +1608,6 @@ export class Directory extends BaseClient {
      * 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, opts) => {
         return new Directory({
@@ -1645,8 +1626,6 @@ export 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, contents, opts) => {
         return new Directory({
@@ -1720,22 +1699,36 @@ export class Directory extends BaseClient {
     };
 }
 /**
- * A simple key value object that represents an environment variable.
+ * An environment variable name and value.
  */
 export class EnvVariable extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _value = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _name, _value) {
+    constructor(parent, _id, _name, _value) {
         super(parent);
+        this._id = _id;
         this._name = _name;
         this._value = _value;
     }
     /**
-     * The environment variable name.
+     * A unique identifier for this EnvVariable.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     name = async () => {
         if (this._name) {
             return this._name;
@@ -1748,9 +1741,6 @@ export class EnvVariable extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The environment variable value.
-     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -1766,23 +1756,37 @@ export class EnvVariable extends BaseClient {
 }
 /**
  * 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 class FieldTypeDef extends BaseClient {
+    _id = undefined;
     _description = undefined;
     _name = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _description, _name) {
+    constructor(parent, _id, _description, _name) {
         super(parent);
+        this._id = _id;
         this._description = _description;
         this._name = _name;
     }
     /**
-     * A doc string for the field, if any
+     * A unique identifier for this FieldTypeDef.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     description = async () => {
         if (this._description) {
             return this._description;
@@ -1795,9 +1799,6 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The name of the field in the object
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -1810,9 +1811,6 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The type of the field
-     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -1832,21 +1830,23 @@ export class File extends BaseClient {
     _id = undefined;
     _contents = undefined;
     _export = undefined;
+    _name = undefined;
     _size = undefined;
     _sync = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _contents, _export, _size, _sync) {
+    constructor(parent, _id, _contents, _export, _name, _size, _sync) {
         super(parent);
         this._id = _id;
         this._contents = _contents;
         this._export = _export;
+        this._name = _name;
         this._size = _size;
         this._sync = _sync;
     }
     /**
-     * Retrieves the content-addressed identifier of the file.
+     * A unique identifier for this File.
      */
     id = async () => {
         if (this._id) {
@@ -1878,8 +1878,7 @@ export 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 = async (path, opts) => {
         if (this._export) {
@@ -1895,7 +1894,22 @@ export class File extends BaseClient {
         return response;
     };
     /**
-     * Gets the size of the file, in bytes.
+     * Retrieves the name of the file.
+     */
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Retrieves the size of the file, in bytes.
      */
     size = async () => {
         if (this._size) {
@@ -1951,8 +1965,7 @@ export 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 class Function_ extends BaseClient {
     _id = undefined;
@@ -1968,7 +1981,7 @@ export class Function_ extends BaseClient {
         this._name = _name;
     }
     /**
-     * The ID of the function
+     * A unique identifier for this Function.
      */
     id = async () => {
         if (this._id) {
@@ -1982,9 +1995,6 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Arguments accepted by this function, if any
-     */
     args = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -1996,13 +2006,15 @@ export class Function_ extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new FunctionArg({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadFunctionArgFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * A doc string for the function, if any
-     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2015,9 +2027,6 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The name of the function
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2030,9 +2039,6 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The type returned by this function
-     */
     returnType = () => {
         return new TypeDef({
             queryTree: [
@@ -2064,7 +2070,8 @@ export class Function_ extends BaseClient {
         });
     };
     /**
-     * Returns the function with the doc string
+     * Returns the function with the given doc string.
+     * @param description The doc string to set.
      */
     withDescription = (description) => {
         return new Function_({
@@ -2090,8 +2097,7 @@ export 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 class FunctionArg extends BaseClient {
     _id = undefined;
@@ -2109,7 +2115,7 @@ export class FunctionArg extends BaseClient {
         this._name = _name;
     }
     /**
-     * The ID of the argument
+     * A unique identifier for this FunctionArg.
      */
     id = async () => {
         if (this._id) {
@@ -2123,9 +2129,6 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * A default value to use for this argument when not explicitly set by the caller, if any
-     */
     defaultValue = async () => {
         if (this._defaultValue) {
             return this._defaultValue;
@@ -2138,9 +2141,6 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * A doc string for the argument, if any
-     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2153,9 +2153,6 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The name of the argument
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2168,9 +2165,6 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The type of the argument
-     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2183,7 +2177,11 @@ export class FunctionArg extends BaseClient {
         });
     };
 }
+/**
+ * An active function call.
+ */
 export class FunctionCall extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _parent = undefined;
     _parentName = undefined;
@@ -2191,16 +2189,29 @@ export class FunctionCall extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _name, _parent, _parentName, _returnValue) {
+    constructor(parent, _id, _name, _parent, _parentName, _returnValue) {
         super(parent);
+        this._id = _id;
         this._name = _name;
         this._parent = _parent;
         this._parentName = _parentName;
         this._returnValue = _returnValue;
     }
     /**
-     * The argument values the function is being invoked with.
+     * A unique identifier for this FunctionCall.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     inputArgs = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2208,17 +2219,19 @@ export class FunctionCall extends BaseClient {
                 operation: "inputArgs",
             },
             {
-                operation: "name value",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new FunctionCallArgValue({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadFunctionCallArgValueFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.name, r.value));
+        }, r.id));
     };
-    /**
-     * The name of the function being called.
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2231,10 +2244,6 @@ export class FunctionCall extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * 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 = async () => {
         if (this._parent) {
             return this._parent;
@@ -2247,10 +2256,6 @@ export class FunctionCall extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * 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 = async () => {
         if (this._parentName) {
             return this._parentName;
@@ -2265,7 +2270,7 @@ export class FunctionCall extends BaseClient {
     };
     /**
      * 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 = async (value) => {
         if (this._returnValue) {
@@ -2281,20 +2286,37 @@ export class FunctionCall extends BaseClient {
         return response;
     };
 }
+/**
+ * A value passed as a named argument to a function call.
+ */
 export class FunctionCallArgValue extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _value = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _name, _value) {
+    constructor(parent, _id, _name, _value) {
         super(parent);
+        this._id = _id;
         this._name = _name;
         this._value = _value;
     }
     /**
-     * The name of the argument.
+     * A unique identifier for this FunctionCallArgValue.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2307,9 +2329,6 @@ export class FunctionCallArgValue extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The value of the argument represented as a string of the JSON serialization.
-     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -2323,6 +2342,9 @@ export class FunctionCallArgValue extends BaseClient {
         return response;
     };
 }
+/**
+ * The result of running an SDK's codegen.
+ */
 export class GeneratedCode extends BaseClient {
     _id = undefined;
     /**
@@ -2332,6 +2354,9 @@ export class GeneratedCode extends BaseClient {
         super(parent);
         this._id = _id;
     }
+    /**
+     * A unique identifier for this GeneratedCode.
+     */
     id = async () => {
         if (this._id) {
             return this._id;
@@ -2344,9 +2369,6 @@ export class GeneratedCode extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The directory containing the generated code
-     */
     code = () => {
         return new Directory({
             queryTree: [
@@ -2358,9 +2380,6 @@ export class GeneratedCode extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * List of paths to mark generated in version control (i.e. .gitattributes)
-     */
     vcsGeneratedPaths = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2370,9 +2389,6 @@ export class GeneratedCode extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * List of paths to ignore in version control (i.e. .gitignore)
-     */
     vcsIgnoredPaths = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2383,7 +2399,7 @@ export class GeneratedCode extends BaseClient {
         return response;
     };
     /**
-     * Set the list of paths to mark generated in version control
+     * Set the list of paths to mark generated in version control.
      */
     withVCSGeneratedPaths = (paths) => {
         return new GeneratedCode({
@@ -2398,7 +2414,7 @@ export class GeneratedCode extends BaseClient {
         });
     };
     /**
-     * Set the list of paths to ignore in version control
+     * Set the list of paths to ignore in version control.
      */
     withVCSIgnoredPaths = (paths) => {
         return new GeneratedCode({
@@ -2422,7 +2438,7 @@ export class GeneratedCode extends BaseClient {
     };
 }
 /**
- * A git ref (tag, branch or commit).
+ * A git ref (tag, branch, or commit).
  */
 export class GitRef extends BaseClient {
     _id = undefined;
@@ -2436,7 +2452,7 @@ export class GitRef extends BaseClient {
         this._commit = _commit;
     }
     /**
-     * Retrieves the content-addressed identifier of the git ref.
+     * A unique identifier for this GitRef.
      */
     id = async () => {
         if (this._id) {
@@ -2467,6 +2483,8 @@ export class GitRef extends BaseClient {
     };
     /**
      * 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) => {
         return new Directory({
@@ -2494,7 +2512,7 @@ export class GitRepository extends BaseClient {
         this._id = _id;
     }
     /**
-     * Retrieves the content-addressed identifier of the git repository.
+     * A unique identifier for this GitRepository.
      */
     id = async () => {
         if (this._id) {
@@ -2509,7 +2527,7 @@ export class GitRepository extends BaseClient {
         return response;
     };
     /**
-     * Returns details on one branch.
+     * Returns details of a branch.
      * @param name Branch's name (e.g., "main").
      */
     branch = (name) => {
@@ -2525,7 +2543,7 @@ export class GitRepository extends BaseClient {
         });
     };
     /**
-     * Returns details on one commit.
+     * Returns details of a commit.
      * @param id Identifier of the commit (e.g., "b6315d8f2810962c601af73f86831f6866ea798b").
      */
     commit = (id) => {
@@ -2541,7 +2559,7 @@ export class GitRepository extends BaseClient {
         });
     };
     /**
-     * Returns details on one tag.
+     * Returns details of a tag.
      * @param name Tag's name (e.g., "v0.3.9").
      */
     tag = (name) => {
@@ -2558,15 +2576,32 @@ export class GitRepository extends BaseClient {
     };
 }
 /**
- * Information about the host execution environment.
+ * Information about the host environment.
  */
 export class Host extends BaseClient {
+    _id = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent) {
+    constructor(parent, _id) {
         super(parent);
+        this._id = _id;
     }
+    /**
+     * A unique identifier for this Host.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     /**
      * Accesses a directory on the host.
      * @param path Location of the directory to access (e.g., ".").
@@ -2603,21 +2638,20 @@ export class Host extends BaseClient {
     };
     /**
      * 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, opts) => {
+    service = (opts) => {
         return new Service({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "service",
-                    args: { ports, ...opts },
+                    args: { ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -2625,6 +2659,7 @@ export class Host extends BaseClient {
     };
     /**
      * 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.
@@ -2644,20 +2679,16 @@ export 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, opts) => {
         return new Service({
@@ -2692,21 +2723,35 @@ export class Host extends BaseClient {
  * A definition of a custom interface defined in a Module.
  */
 export class InterfaceTypeDef extends BaseClient {
+    _id = undefined;
     _description = undefined;
     _name = undefined;
     _sourceModuleName = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _description, _name, _sourceModuleName) {
+    constructor(parent, _id, _description, _name, _sourceModuleName) {
         super(parent);
+        this._id = _id;
         this._description = _description;
         this._name = _name;
         this._sourceModuleName = _sourceModuleName;
     }
     /**
-     * The doc string for the interface, if any
+     * A unique identifier for this InterfaceTypeDef.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2719,9 +2764,6 @@ export class InterfaceTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Functions defined on this interface, if any
-     */
     functions = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2733,13 +2775,15 @@ export class InterfaceTypeDef extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new Function_({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadFunction_FromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * The name of the interface
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2752,9 +2796,6 @@ export class InterfaceTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * If this InterfaceTypeDef is associated with a Module, the name of the module. Unset otherwise.
-     */
     sourceModuleName = async () => {
         if (this._sourceModuleName) {
             return this._sourceModuleName;
@@ -2772,19 +2813,33 @@ export class InterfaceTypeDef extends BaseClient {
  * A simple key value object that represents a label.
  */
 export class Label extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _value = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _name, _value) {
+    constructor(parent, _id, _name, _value) {
         super(parent);
+        this._id = _id;
         this._name = _name;
         this._value = _value;
     }
     /**
-     * The label name.
+     * A unique identifier for this Label.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2797,9 +2852,6 @@ export class Label extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The label value.
-     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -2817,15 +2869,29 @@ export class Label extends BaseClient {
  * A definition of a list type in a Module.
  */
 export class ListTypeDef extends BaseClient {
+    _id = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent) {
+    constructor(parent, _id) {
         super(parent);
+        this._id = _id;
     }
     /**
-     * The type of the elements in the list
+     * A unique identifier for this ListTypeDef.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     elementTypeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2838,27 +2904,30 @@ export class ListTypeDef extends BaseClient {
         });
     };
 }
+/**
+ * A Dagger module.
+ */
 export class Module_ extends BaseClient {
     _id = undefined;
     _description = undefined;
     _name = undefined;
     _sdk = undefined;
     _serve = undefined;
-    _sourceDirectorySubPath = undefined;
+    _sourceDirectorySubpath = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _description, _name, _sdk, _serve, _sourceDirectorySubPath) {
+    constructor(parent, _id, _description, _name, _sdk, _serve, _sourceDirectorySubpath) {
         super(parent);
         this._id = _id;
         this._description = _description;
         this._name = _name;
         this._sdk = _sdk;
         this._serve = _serve;
-        this._sourceDirectorySubPath = _sourceDirectorySubPath;
+        this._sourceDirectorySubpath = _sourceDirectorySubpath;
     }
     /**
-     * The ID of the module
+     * A unique identifier for this Module.
      */
     id = async () => {
         if (this._id) {
@@ -2872,9 +2941,6 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Modules used by this module
-     */
     dependencies = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2886,13 +2952,15 @@ export class Module_ extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new Module_({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadModule_FromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * The dependencies as configured by the module
-     */
     dependencyConfig = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2902,9 +2970,6 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The doc string of the module, if any
-     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2917,9 +2982,6 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The code generated by the SDK's runtime
-     */
     generatedCode = () => {
         return new GeneratedCode({
             queryTree: [
@@ -2932,8 +2994,19 @@ export class Module_ extends BaseClient {
         });
     };
     /**
-     * Interfaces served by this module
+     * Retrieves the module with the objects loaded via its SDK.
      */
+    initialize = () => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "initialize",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     interfaces = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2945,13 +3018,15 @@ export class Module_ extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new TypeDef({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * The name of the module
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2964,9 +3039,6 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Objects served by this module
-     */
     objects = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2978,13 +3050,15 @@ export class Module_ extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new TypeDef({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * The SDK used by this module. Either a name of a builtin SDK or a module ref pointing to the SDK's implementation.
-     */
     sdk = async () => {
         if (this._sdk) {
             return this._sdk;
@@ -2999,8 +3073,8 @@ export class Module_ extends BaseClient {
     };
     /**
      * 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 = async () => {
         if (this._serve) {
@@ -3014,9 +3088,6 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The directory containing the module's source code
-     */
     sourceDirectory = () => {
         return new Directory({
             queryTree: [
@@ -3028,17 +3099,14 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * The module's subpath within the source directory
-     */
-    sourceDirectorySubPath = async () => {
-        if (this._sourceDirectorySubPath) {
-            return this._sourceDirectorySubPath;
+    sourceDirectorySubpath = async () => {
+        if (this._sourceDirectorySubpath) {
+            return this._sourceDirectorySubpath;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "sourceDirectorySubPath",
+                operation: "sourceDirectorySubpath",
             },
         ], await this._ctx.connection());
         return response;
@@ -3059,7 +3127,7 @@ export class Module_ extends BaseClient {
         });
     };
     /**
-     * This module plus the given Object type and associated functions
+     * This module plus the given Object type and associated functions.
      */
     withObject = (object) => {
         return new Module_({
@@ -3073,6 +3141,27 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * 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, opts) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSource",
+                    args: { directory, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Call the provided function with current Module.
      *
@@ -3086,21 +3175,35 @@ export class Module_ extends BaseClient {
  * Static configuration for a module (e.g. parsed contents of dagger.json)
  */
 export class ModuleConfig extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _root = undefined;
     _sdk = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _name, _root, _sdk) {
+    constructor(parent, _id, _name, _root, _sdk) {
         super(parent);
+        this._id = _id;
         this._name = _name;
         this._root = _root;
         this._sdk = _sdk;
     }
     /**
-     * Modules that this module depends on.
+     * A unique identifier for this ModuleConfig.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     dependencies = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3110,9 +3213,6 @@ export class ModuleConfig extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Exclude these file globs when loading the module root.
-     */
     exclude = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3122,9 +3222,6 @@ export class ModuleConfig extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Include only these file globs when loading the module root.
-     */
     include = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3134,9 +3231,6 @@ export class ModuleConfig extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The name of the module.
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3149,9 +3243,6 @@ export class ModuleConfig extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The root directory of the module's project, which may be above the module source code.
-     */
     root = async () => {
         if (this._root) {
             return this._root;
@@ -3164,9 +3255,6 @@ export class ModuleConfig extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Either the name of a built-in SDK ('go', 'python', etc.) OR a module reference pointing to the SDK's module implementation.
-     */
     sdk = async () => {
         if (this._sdk) {
             return this._sdk;
@@ -3184,21 +3272,35 @@ export class ModuleConfig extends BaseClient {
  * A definition of a custom object defined in a Module.
  */
 export class ObjectTypeDef extends BaseClient {
+    _id = undefined;
     _description = undefined;
     _name = undefined;
     _sourceModuleName = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _description, _name, _sourceModuleName) {
+    constructor(parent, _id, _description, _name, _sourceModuleName) {
         super(parent);
+        this._id = _id;
         this._description = _description;
         this._name = _name;
         this._sourceModuleName = _sourceModuleName;
     }
     /**
-     * The function used to construct new instances of this object, if any
+     * A unique identifier for this ObjectTypeDef.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     constructor_ = () => {
         return new Function_({
             queryTree: [
@@ -3210,9 +3312,6 @@ export class ObjectTypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * The doc string for the object, if any
-     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3225,9 +3324,6 @@ export class ObjectTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Static fields defined on this object, if any
-     */
     fields = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3235,17 +3331,19 @@ export class ObjectTypeDef extends BaseClient {
                 operation: "fields",
             },
             {
-                operation: "description name",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new FieldTypeDef({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadFieldTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.description, r.name));
+        }, r.id));
     };
-    /**
-     * Functions defined on this object, if any
-     */
     functions = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3257,13 +3355,15 @@ export class ObjectTypeDef extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new Function_({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadFunction_FromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
-    /**
-     * The name of the object
-     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3276,9 +3376,6 @@ export class ObjectTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * If this ObjectTypeDef is associated with a Module, the name of the module. Unset otherwise.
-     */
     sourceModuleName = async () => {
         if (this._sourceModuleName) {
             return this._sourceModuleName;
@@ -3296,21 +3393,35 @@ export class ObjectTypeDef extends BaseClient {
  * A port exposed by a container.
  */
 export class Port extends BaseClient {
+    _id = undefined;
     _description = undefined;
     _port = undefined;
     _protocol = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _description, _port, _protocol) {
+    constructor(parent, _id, _description, _port, _protocol) {
         super(parent);
+        this._id = _id;
         this._description = _description;
         this._port = _port;
         this._protocol = _protocol;
     }
     /**
-     * The port description.
+     * A unique identifier for this Port.
      */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3323,9 +3434,6 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The port number.
-     */
     port = async () => {
         if (this._port) {
             return this._port;
@@ -3338,9 +3446,6 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The transport layer network protocol.
-     */
     protocol = async () => {
         if (this._protocol) {
             return this._protocol;
@@ -3354,6 +3459,9 @@ export class Port extends BaseClient {
         return response;
     };
 }
+/**
+ * The root of the DAG.
+ */
 export class Client extends BaseClient {
     _checkVersionCompatibility = undefined;
     _defaultPlatform = undefined;
@@ -3365,6 +3473,25 @@ export class Client extends BaseClient {
         this._checkVersionCompatibility = _checkVersionCompatibility;
         this._defaultPlatform = _defaultPlatform;
     }
+    /**
+     * 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, size, mediaType, uncompressed) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "blob",
+                    args: { digest, size, mediaType, uncompressed },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Constructs a cache volume for a given cache key.
      * @param key A string identifier to target this cache volume (e.g., "modules-cache").
@@ -3383,7 +3510,7 @@ export class Client extends BaseClient {
     };
     /**
      * 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 = async (version) => {
         const response = await computeQuery([
@@ -3396,10 +3523,11 @@ export class Client extends BaseClient {
         return response;
     };
     /**
-     * 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) => {
         return new Container({
@@ -3415,8 +3543,8 @@ export class Client extends BaseClient {
     };
     /**
      * 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 = () => {
         return new FunctionCall({
@@ -3457,12 +3585,17 @@ export class Client extends BaseClient {
             },
         ], await this._ctx.connection());
         return response.map((r) => new TypeDef({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
         }, r.id));
     };
     /**
-     * The default platform of the builder.
+     * The default platform of the engine.
      */
     defaultPlatform = async () => {
         const response = await computeQuery([
@@ -3474,7 +3607,8 @@ export class Client extends BaseClient {
         return response;
     };
     /**
-     * Creates an empty directory or loads one by ID.
+     * Creates an empty directory.
+     * @param opts.id DEPRECATED: Use `loadDirectoryFromID` isntead.
      */
     directory = (opts) => {
         return new Directory({
@@ -3489,7 +3623,6 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a file by ID.
      * @deprecated Use loadFileFromID instead.
      */
     file = (id) => {
@@ -3505,7 +3638,9 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * 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, returnType) => {
         return new Function_({
@@ -3520,8 +3655,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * 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) => {
         return new GeneratedCode({
@@ -3536,14 +3670,16 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * 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, opts) => {
         return new GitRepository({
@@ -3604,7 +3740,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a container from an ID.
+     * Load a Container from its ID.
      */
     loadContainerFromID = (id) => {
         return new Container({
@@ -3633,6 +3769,36 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a EnvVariable from its ID.
+     */
+    loadEnvVariableFromID = (id) => {
+        return new EnvVariable({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadEnvVariableFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a FieldTypeDef from its ID.
+     */
+    loadFieldTypeDefFromID = (id) => {
+        return new FieldTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadFieldTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a File from its ID.
      */
@@ -3649,7 +3815,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a function argument by ID.
+     * Load a FunctionArg from its ID.
      */
     loadFunctionArgFromID = (id) => {
         return new FunctionArg({
@@ -3664,7 +3830,37 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a function by ID.
+     * Load a FunctionCallArgValue from its ID.
+     */
+    loadFunctionCallArgValueFromID = (id) => {
+        return new FunctionCallArgValue({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadFunctionCallArgValueFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a FunctionCall from its ID.
+     */
+    loadFunctionCallFromID = (id) => {
+        return new FunctionCall({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadFunctionCallFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Function from its ID.
      */
     loadFunctionFromID = (id) => {
         return new Function_({
@@ -3679,7 +3875,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a GeneratedCode by ID.
+     * Load a GeneratedCode from its ID.
      */
     loadGeneratedCodeFromID = (id) => {
         return new GeneratedCode({
@@ -3694,7 +3890,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a git ref from its ID.
+     * Load a GitRef from its ID.
      */
     loadGitRefFromID = (id) => {
         return new GitRef({
@@ -3709,7 +3905,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a git repository from its ID.
+     * Load a GitRepository from its ID.
      */
     loadGitRepositoryFromID = (id) => {
         return new GitRepository({
@@ -3724,7 +3920,82 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a module by ID.
+     * Load a Host from its ID.
+     */
+    loadHostFromID = (id) => {
+        return new Host({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadHostFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a InterfaceTypeDef from its ID.
+     */
+    loadInterfaceTypeDefFromID = (id) => {
+        return new InterfaceTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadInterfaceTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Label from its ID.
+     */
+    loadLabelFromID = (id) => {
+        return new Label({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadLabelFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a ListTypeDef from its ID.
+     */
+    loadListTypeDefFromID = (id) => {
+        return new ListTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadListTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a ModuleConfig from its ID.
+     */
+    loadModuleConfigFromID = (id) => {
+        return new ModuleConfig({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadModuleConfigFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Module from its ID.
      */
     loadModuleFromID = (id) => {
         return new Module_({
@@ -3738,6 +4009,36 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a ObjectTypeDef from its ID.
+     */
+    loadObjectTypeDefFromID = (id) => {
+        return new ObjectTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadObjectTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Port from its ID.
+     */
+    loadPortFromID = (id) => {
+        return new Port({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadPortFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a Secret from its ID.
      */
@@ -3754,7 +4055,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a service from ID.
+     * Load a Service from its ID.
      */
     loadServiceFromID = (id) => {
         return new Service({
@@ -3784,7 +4085,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a TypeDef by ID.
+     * Load a TypeDef from its ID.
      */
     loadTypeDefFromID = (id) => {
         return new TypeDef({
@@ -3829,9 +4130,9 @@ export class Client extends BaseClient {
     };
     /**
      * 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, opts) => {
         return new Client({
@@ -3846,16 +4147,15 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a secret from its ID.
-     * @deprecated Use loadSecretFromID instead
+     * Reference a secret by name.
      */
-    secret = (id) => {
+    secret = (name) => {
         return new Secret({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "secret",
-                    args: { id },
+                    args: { name },
                 },
             ],
             ctx: this._ctx,
@@ -3863,6 +4163,7 @@ export class Client extends BaseClient {
     };
     /**
      * 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
@@ -3883,13 +4184,13 @@ export class Client extends BaseClient {
      * Loads a socket by its ID.
      * @deprecated Use loadSocketFromID instead.
      */
-    socket = (opts) => {
+    socket = (id) => {
         return new Socket({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "socket",
-                    args: { ...opts },
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
@@ -3933,7 +4234,7 @@ export class Secret extends BaseClient {
         this._plaintext = _plaintext;
     }
     /**
-     * The identifier for this secret.
+     * A unique identifier for this Secret.
      */
     id = async () => {
         if (this._id) {
@@ -3963,6 +4264,9 @@ export class Secret extends BaseClient {
         return response;
     };
 }
+/**
+ * A content-addressed service providing TCP connectivity.
+ */
 export class Service extends BaseClient {
     _id = undefined;
     _endpoint = undefined;
@@ -3981,7 +4285,7 @@ export class Service extends BaseClient {
         this._stop = _stop;
     }
     /**
-     * A unique identifier for this service.
+     * A unique identifier for this Service.
      */
     id = async () => {
         if (this._id) {
@@ -4042,13 +4346,18 @@ export class Service extends BaseClient {
                 operation: "ports",
             },
             {
-                operation: "description port protocol",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response.map((r) => new Port({
-            queryTree: this.queryTree,
+            queryTree: [
+                {
+                    operation: "loadPortFromID",
+                    args: { id: r.id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.description, r.port, r.protocol));
+        }, r.id));
     };
     /**
      * Start the service and wait for its health checks to succeed.
@@ -4077,6 +4386,9 @@ export class Service extends BaseClient {
         return this;
     };
 }
+/**
+ * A Unix or TCP/IP socket that can be mounted into a container.
+ */
 export class Socket extends BaseClient {
     _id = undefined;
     /**
@@ -4087,7 +4399,7 @@ export class Socket extends BaseClient {
         this._id = _id;
     }
     /**
-     * The content-addressed identifier of the socket.
+     * A unique identifier for this Socket.
      */
     id = async () => {
         if (this._id) {
@@ -4118,6 +4430,9 @@ export class TypeDef extends BaseClient {
         this._kind = _kind;
         this._optional = _optional;
     }
+    /**
+     * A unique identifier for this TypeDef.
+     */
     id = async () => {
         if (this._id) {
             return this._id;
@@ -4130,10 +4445,6 @@ export class TypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * If kind is INTERFACE, the interface-specific type definition.
-     * If kind is not INTERFACE, this will be null.
-     */
     asInterface = () => {
         return new InterfaceTypeDef({
             queryTree: [
@@ -4145,10 +4456,6 @@ export class TypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * If kind is LIST, the list-specific type definition.
-     * If kind is not LIST, this will be null.
-     */
     asList = () => {
         return new ListTypeDef({
             queryTree: [
@@ -4160,10 +4467,6 @@ export class TypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * If kind is OBJECT, the object-specific type definition.
-     * If kind is not OBJECT, this will be null.
-     */
     asObject = () => {
         return new ObjectTypeDef({
             queryTree: [
@@ -4175,9 +4478,6 @@ export class TypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * The kind of type this is (e.g. primitive, list, object)
-     */
     kind = async () => {
         if (this._kind) {
             return this._kind;
@@ -4190,9 +4490,6 @@ export class TypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Whether this type can be set to null. Defaults to false.
-     */
     optional = async () => {
         if (this._optional) {
             return this._optional;
@@ -4308,9 +4605,7 @@ export 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, opts) => {
         return new TypeDef({