@dagger.io/dagger 0.9.6 → 0.9.8

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";
     /**
@@ -58,18 +57,20 @@ export var ImageMediaTypes;
     ImageMediaTypes["Dockermediatypes"] = "DockerMediaTypes";
     ImageMediaTypes["Ocimediatypes"] = "OCIMediaTypes";
 })(ImageMediaTypes || (ImageMediaTypes = {}));
+/**
+ * The kind of module source.
+ */
+export var ModuleSourceKind;
+(function (ModuleSourceKind) {
+    ModuleSourceKind["GitSource"] = "GIT_SOURCE";
+    ModuleSourceKind["LocalSource"] = "LOCAL_SOURCE";
+})(ModuleSourceKind || (ModuleSourceKind = {}));
 /**
  * Transport layer network protocol associated to a port.
  */
 export var NetworkProtocol;
 (function (NetworkProtocol) {
-    /**
-     * TCP (Transmission Control Protocol)
-     */
     NetworkProtocol["Tcp"] = "TCP";
-    /**
-     * UDP (User Datagram Protocol)
-     */
     NetworkProtocol["Udp"] = "UDP";
 })(NetworkProtocol || (NetworkProtocol = {}));
 /**
@@ -78,43 +79,45 @@ export var NetworkProtocol;
 export var TypeDefKind;
 (function (TypeDefKind) {
     /**
-     * A boolean value
+     * A boolean value.
+     */
+    TypeDefKind["BooleanKind"] = "BOOLEAN_KIND";
+    /**
+     * A graphql input type, used only when representing the core API via TypeDefs.
      */
