@dagger.io/dagger 0.9.8 → 0.9.9

package/dist/api/client.gen.js

@@ -648,22 +648,6 @@ export class Container extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * 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.
-     */
-    shell = (opts) => {
-        return new Terminal({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "shell",
-                    args: { ...opts },
-                },
-            ],
-            ctx: this._ctx,
-        });
-    };
     /**
      * The error stream of the last executed command.
      *
@@ -712,6 +696,22 @@ export class Container extends BaseClient {
         ], await this._ctx.connection());
         return this;
     };
+    /**
+     * Return an interactive terminal for this container using its configured default terminal command if not overridden by args (or sh as a fallback default).
+     * @param opts.cmd If set, override the container's default terminal command and invoke these command arguments instead.
+     */
+    terminal = (opts) => {
+        return new Terminal({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "terminal",
+                    args: { ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Retrieves the user to be set for all commands.
      */
@@ -744,15 +744,15 @@ export class Container extends BaseClient {
         });
     };
     /**
-     * Set the default command to invoke for the "shell" API.
-     * @param args The args of the command to set the default shell to.
+     * Set the default command to invoke for the container's terminal API.
+     * @param args The args of the command.
      */
-    withDefaultShell = (args) => {
+    withDefaultTerminalCmd = (args) => {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "withDefaultShell",
+                    operation: "withDefaultTerminalCmd",
                     args: { args },
                 },
             ],
@@ -1523,7 +1523,7 @@ 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.sourceRootPath An optional subpath of the directory which contains the module's configuration file.
      *
      * 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.
      *
@@ -1848,6 +1848,9 @@ export class EnvVariable extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The environment variable name.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -1860,6 +1863,9 @@ export class EnvVariable extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The environment variable value.
+     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -1906,6 +1912,9 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * A doc string for the field, if any.
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -1918,6 +1927,9 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The name of the field in lowerCamelCase format.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -1930,6 +1942,9 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type of the field.
+     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2114,6 +2129,9 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Arguments accepted by the function, if any.
+     */
     args = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2134,6 +2152,9 @@ export class Function_ extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * A doc string for the function, if any.
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -2146,6 +2167,9 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The name of the function.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2158,6 +2182,9 @@ export class Function_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type returned by the function.
+     */
     returnType = () => {
         return new TypeDef({
             queryTree: [
@@ -2248,6 +2275,9 @@ 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;
@@ -2260,6 +2290,9 @@ 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;
@@ -2272,6 +2305,9 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The name of the argument in lowerCamelCase format.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2284,6 +2320,9 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type of the argument.
+     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2331,6 +2370,9 @@ export class FunctionCall extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The argument values the function is being invoked with.
+     */
     inputArgs = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2351,6 +2393,9 @@ export class FunctionCall extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The name of the function being called.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2363,6 +2408,9 @@ 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;
@@ -2375,6 +2423,9 @@ 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;
@@ -2436,6 +2487,9 @@ export class FunctionCallArgValue extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The name of the argument.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -2448,6 +2502,9 @@ export class FunctionCallArgValue extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The value of the argument represented as a JSON serialized string.
+     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -2488,6 +2545,9 @@ export class GeneratedCode extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The directory containing the generated code.
+     */
     code = () => {
         return new Directory({
             queryTree: [
@@ -2499,6 +2559,9 @@ 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,
@@ -2508,6 +2571,9 @@ 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,
@@ -2564,18 +2630,18 @@ export class GitModuleSource extends BaseClient {
     _cloneURL = undefined;
     _commit = undefined;
     _htmlURL = undefined;
-    _sourceSubpath = undefined;
+    _rootSubpath = undefined;
     _version = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _cloneURL, _commit, _htmlURL, _sourceSubpath, _version) {
+    constructor(parent, _id, _cloneURL, _commit, _htmlURL, _rootSubpath, _version) {
         super(parent);
         this._id = _id;
         this._cloneURL = _cloneURL;
         this._commit = _commit;
         this._htmlURL = _htmlURL;
-        this._sourceSubpath = _sourceSubpath;
+        this._rootSubpath = _rootSubpath;
         this._version = _version;
     }
     /**
@@ -2608,6 +2674,9 @@ export class GitModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The resolved commit of the git repo this source points to.
+     */
     commit = async () => {
         if (this._commit) {
             return this._commit;
@@ -2620,6 +2689,20 @@ export class GitModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "contextDirectory",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * The URL to the source's git repo in a web browser
      */
@@ -2635,18 +2718,24 @@ export class GitModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    sourceSubpath = async () => {
-        if (this._sourceSubpath) {
-            return this._sourceSubpath;
+    /**
+     * The path to the root of the module source under the context directory. This directory contains its configuration file. It also contains its source code (possibly as a subdirectory).
+     */
+    rootSubpath = async () => {
+        if (this._rootSubpath) {
+            return this._rootSubpath;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "sourceSubpath",
+                operation: "rootSubpath",
             },
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The specified version of the git repo this source points to.
+     */
     version = async () => {
         if (this._version) {
             return this._version;
@@ -2781,6 +2870,22 @@ export class GitRepository extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Returns details of a ref.
+     * @param name Ref's name (can be a commit identifier, a tag name, a branch name, or a fully-qualified ref).
+     */
+    ref = (name) => {
+        return new GitRef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "ref",
+                    args: { name },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Returns details of a tag.
      * @param name Tag's name (e.g., "v0.3.9").
@@ -2974,6 +3079,9 @@ export class InputTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Static fields defined on this input object, if any.
+     */
     fields = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -2994,6 +3102,9 @@ export class InputTypeDef extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The name of the input object.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3040,6 +3151,9 @@ export class InterfaceTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The doc string for the interface, if any.
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3052,6 +3166,9 @@ 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,
@@ -3072,6 +3189,9 @@ export class InterfaceTypeDef extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The name of the interface.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3084,6 +3204,9 @@ 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;
@@ -3128,6 +3251,9 @@ export class Label extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The label name.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3140,6 +3266,9 @@ export class Label extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The label value.
+     */
     value = async () => {
         if (this._value) {
             return this._value;
@@ -3180,6 +3309,9 @@ export class ListTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type of the elements in the list.
+     */
     elementTypeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -3197,14 +3329,14 @@ export class ListTypeDef extends BaseClient {
  */
 export class LocalModuleSource extends BaseClient {
     _id = undefined;
-    _sourceSubpath = undefined;
+    _rootSubpath = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _sourceSubpath) {
+    constructor(parent, _id, _rootSubpath) {
         super(parent);
         this._id = _id;
-        this._sourceSubpath = _sourceSubpath;
+        this._rootSubpath = _rootSubpath;
     }
     /**
      * A unique identifier for this LocalModuleSource.
@@ -3221,14 +3353,31 @@ export class LocalModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    sourceSubpath = async () => {
-        if (this._sourceSubpath) {
-            return this._sourceSubpath;
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "contextDirectory",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The path to the root of the module source under the context directory. This directory contains its configuration file. It also contains its source code (possibly as a subdirectory).
+     */
+    rootSubpath = async () => {
+        if (this._rootSubpath) {
+            return this._rootSubpath;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "sourceSubpath",
+                operation: "rootSubpath",
             },
         ], await this._ctx.connection());
         return response;
@@ -3269,6 +3418,9 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Modules used by this module.
+     */
     dependencies = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3289,6 +3441,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The dependencies as configured by the module.
+     */
     dependencyConfig = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3309,6 +3464,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The doc string of the module, if any
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3322,14 +3480,28 @@ export class Module_ extends BaseClient {
         return response;
     };
     /**
-     * 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.
+     * The generated files and directories made on top of the module source's context directory.
+     */
+    generatedContextDiff = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "generatedContextDiff",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The module source's context plus any configuration and source files created by codegen.
      */
-    generatedSourceRootDirectory = () => {
+    generatedContextDirectory = () => {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "generatedSourceRootDirectory",
+                    operation: "generatedContextDirectory",
                 },
             ],
             ctx: this._ctx,
@@ -3349,6 +3521,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Interfaces served by this module.
+     */
     interfaces = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3369,6 +3544,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The name of the module
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3381,6 +3559,9 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Objects served by this module.
+     */
     objects = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3401,6 +3582,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The container that runs the module's entrypoint. It will fail to execute if the module doesn't compile.
+     */
     runtime = () => {
         return new Container({
             queryTree: [
@@ -3412,6 +3596,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * The SDK used by this module. Either a name of a builtin SDK or a module source ref string pointing to the SDK's implementation.
+     */
     sdk = async () => {
         if (this._sdk) {
             return this._sdk;
@@ -3441,6 +3628,9 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The source for the module.
+     */
     source = () => {
         return new ModuleSource({
             queryTree: [
@@ -3452,22 +3642,6 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * Update the module configuration to use the given dependencies.
-     * @param dependencies The dependency modules to install.
-     */
-    withDependencies = (dependencies) => {
-        return new Module_({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "withDependencies",
-                    args: { dependencies },
-                },
-            ],
-            ctx: this._ctx,
-        });
-    };
     /**
      * Retrieves the module with the given description
      * @param description The description to set
@@ -3499,22 +3673,6 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * 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.
      */
@@ -3530,22 +3688,6 @@ 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.
@@ -3600,6 +3742,9 @@ export class ModuleDependency extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The name of the dependency module.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3612,6 +3757,9 @@ export class ModuleDependency extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The source for the dependency module.
+     */
     source = () => {
         return new ModuleSource({
             queryTree: [
@@ -3630,19 +3778,27 @@ export class ModuleDependency extends BaseClient {
 export class ModuleSource extends BaseClient {
     _id = undefined;
     _asString = undefined;
+    _configExists = undefined;
     _kind = undefined;
     _moduleName = undefined;
-    _subpath = undefined;
+    _moduleOriginalName = undefined;
+    _resolveContextPathFromCaller = undefined;
+    _sourceRootSubpath = undefined;
+    _sourceSubpath = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _asString, _kind, _moduleName, _subpath) {
+    constructor(parent, _id, _asString, _configExists, _kind, _moduleName, _moduleOriginalName, _resolveContextPathFromCaller, _sourceRootSubpath, _sourceSubpath) {
         super(parent);
         this._id = _id;
         this._asString = _asString;
+        this._configExists = _configExists;
         this._kind = _kind;
         this._moduleName = _moduleName;
-        this._subpath = _subpath;
+        this._moduleOriginalName = _moduleOriginalName;
+        this._resolveContextPathFromCaller = _resolveContextPathFromCaller;
+        this._sourceRootSubpath = _sourceRootSubpath;
+        this._sourceSubpath = _sourceSubpath;
     }
     /**
      * A unique identifier for this ModuleSource.
@@ -3659,6 +3815,9 @@ export class ModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * If the source is a of kind git, the git source representation of it.
+     */
     asGitSource = () => {
         return new GitModuleSource({
             queryTree: [
@@ -3670,6 +3829,9 @@ export class ModuleSource extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * If the source is of kind local, the local source representation of it.
+     */
     asLocalSource = () => {
         return new LocalModuleSource({
             queryTree: [
@@ -3711,7 +3873,59 @@ export class ModuleSource extends BaseClient {
         return response;
     };
     /**
-     * The directory containing the actual module's source code, as determined from the root directory and subpath.
+     * Returns whether the module source has a configuration file.
+     */
+    configExists = async () => {
+        if (this._configExists) {
+            return this._configExists;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "configExists",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "contextDirectory",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The dependencies of the module source. Includes dependencies from the configuration and any extras from withDependencies calls.
+     */
+    dependencies = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "dependencies",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new ModuleDependency({
+            queryTree: [
+                {
+                    operation: "loadModuleDependencyFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
+    /**
+     * The directory containing the module configuration and source code (source code may be in a subdir).
      * @param path The path from the source directory to select.
      */
     directory = (path) => {
@@ -3726,6 +3940,9 @@ export class ModuleSource extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * The kind of source (e.g. local, git, etc.)
+     */
     kind = async () => {
         if (this._kind) {
             return this._kind;
@@ -3739,7 +3956,7 @@ export class ModuleSource extends BaseClient {
         return response;
     };
     /**
-     * If set, the name of the module this source references
+     * If set, the name of the module this source references, including any overrides at runtime by callers.
      */
     moduleName = async () => {
         if (this._moduleName) {
@@ -3753,6 +3970,36 @@ export class ModuleSource extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The original name of the module this source references, as defined in the module configuration.
+     */
+    moduleOriginalName = async () => {
+        if (this._moduleOriginalName) {
+            return this._moduleOriginalName;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "moduleOriginalName",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The path to the module source's context directory on the caller's filesystem. Only valid for local sources.
+     */
+    resolveContextPathFromCaller = async () => {
+        if (this._resolveContextPathFromCaller) {
+            return this._resolveContextPathFromCaller;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "resolveContextPathFromCaller",
+            },
+        ], 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.
@@ -3769,32 +4016,130 @@ export class ModuleSource extends BaseClient {
             ctx: this._ctx,
         });
     };
-    rootDirectory = () => {
-        return new Directory({
+    /**
+     * Load the source from its path on the caller's filesystem, including only needed+configured files and directories. Only valid for local sources.
+     */
+    resolveFromCaller = () => {
+        return new ModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "rootDirectory",
+                    operation: "resolveFromCaller",
                 },
             ],
             ctx: this._ctx,
         });
     };
     /**
-     * The path to the module subdirectory containing the actual module's source code.
+     * The path relative to context of the root of the module source, which contains dagger.json. It also contains the module implementation source code, but that may or may not being a subdir of this root.
      */
-    subpath = async () => {
-        if (this._subpath) {
-            return this._subpath;
+    sourceRootSubpath = async () => {
+        if (this._sourceRootSubpath) {
+            return this._sourceRootSubpath;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "subpath",
+                operation: "sourceRootSubpath",
             },
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The path relative to context of the module implementation source code.
+     */
+    sourceSubpath = async () => {
+        if (this._sourceSubpath) {
+            return this._sourceSubpath;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "sourceSubpath",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Update the module source with a new context directory. Only valid for local sources.
+     * @param dir The directory to set as the context directory.
+     */
+    withContextDirectory = (dir) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withContextDirectory",
+                    args: { dir },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Append the provided dependencies to the module source's dependency list.
+     * @param dependencies The dependencies to append.
+     */
+    withDependencies = (dependencies) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withDependencies",
+                    args: { dependencies },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Update the module source with a new name.
+     * @param name The name to set.
+     */
+    withName = (name) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withName",
+                    args: { name },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Update the module source with a new SDK.
+     * @param sdk The SDK to set.
+     */
+    withSDK = (sdk) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSDK",
+                    args: { sdk },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Update the module source with a new source subpath.
+     * @param path The path to set as the source subpath.
+     */
+    withSourceSubpath = (path) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSourceSubpath",
+                    args: { path },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Call the provided function with current ModuleSource.
      *
@@ -3837,6 +4182,9 @@ export class ObjectTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The function used to construct new instances of this object, if any
+     */
     constructor_ = () => {
         return new Function_({
             queryTree: [
@@ -3848,6 +4196,9 @@ export class ObjectTypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * The doc string for the object, if any.
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3860,6 +4211,9 @@ 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,
@@ -3880,6 +4234,9 @@ export class ObjectTypeDef extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * Functions defined on this object, if any.
+     */
     functions = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3900,6 +4257,9 @@ export class ObjectTypeDef extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The name of the object.
+     */
     name = async () => {
         if (this._name) {
             return this._name;
@@ -3912,6 +4272,9 @@ 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;
@@ -3960,6 +4323,9 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The port description.
+     */
     description = async () => {
         if (this._description) {
             return this._description;
@@ -3972,6 +4338,9 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Skip the health check when run as a service.
+     */
     experimentalSkipHealthcheck = async () => {
         if (this._experimentalSkipHealthcheck) {
             return this._experimentalSkipHealthcheck;
@@ -3984,6 +4353,9 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The port number.
+     */
     port = async () => {
         if (this._port) {
             return this._port;
@@ -3996,6 +4368,9 @@ export class Port extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The transport layer protocol.
+     */
     protocol = async () => {
         if (this._protocol) {
             return this._protocol;
@@ -4773,7 +5148,6 @@ export class Client extends BaseClient {
     /**
      * 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.
      */
     moduleSource = (refString, opts) => {
@@ -5051,6 +5425,10 @@ export class Service extends BaseClient {
     };
     /**
      * Creates a tunnel that forwards traffic from the caller's network to this service.
+     * @param opts.ports List of frontend/backend port mappings to forward.
+     *
+     * Frontend is the port accepting traffic on the host, backend is the service port.
+     * @param opts.random Bind each tunnel port to a random port on the host.
      */
     up = async (opts) => {
         if (this._up) {
@@ -5170,6 +5548,9 @@ export class TypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * If kind is INPUT, the input-specific type definition. If kind is not INPUT, this will be null.
+     */
     asInput = () => {
         return new InputTypeDef({
             queryTree: [
@@ -5181,6 +5562,9 @@ export class TypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * If kind is INTERFACE, the interface-specific type definition. If kind is not INTERFACE, this will be null.
+     */
     asInterface = () => {
         return new InterfaceTypeDef({
             queryTree: [
@@ -5192,6 +5576,9 @@ 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: [
@@ -5203,6 +5590,9 @@ 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: [
@@ -5214,6 +5604,9 @@ 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;
@@ -5226,6 +5619,9 @@ 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;