-    TypeDefKind["Booleankind"] = "BooleanKind";
+    TypeDefKind["InputKind"] = "INPUT_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 +131,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 +148,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;
@@ -152,7 +158,6 @@ export class Container extends BaseClient {
     _label = undefined;
     _platform = undefined;
     _publish = undefined;
-    _shellEndpoint = undefined;
     _stderr = undefined;
     _stdout = undefined;
     _sync = undefined;
@@ -161,7 +166,7 @@ export class Container extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _envVariable, _export, _imageRef, _label, _platform, _publish, _shellEndpoint, _stderr, _stdout, _sync, _user, _workdir) {
+    constructor(parent, _id, _envVariable, _export, _imageRef, _label, _platform, _publish, _stderr, _stdout, _sync, _user, _workdir) {
         super(parent);
         this._id = _id;
         this._envVariable = _envVariable;
@@ -170,7 +175,6 @@ export class Container extends BaseClient {
         this._label = _label;
         this._platform = _platform;
         this._publish = _publish;
-        this._shellEndpoint = _shellEndpoint;
         this._stderr = _stderr;
         this._stdout = _stdout;
         this._sync = _sync;
@@ -178,7 +182,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 +215,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 +244,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 +333,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 +367,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 +385,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 +423,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 +432,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 +498,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 +515,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 +540,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 +566,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 +602,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,22 +649,20 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * 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.
+     * Return an interactive terminal for this container using its configured shell if not overridden by args (or sh as a fallback default).
+     * @param opts.args If set, override the container's default shell and invoke these arguments instead.
      */
-    shellEndpoint = async () => {
-        if (this._shellEndpoint) {
-            return this._shellEndpoint;
-        }
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "shellEndpoint",
-            },
-        ], await this._ctx.connection());
-        return response;
+    shell = (opts) => {
+        return new Terminal({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "shell",
+                    args: { ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * The error stream of the last executed command.
@@ -731,12 +743,28 @@ export class Container extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Set the default command to invoke for the "shell" API.
+     * @param args The args of the command to set the default shell to.
+     */
+    withDefaultShell = (args) => {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withDefaultShell",
+                    args: { args },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * 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 +804,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 +829,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,10 +850,12 @@ 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
      * @param opts.description Optional port description
+     * @param opts.experimentalSkipHealthcheck Skip the health check when run as a service.
      */
     withExposedPort = (port, opts) => {
         const metadata = {
@@ -852,8 +877,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 +896,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 +934,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 +1009,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 +1045,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 +1066,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 +1084,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 +1119,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 +1260,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 +1310,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) => {
@@ -1379,6 +1397,99 @@ export class Container extends BaseClient {
         return arg(this);
     };
 }
+/**
+ * Reflective module API provided to functions at runtime.
+ */
+export class CurrentModule extends BaseClient {
+    _id = undefined;
+    _name = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _name) {
+        super(parent);
+        this._id = _id;
+        this._name = _name;
+    }
+    /**
+     * A unique identifier for this CurrentModule.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The name of the module being executed in
+     */
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The directory containing the module's source code loaded into the engine (plus any generated code that may have been created).
+     */
+    source = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "source",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a directory from the module's scratch working directory, including any changes that may have been made to it during module function execution.
+     * @param path Location of the directory to access (e.g., ".").
+     * @param opts.exclude Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
+     * @param opts.include Include only artifacts that match the given pattern (e.g., ["app/", "package.*"]).
+     */
+    workdir = (path, opts) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "workdir",
+                    args: { path, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a file from the module's scratch working directory, including any changes that may have been made to it during module function execution.Load a file from the module's scratch working directory, including any changes that may have been made to it during module function execution.
+     * @param path Location of the file to retrieve (e.g., "README.md").
+     */
+    workdirFile = (path) => {
+        return new File({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "workdirFile",
+                    args: { path },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+}
 /**
  * A directory.
  */
@@ -1396,7 +1507,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 +1523,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 +1575,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 +1657,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 +1710,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 +1727,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 +1745,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 +1818,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 +1860,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 +1875,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 +1918,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 +1930,6 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The type of the field
-     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -1832,21 +1949,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 +1997,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 +2013,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 +2084,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 +2100,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 +2114,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 +2125,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 +2146,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 +2158,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 +2189,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 +2216,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 +2234,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 +2248,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 +2260,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 +2272,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 +2284,6 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The type of the argument
-     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2183,7 +2296,11 @@ export class FunctionArg extends BaseClient {
         });
     };
 }
+/**
+ * An active function call.
+ */
 export class FunctionCall extends BaseClient {
+    _id = undefined;
     _name = undefined;
     _parent = undefined;
     _parentName = undefined;
@@ -2191,34 +2308,49 @@ 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.
      */
-    inputArgs = async () => {
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "inputArgs",
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    inputArgs = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                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 +2363,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 +2375,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 +2389,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 +2405,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 +2448,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 +2461,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 +2473,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 +2488,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 +2499,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 +2508,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 +2518,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 +2533,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 +2557,111 @@ export class GeneratedCode extends BaseClient {
     };
 }
 /**
- * A git ref (tag, branch or commit).
+ * Module source originating from a git repo.
+ */
+export class GitModuleSource extends BaseClient {
+    _id = undefined;
+    _cloneURL = undefined;
+    _commit = undefined;
+    _htmlURL = undefined;
+    _sourceSubpath = undefined;
+    _version = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _cloneURL, _commit, _htmlURL, _sourceSubpath, _version) {
+        super(parent);
+        this._id = _id;
+        this._cloneURL = _cloneURL;
+        this._commit = _commit;
+        this._htmlURL = _htmlURL;
+        this._sourceSubpath = _sourceSubpath;
+        this._version = _version;
+    }
+    /**
+     * A unique identifier for this GitModuleSource.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The URL from which the source's git repo can be cloned.
+     */
+    cloneURL = async () => {
+        if (this._cloneURL) {
+            return this._cloneURL;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "cloneURL",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    commit = async () => {
+        if (this._commit) {
+            return this._commit;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "commit",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The URL to the source's git repo in a web browser
+     */
+    htmlURL = async () => {
+        if (this._htmlURL) {
+            return this._htmlURL;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "htmlURL",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    sourceSubpath = async () => {
+        if (this._sourceSubpath) {
+            return this._sourceSubpath;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "sourceSubpath",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    version = async () => {
+        if (this._version) {
+            return this._version;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "version",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
+/**
+ * A git ref (tag, branch, or commit).
  */
 export class GitRef extends BaseClient {
     _id = undefined;
@@ -2436,7 +2675,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 +2706,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 +2735,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 +2750,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 +2766,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 +2782,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 +2799,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 +2861,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 +2882,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 +2902,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({
@@ -2688,25 +2942,104 @@ export class Host extends BaseClient {
         });
     };
 }
+/**
+ * A graphql input type, which is essentially just a group of named args.
+ * This is currently only used to represent pre-existing usage of graphql input types
+ * in the core API. It is not used by user modules and shouldn't ever be as user
+ * module accept input objects via their id rather than graphql input types.
+ */
+export class InputTypeDef extends BaseClient {
+    _id = undefined;
+    _name = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _name) {
+        super(parent);
+        this._id = _id;
+        this._name = _name;
+    }
+    /**
+     * A unique identifier for this InputTypeDef.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    fields = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "fields",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new FieldTypeDef({
+            queryTree: [
+                {
+                    operation: "loadFieldTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * 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 +3052,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 +3063,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 +3084,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 +3101,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 +3140,6 @@ export class Label extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The label value.
-     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -2817,48 +3157,105 @@ 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.
      */
-    elementTypeDef = () => {
-        return new TypeDef({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "elementTypeDef",
-                },
-            ],
-            ctx: this._ctx,
+    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: [
+                ...this._queryTree,
+                {
+                    operation: "elementTypeDef",
+                },
+            ],
+            ctx: this._ctx,
         });
     };
 }
+/**
+ * Module source that that originates from a path locally relative to an arbitrary directory.
+ */
+export class LocalModuleSource extends BaseClient {
+    _id = undefined;
+    _sourceSubpath = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _sourceSubpath) {
+        super(parent);
+        this._id = _id;
+        this._sourceSubpath = _sourceSubpath;
+    }
+    /**
+     * A unique identifier for this LocalModuleSource.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    sourceSubpath = async () => {
+        if (this._sourceSubpath) {
+            return this._sourceSubpath;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "sourceSubpath",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
+/**
+ * A Dagger module.
+ */
 export class Module_ extends BaseClient {
     _id = undefined;
     _description = undefined;
     _name = undefined;
     _sdk = undefined;
     _serve = 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) {
         super(parent);
         this._id = _id;
         this._description = _description;
         this._name = _name;
         this._sdk = _sdk;
         this._serve = _serve;
-        this._sourceDirectorySubPath = _sourceDirectorySubPath;
     }
     /**
-     * The ID of the module
+     * A unique identifier for this Module.
      */
     id = async () => {
         if (this._id) {
@@ -2872,9 +3269,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,25 +3280,35 @@ 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,
             {
                 operation: "dependencyConfig",
             },
+            {
+                operation: "id",
+            },
         ], await this._ctx.connection());
-        return response;
+        return response.map((r) => new ModuleDependency({
+            queryTree: [
+                {
+                    operation: "loadModuleDependencyFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
     };
-    /**
-     * The doc string of the module, if any
-     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2918,22 +3322,33 @@ export class Module_ extends BaseClient {
         return response;
     };
     /**
-     * The code generated by the SDK's runtime
+     * The module's root directory containing the config file for it and its source (possibly as a subdir). It includes any generated code or updated config files created after initial load, but not any files/directories that were unchanged after sdk codegen was run.
      */
-    generatedCode = () => {
-        return new GeneratedCode({
+    generatedSourceRootDirectory = () => {
+        return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "generatedCode",
+                    operation: "generatedSourceRootDirectory",
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * 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 +3360,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 +3381,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 +3392,26 @@ 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.
-     */
+    runtime = () => {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "runtime",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     sdk = async () => {
         if (this._sdk) {
             return this._sdk;
@@ -2999,8 +3426,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,34 +3441,48 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    source = () => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "source",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
-     * The directory containing the module's source code
+     * Update the module configuration to use the given dependencies.
+     * @param dependencies The dependency modules to install.
      */
-    sourceDirectory = () => {
-        return new Directory({
+    withDependencies = (dependencies) => {
+        return new Module_({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "sourceDirectory",
+                    operation: "withDependencies",
+                    args: { dependencies },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * The module's subpath within the source directory
+     * Retrieves the module with the given description
+     * @param description The description to set
      */
-    sourceDirectorySubPath = async () => {
-        if (this._sourceDirectorySubPath) {
-            return this._sourceDirectorySubPath;
-        }
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "sourceDirectorySubPath",
-            },
-        ], await this._ctx.connection());
-        return response;
+    withDescription = (description) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withDescription",
+                    args: { description },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * This module plus the given Interface type and associated functions
@@ -3059,7 +3500,23 @@ export class Module_ extends BaseClient {
         });
     };
     /**
-     * This module plus the given Object type and associated functions
+     * Update the module configuration to use the given name.
+     * @param name The name to use.
+     */
+    withName = (name) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withName",
+                    args: { name },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * This module plus the given Object type and associated functions.
      */
     withObject = (object) => {
         return new Module_({
@@ -3073,6 +3530,38 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Update the module configuration to use the given SDK.
+     * @param sdk The SDK to use.
+     */
+    withSDK = (sdk) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSDK",
+                    args: { sdk },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Retrieves the module with basic configuration loaded if present.
+     * @param source The module source to initialize from.
+     */
+    withSource = (source) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSource",
+                    args: { source },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Call the provided function with current Module.
      *
@@ -3083,122 +3572,271 @@ export class Module_ extends BaseClient {
     };
 }
 /**
- * Static configuration for a module (e.g. parsed contents of dagger.json)
+ * The configuration of dependency of a module.
  */
-export class ModuleConfig extends BaseClient {
+export class ModuleDependency 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) {
         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 ModuleDependency.
      */
-    dependencies = async () => {
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "dependencies",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * Exclude these file globs when loading the module root.
-     */
-    exclude = async () => {
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "exclude",
+                operation: "name",
             },
         ], await this._ctx.connection());
         return response;
     };
+    source = () => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "source",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+}
+/**
+ * The source needed to load and run a module, along with any metadata about the source such as versions/urls/etc.
+ */
+export class ModuleSource extends BaseClient {
+    _id = undefined;
+    _asString = undefined;
+    _kind = undefined;
+    _moduleName = undefined;
+    _subpath = undefined;
     /**
-     * Include only these file globs when loading the module root.
+     * Constructor is used for internal usage only, do not create object from it.
      */
-    include = async () => {
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "include",
-            },
-        ], await this._ctx.connection());
-        return response;
-    };
+    constructor(parent, _id, _asString, _kind, _moduleName, _subpath) {
+        super(parent);
+        this._id = _id;
+        this._asString = _asString;
+        this._kind = _kind;
+        this._moduleName = _moduleName;
+        this._subpath = _subpath;
+    }
     /**
-     * The name of the module.
+     * A unique identifier for this ModuleSource.
      */
-    name = async () => {
-        if (this._name) {
-            return this._name;
+    id = async () => {
+        if (this._id) {
+            return this._id;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "name",
+                operation: "id",
             },
         ], await this._ctx.connection());
         return response;
     };
+    asGitSource = () => {
+        return new GitModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "asGitSource",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    asLocalSource = () => {
+        return new LocalModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "asLocalSource",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load the source as a module. If this is a local source, the parent directory must have been provided during module source creation
+     */
+    asModule = () => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "asModule",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
-     * The root directory of the module's project, which may be above the module source code.
+     * A human readable ref string representation of this module source.
      */
-    root = async () => {
-        if (this._root) {
-            return this._root;
+    asString = async () => {
+        if (this._asString) {
+            return this._asString;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "root",
+                operation: "asString",
             },
         ], 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.
+     * The directory containing the actual module's source code, as determined from the root directory and subpath.
+     * @param path The path from the source directory to select.
      */
-    sdk = async () => {
-        if (this._sdk) {
-            return this._sdk;
+    directory = (path) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "directory",
+                    args: { path },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    kind = async () => {
+        if (this._kind) {
+            return this._kind;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "sdk",
+                operation: "kind",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * If set, the name of the module this source references
+     */
+    moduleName = async () => {
+        if (this._moduleName) {
+            return this._moduleName;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "moduleName",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Resolve the provided module source arg as a dependency relative to this module source.
+     * @param dep The dependency module source to resolve.
+     */
+    resolveDependency = (dep) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "resolveDependency",
+                    args: { dep },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    rootDirectory = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "rootDirectory",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The path to the module subdirectory containing the actual module's source code.
+     */
+    subpath = async () => {
+        if (this._subpath) {
+            return this._subpath;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "subpath",
             },
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Call the provided function with current ModuleSource.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with = (arg) => {
+        return arg(this);
+    };
 }
 /**
  * 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 +3848,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 +3860,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 +3867,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 +3891,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 +3912,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 +3929,37 @@ export class ObjectTypeDef extends BaseClient {
  * A port exposed by a container.
  */
 export class Port extends BaseClient {
+    _id = undefined;
     _description = undefined;
+    _experimentalSkipHealthcheck = 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, _experimentalSkipHealthcheck, _port, _protocol) {
         super(parent);
+        this._id = _id;
         this._description = _description;
+        this._experimentalSkipHealthcheck = _experimentalSkipHealthcheck;
         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 +3972,18 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    /**
-     * The port number.
-     */
+    experimentalSkipHealthcheck = async () => {
+        if (this._experimentalSkipHealthcheck) {
+            return this._experimentalSkipHealthcheck;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "experimentalSkipHealthcheck",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     port = async () => {
         if (this._port) {
             return this._port;
@@ -3338,9 +3996,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 +4009,9 @@ export class Port extends BaseClient {
         return response;
     };
 }
+/**
+ * The root of the DAG.
+ */
 export class Client extends BaseClient {
     _checkVersionCompatibility = undefined;
     _defaultPlatform = undefined;
@@ -3365,6 +4023,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 +4060,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,108 +4073,366 @@ 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.
+     * @param opts.id DEPRECATED: Use `loadContainerFromID` instead.
+     * @param opts.platform Platform to initialize the container with.
+     */
+    container = (opts) => {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "container",
+                    args: { ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * 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.
+     */
+    currentFunctionCall = () => {
+        return new FunctionCall({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "currentFunctionCall",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The module currently being served in the session, if any.
+     */
+    currentModule = () => {
+        return new CurrentModule({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "currentModule",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The TypeDef representations of the objects currently being served in the session.
+     */
+    currentTypeDefs = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "currentTypeDefs",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new TypeDef({
+            queryTree: [
+                {
+                    operation: "loadTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
+    /**
+     * The default platform of the engine.
+     */
+    defaultPlatform = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "defaultPlatform",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Creates an empty directory.
+     * @param opts.id DEPRECATED: Use `loadDirectoryFromID` isntead.
+     */
+    directory = (opts) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "directory",
+                    args: { ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * @deprecated Use loadFileFromID instead.
+     */
+    file = (id) => {
+        return new File({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "file",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * 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_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "function",
+                    args: { name, returnType },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Create a code generation result, given a directory containing the generated code.
+     */
+    generatedCode = (code) => {
+        return new GeneratedCode({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "generatedCode",
+                    args: { code },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Queries a Git repository.
+     * @param url URL of the git repository.
+     *
+     * Can be formatted as `https://{host}/{owner}/{repo}`, `git@{host}:{owner}/{repo}`.
      *
-     * Optional platform argument initializes new containers to execute and publish
-     * as that platform. Platform defaults to that of the builder's host.
+     * 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
+     */
+    git = (url, opts) => {
+        return new GitRepository({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "git",
+                    args: { url, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Queries the host environment.
+     */
+    host = () => {
+        return new Host({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "host",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Returns a file containing an http remote url content.
+     * @param url HTTP url to get the content from (e.g., "https://docs.dagger.io").
+     * @param opts.experimentalServiceHost A service which must be started before the URL is fetched.
+     */
+    http = (url, opts) => {
+        return new File({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "http",
+                    args: { url, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a CacheVolume from its ID.
+     */
+    loadCacheVolumeFromID = (id) => {
+        return new CacheVolume({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadCacheVolumeFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Container from its ID.
+     */
+    loadContainerFromID = (id) => {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadContainerFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a CurrentModule from its ID.
+     */
+    loadCurrentModuleFromID = (id) => {
+        return new CurrentModule({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadCurrentModuleFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a Directory from its ID.
+     */
+    loadDirectoryFromID = (id) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadDirectoryFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a EnvVariable from its ID.
      */
-    container = (opts) => {
-        return new Container({
+    loadEnvVariableFromID = (id) => {
+        return new EnvVariable({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "container",
-                    args: { ...opts },
+                    operation: "loadEnvVariableFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * 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.
+     * Load a FieldTypeDef from its ID.
      */
-    currentFunctionCall = () => {
-        return new FunctionCall({
+    loadFieldTypeDefFromID = (id) => {
+        return new FieldTypeDef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "currentFunctionCall",
+                    operation: "loadFieldTypeDefFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * The module currently being served in the session, if any.
+     * Load a File from its ID.
      */
-    currentModule = () => {
-        return new Module_({
+    loadFileFromID = (id) => {
+        return new File({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "currentModule",
+                    operation: "loadFileFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * The TypeDef representations of the objects currently being served in the session.
+     * Load a FunctionArg from its ID.
      */
-    currentTypeDefs = async () => {
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "currentTypeDefs",
-            },
-            {
-                operation: "id",
-            },
-        ], await this._ctx.connection());
-        return response.map((r) => new TypeDef({
-            queryTree: this.queryTree,
+    loadFunctionArgFromID = (id) => {
+        return new FunctionArg({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadFunctionArgFromID",
+                    args: { id },
+                },
+            ],
             ctx: this._ctx,
-        }, r.id));
+        });
     };
     /**
-     * The default platform of the builder.
+     * Load a FunctionCallArgValue from its ID.
      */
-    defaultPlatform = async () => {
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "defaultPlatform",
-            },
-        ], await this._ctx.connection());
-        return response;
+    loadFunctionCallArgValueFromID = (id) => {
+        return new FunctionCallArgValue({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadFunctionCallArgValueFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
-     * Creates an empty directory or loads one by ID.
+     * Load a FunctionCall from its ID.
      */
-    directory = (opts) => {
-        return new Directory({
+    loadFunctionCallFromID = (id) => {
+        return new FunctionCall({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "directory",
-                    args: { ...opts },
+                    operation: "loadFunctionCallFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * Loads a file by ID.
-     * @deprecated Use loadFileFromID instead.
+     * Load a Function from its ID.
      */
-    file = (id) => {
-        return new File({
+    loadFunctionFromID = (id) => {
+        return new Function_({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "file",
+                    operation: "loadFunctionFromID",
                     args: { id },
                 },
             ],
@@ -3505,98 +4440,89 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Create a function.
+     * Load a GeneratedCode from its ID.
      */
-    function_ = (name, returnType) => {
-        return new Function_({
+    loadGeneratedCodeFromID = (id) => {
+        return new GeneratedCode({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "function",
-                    args: { name, returnType },
+                    operation: "loadGeneratedCodeFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * Create a code generation result, given a directory containing the generated
-     * code.
+     * Load a GitModuleSource from its ID.
      */
-    generatedCode = (code) => {
-        return new GeneratedCode({
+    loadGitModuleSourceFromID = (id) => {
+        return new GitModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "generatedCode",
-                    args: { code },
+                    operation: "loadGitModuleSourceFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * 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.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.
+     * Load a GitRef from its ID.
      */
-    git = (url, opts) => {
-        return new GitRepository({
+    loadGitRefFromID = (id) => {
+        return new GitRef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "git",
-                    args: { url, ...opts },
+                    operation: "loadGitRefFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * Queries the host environment.
+     * Load a GitRepository from its ID.
      */
-    host = () => {
-        return new Host({
+    loadGitRepositoryFromID = (id) => {
+        return new GitRepository({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "host",
+                    operation: "loadGitRepositoryFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * Returns a file containing an http remote url content.
-     * @param url HTTP url to get the content from (e.g., "https://docs.dagger.io").
-     * @param opts.experimentalServiceHost A service which must be started before the URL is fetched.
+     * Load a Host from its ID.
      */
-    http = (url, opts) => {
-        return new File({
+    loadHostFromID = (id) => {
+        return new Host({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "http",
-                    args: { url, ...opts },
+                    operation: "loadHostFromID",
+                    args: { id },
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * Load a CacheVolume from its ID.
+     * Load a InputTypeDef from its ID.
      */
-    loadCacheVolumeFromID = (id) => {
-        return new CacheVolume({
+    loadInputTypeDefFromID = (id) => {
+        return new InputTypeDef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadCacheVolumeFromID",
+                    operation: "loadInputTypeDefFromID",
                     args: { id },
                 },
             ],
@@ -3604,14 +4530,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a container from an ID.
+     * Load a InterfaceTypeDef from its ID.
      */
-    loadContainerFromID = (id) => {
-        return new Container({
+    loadInterfaceTypeDefFromID = (id) => {
+        return new InterfaceTypeDef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadContainerFromID",
+                    operation: "loadInterfaceTypeDefFromID",
                     args: { id },
                 },
             ],
@@ -3619,14 +4545,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a Directory from its ID.
+     * Load a Label from its ID.
      */
-    loadDirectoryFromID = (id) => {
-        return new Directory({
+    loadLabelFromID = (id) => {
+        return new Label({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadDirectoryFromID",
+                    operation: "loadLabelFromID",
                     args: { id },
                 },
             ],
@@ -3634,14 +4560,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a File from its ID.
+     * Load a ListTypeDef from its ID.
      */
-    loadFileFromID = (id) => {
-        return new File({
+    loadListTypeDefFromID = (id) => {
+        return new ListTypeDef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadFileFromID",
+                    operation: "loadListTypeDefFromID",
                     args: { id },
                 },
             ],
@@ -3649,14 +4575,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a function argument by ID.
+     * Load a LocalModuleSource from its ID.
      */
-    loadFunctionArgFromID = (id) => {
-        return new FunctionArg({
+    loadLocalModuleSourceFromID = (id) => {
+        return new LocalModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadFunctionArgFromID",
+                    operation: "loadLocalModuleSourceFromID",
                     args: { id },
                 },
             ],
@@ -3664,14 +4590,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a function by ID.
+     * Load a ModuleDependency from its ID.
      */
-    loadFunctionFromID = (id) => {
-        return new Function_({
+    loadModuleDependencyFromID = (id) => {
+        return new ModuleDependency({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadFunctionFromID",
+                    operation: "loadModuleDependencyFromID",
                     args: { id },
                 },
             ],
@@ -3679,14 +4605,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a GeneratedCode by ID.
+     * Load a Module from its ID.
      */
-    loadGeneratedCodeFromID = (id) => {
-        return new GeneratedCode({
+    loadModuleFromID = (id) => {
+        return new Module_({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadGeneratedCodeFromID",
+                    operation: "loadModuleFromID",
                     args: { id },
                 },
             ],
@@ -3694,14 +4620,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a git ref from its ID.
+     * Load a ModuleSource from its ID.
      */
-    loadGitRefFromID = (id) => {
-        return new GitRef({
+    loadModuleSourceFromID = (id) => {
+        return new ModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadGitRefFromID",
+                    operation: "loadModuleSourceFromID",
                     args: { id },
                 },
             ],
@@ -3709,14 +4635,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a git repository from its ID.
+     * Load a ObjectTypeDef from its ID.
      */
-    loadGitRepositoryFromID = (id) => {
-        return new GitRepository({
+    loadObjectTypeDefFromID = (id) => {
+        return new ObjectTypeDef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadGitRepositoryFromID",
+                    operation: "loadObjectTypeDefFromID",
                     args: { id },
                 },
             ],
@@ -3724,14 +4650,14 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a module by ID.
+     * Load a Port from its ID.
      */
-    loadModuleFromID = (id) => {
-        return new Module_({
+    loadPortFromID = (id) => {
+        return new Port({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadModuleFromID",
+                    operation: "loadPortFromID",
                     args: { id },
                 },
             ],
@@ -3754,7 +4680,7 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Loads a service from ID.
+     * Load a Service from its ID.
      */
     loadServiceFromID = (id) => {
         return new Service({
@@ -3784,7 +4710,22 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a TypeDef by ID.
+     * Load a Terminal from its ID.
+     */
+    loadTerminalFromID = (id) => {
+        return new Terminal({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadTerminalFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a TypeDef from its ID.
      */
     loadTypeDefFromID = (id) => {
         return new TypeDef({
@@ -3813,15 +4754,35 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load the static configuration for a module from the given source directory and optional subpath.
+     * Create a new module dependency configuration from a module source and name
+     * @param source The source of the dependency
+     * @param opts.name If set, the name to use for the dependency. Otherwise, once installed to a parent module, the name of the dependency module will be used by default.
+     */
+    moduleDependency = (source, opts) => {
+        return new ModuleDependency({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "moduleDependency",
+                    args: { source, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Create a new module source instance from a source ref string.
+     * @param refString The string ref representation of the module source
+     * @param opts.rootDirectory An explicitly set root directory for the module source. This is required to load local sources as modules; other source types implicitly encode the root directory and do not require this.
+     * @param opts.stable If true, enforce that the source is a stable version for source kinds that support versioning.
      */
-    moduleConfig = (sourceDirectory, opts) => {
-        return new ModuleConfig({
+    moduleSource = (refString, opts) => {
+        return new ModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "moduleConfig",
-                    args: { sourceDirectory, ...opts },
+                    operation: "moduleSource",
+                    args: { refString, ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -3829,9 +4790,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 +4807,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 +4823,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 +4844,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 +4894,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,25 +4924,30 @@ export class Secret extends BaseClient {
         return response;
     };
 }
+/**
+ * A content-addressed service providing TCP connectivity.
+ */
 export class Service extends BaseClient {
     _id = undefined;
     _endpoint = undefined;
     _hostname = undefined;
     _start = undefined;
     _stop = undefined;
+    _up = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _endpoint, _hostname, _start, _stop) {
+    constructor(parent, _id, _endpoint, _hostname, _start, _stop, _up) {
         super(parent);
         this._id = _id;
         this._endpoint = _endpoint;
         this._hostname = _hostname;
         this._start = _start;
         this._stop = _stop;
+        this._up = _up;
     }
     /**
-     * A unique identifier for this service.
+     * A unique identifier for this Service.
      */
     id = async () => {
         if (this._id) {
@@ -4042,13 +5008,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.
@@ -4066,17 +5037,38 @@ export class Service extends BaseClient {
     };
     /**
      * Stop the service.
+     * @param opts.kill Immediately kill the service without waiting for a graceful exit
      */
-    stop = async () => {
+    stop = async (opts) => {
         await computeQuery([
             ...this._queryTree,
             {
                 operation: "stop",
+                args: { ...opts },
             },
         ], await this._ctx.connection());
         return this;
     };
+    /**
+     * Creates a tunnel that forwards traffic from the caller's network to this service.
+     */
+    up = async (opts) => {
+        if (this._up) {
+            return this._up;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "up",
+                args: { ...opts },
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
 }
+/**
+ * A Unix or TCP/IP socket that can be mounted into a container.
+ */
 export class Socket extends BaseClient {
     _id = undefined;
     /**
@@ -4087,7 +5079,37 @@ 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) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
+/**
+ * An interactive terminal that clients can connect to.
+ */
+export class Terminal extends BaseClient {
+    _id = undefined;
+    _websocketEndpoint = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _websocketEndpoint) {
+        super(parent);
+        this._id = _id;
+        this._websocketEndpoint = _websocketEndpoint;
+    }
+    /**
+     * A unique identifier for this Terminal.
      */
     id = async () => {
         if (this._id) {
@@ -4101,6 +5123,21 @@ export class Socket extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * An http endpoint at which this terminal can be connected to over a websocket.
+     */
+    websocketEndpoint = async () => {
+        if (this._websocketEndpoint) {
+            return this._websocketEndpoint;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "websocketEndpoint",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
 }
 /**
  * A definition of a parameter or return type in a Module.
@@ -4118,6 +5155,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 +5170,17 @@ 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.
-     */
+    asInput = () => {
+        return new InputTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "asInput",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     asInterface = () => {
         return new InterfaceTypeDef({
             queryTree: [
@@ -4145,10 +5192,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 +5203,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 +5214,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 +5226,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 +5341,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({