@dagger.io/dagger 0.9.7 → 0.9.9

package/dist/api/client.gen.js

@@ -57,6 +57,14 @@ 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.
  */
@@ -74,6 +82,10 @@ export var TypeDefKind;
      * A boolean value.
      */
     TypeDefKind["BooleanKind"] = "BOOLEAN_KIND";
+    /**
+     * A graphql input type, used only when representing the core API via TypeDefs.
+     */
+    TypeDefKind["InputKind"] = "INPUT_KIND";
     /**
      * An integer value.
      */
@@ -146,7 +158,6 @@ export class Container extends BaseClient {
     _label = undefined;
     _platform = undefined;
     _publish = undefined;
-    _shellEndpoint = undefined;
     _stderr = undefined;
     _stdout = undefined;
     _sync = undefined;
@@ -155,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;
@@ -164,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;
@@ -638,23 +648,6 @@ export class Container extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * 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.
-     */
-    shellEndpoint = async () => {
-        if (this._shellEndpoint) {
-            return this._shellEndpoint;
-        }
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "shellEndpoint",
-            },
-        ], await this._ctx.connection());
-        return response;
-    };
     /**
      * The error stream of the last executed command.
      *
@@ -703,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.
      */
@@ -734,6 +743,22 @@ export class Container extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Set the default command to invoke for the container's terminal API.
+     * @param args The args of the command.
+     */
+    withDefaultTerminalCmd = (args) => {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withDefaultTerminalCmd",
+                    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").
@@ -830,6 +855,7 @@ export class Container extends BaseClient {
      * @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 = {
@@ -1371,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.
  */
@@ -1404,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.
      *
@@ -1729,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;
@@ -1741,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;
@@ -1787,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;
@@ -1799,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;
@@ -1811,6 +1942,9 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type of the field.
+     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -1995,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,
@@ -2015,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;
@@ -2027,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;
@@ -2039,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: [
@@ -2129,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;
@@ -2141,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;
@@ -2153,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;
@@ -2165,6 +2320,9 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The type of the argument.
+     */
     typeDef = () => {
         return new TypeDef({
             queryTree: [
@@ -2212,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,
@@ -2232,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;
@@ -2244,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;
@@ -2256,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;
@@ -2317,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;
@@ -2329,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;
@@ -2369,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: [
@@ -2380,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,
@@ -2389,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,
@@ -2437,6 +2622,133 @@ export class GeneratedCode extends BaseClient {
         return arg(this);
     };
 }
+/**
+ * Module source originating from a git repo.
+ */
+export class GitModuleSource extends BaseClient {
+    _id = undefined;
+    _cloneURL = undefined;
+    _commit = undefined;
+    _htmlURL = undefined;
+    _rootSubpath = undefined;
+    _version = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _cloneURL, _commit, _htmlURL, _rootSubpath, _version) {
+        super(parent);
+        this._id = _id;
+        this._cloneURL = _cloneURL;
+        this._commit = _commit;
+        this._htmlURL = _htmlURL;
+        this._rootSubpath = _rootSubpath;
+        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;
+    };
+    /**
+     * The resolved commit of the git repo this source points to.
+     */
+    commit = async () => {
+        if (this._commit) {
+            return this._commit;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "commit",
+            },
+        ], 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
+     */
+    htmlURL = async () => {
+        if (this._htmlURL) {
+            return this._htmlURL;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "htmlURL",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * 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: "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;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "version",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * A git ref (tag, branch, or commit).
  */
@@ -2559,15 +2871,31 @@ export class GitRepository extends BaseClient {
         });
     };
     /**
-     * Returns details of a tag.
-     * @param name Tag's name (e.g., "v0.3.9").
+     * 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).
      */
-    tag = (name) => {
+    ref = (name) => {
         return new GitRef({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "tag",
+                    operation: "ref",
+                    args: { name },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Returns details of a tag.
+     * @param name Tag's name (e.g., "v0.3.9").
+     */
+    tag = (name) => {
+        return new GitRef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "tag",
                     args: { name },
                 },
             ],
@@ -2719,6 +3047,77 @@ 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;
+    };
+    /**
+     * Static fields defined on this input object, if any.
+     */
+    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));
+    };
+    /**
+     * The name of the input object.
+     */
+    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.
  */
@@ -2752,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;
@@ -2764,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,
@@ -2784,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;
@@ -2796,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;
@@ -2840,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;
@@ -2852,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;
@@ -2892,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: [
@@ -2904,6 +3324,65 @@ export class ListTypeDef extends BaseClient {
         });
     };
 }
+/**
+ * Module source that that originates from a path locally relative to an arbitrary directory.
+ */
+export class LocalModuleSource extends BaseClient {
+    _id = undefined;
+    _rootSubpath = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _rootSubpath) {
+        super(parent);
+        this._id = _id;
+        this._rootSubpath = _rootSubpath;
+    }
+    /**
+     * 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;
+    };
+    /**
+     * 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: "rootSubpath",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * A Dagger module.
  */
@@ -2913,18 +3392,16 @@ export class Module_ extends BaseClient {
     _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;
     }
     /**
      * A unique identifier for this Module.
@@ -2941,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,
@@ -2961,15 +3441,32 @@ 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,
             {
                 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;
@@ -2982,12 +3479,29 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    generatedCode = () => {
-        return new GeneratedCode({
+    /**
+     * The generated files and directories made on top of the module source's context directory.
+     */
+    generatedContextDiff = () => {
+        return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "generatedCode",
+                    operation: "generatedContextDiff",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The module source's context plus any configuration and source files created by codegen.
+     */
+    generatedContextDirectory = () => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "generatedContextDirectory",
                 },
             ],
             ctx: this._ctx,
@@ -3007,6 +3521,9 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Interfaces served by this module.
+     */
     interfaces = async () => {
         const response = await computeQuery([
             ...this._queryTree,
@@ -3027,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;
@@ -3039,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,
@@ -3059,6 +3582,23 @@ 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: [
+                ...this._queryTree,
+                {
+                    operation: "runtime",
+                },
+            ],
+            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;
@@ -3088,28 +3628,35 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
-    sourceDirectory = () => {
-        return new Directory({
+    /**
+     * The source for the module.
+     */
+    source = () => {
+        return new ModuleSource({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "sourceDirectory",
+                    operation: "source",
                 },
             ],
             ctx: this._ctx,
         });
     };
-    sourceDirectorySubpath = async () => {
-        if (this._sourceDirectorySubpath) {
-            return this._sourceDirectorySubpath;
-        }
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "sourceDirectorySubpath",
-            },
-        ], await this._ctx.connection());
-        return response;
+    /**
+     * Retrieves the module with the given description
+     * @param description The description to set
+     */
+    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
@@ -3142,21 +3689,16 @@ export class Module_ extends BaseClient {
         });
     };
     /**
-     * Retrieves the module with basic configuration loaded, ready for initialization.
-     * @param directory The directory containing the module's source code.
-     * @param opts.subpath An optional subpath of the directory which contains the module's source code.
-     *
-     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
-     *
-     * If not set, the module source code is loaded from the root of the directory.
+     * Retrieves the module with basic configuration loaded if present.
+     * @param source The module source to initialize from.
      */
-    withSource = (directory, opts) => {
+    withSource = (source) => {
         return new Module_({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withSource",
-                    args: { directory, ...opts },
+                    args: { source },
                 },
             ],
             ctx: this._ctx,
@@ -3172,25 +3714,94 @@ 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, _id, _name, _root, _sdk) {
+    constructor(parent, _id, _name) {
         super(parent);
         this._id = _id;
         this._name = _name;
-        this._root = _root;
-        this._sdk = _sdk;
     }
     /**
-     * A unique identifier for this ModuleConfig.
+     * A unique identifier for this ModuleDependency.
+     */
+    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 dependency module.
+     */
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The source for the dependency module.
+     */
+    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;
+    _configExists = undefined;
+    _kind = undefined;
+    _moduleName = 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, _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._moduleOriginalName = _moduleOriginalName;
+        this._resolveContextPathFromCaller = _resolveContextPathFromCaller;
+        this._sourceRootSubpath = _sourceRootSubpath;
+        this._sourceSubpath = _sourceSubpath;
+    }
+    /**
+     * A unique identifier for this ModuleSource.
      */
     id = async () => {
         if (this._id) {
@@ -3204,68 +3815,338 @@ export class ModuleConfig 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: [
+                ...this._queryTree,
+                {
+                    operation: "asGitSource",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * If the source is of kind local, the local source representation of it.
+     */
+    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,
+        });
+    };
+    /**
+     * A human readable ref string representation of this module source.
+     */
+    asString = async () => {
+        if (this._asString) {
+            return this._asString;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "asString",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * 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) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "directory",
+                    args: { path },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The kind of source (e.g. local, git, etc.)
+     */
+    kind = async () => {
+        if (this._kind) {
+            return this._kind;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "kind",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * If set, the name of the module this source references, including any overrides at runtime by callers.
+     */
+    moduleName = async () => {
+        if (this._moduleName) {
+            return this._moduleName;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "moduleName",
+            },
         ], await this._ctx.connection());
         return response;
     };
-    exclude = async () => {
+    /**
+     * 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: "exclude",
+                operation: "moduleOriginalName",
             },
         ], await this._ctx.connection());
         return response;
     };
-    include = async () => {
+    /**
+     * 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: "include",
+                operation: "resolveContextPathFromCaller",
             },
         ], await this._ctx.connection());
         return response;
     };
-    name = async () => {
-        if (this._name) {
-            return this._name;
+    /**
+     * 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,
+        });
+    };
+    /**
+     * 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: "resolveFromCaller",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * 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.
+     */
+    sourceRootSubpath = async () => {
+        if (this._sourceRootSubpath) {
+            return this._sourceRootSubpath;
         }
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "name",
+                operation: "sourceRootSubpath",
             },
         ], await this._ctx.connection());
         return response;
     };
-    root = async () => {
-        if (this._root) {
-            return this._root;
+    /**
+     * 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: "root",
+                operation: "sourceSubpath",
             },
         ], await this._ctx.connection());
         return response;
     };
-    sdk = async () => {
-        if (this._sdk) {
-            return this._sdk;
-        }
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "sdk",
-            },
-        ], 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.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with = (arg) => {
+        return arg(this);
     };
 }
 /**
@@ -3301,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: [
@@ -3312,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;
@@ -3324,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,
@@ -3344,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,
@@ -3364,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;
@@ -3376,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;
@@ -3395,15 +4294,17 @@ export class ObjectTypeDef extends BaseClient {
 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, _id, _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;
     }
@@ -3422,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;
@@ -3434,6 +4338,24 @@ 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;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "experimentalSkipHealthcheck",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The port number.
+     */
     port = async () => {
         if (this._port) {
             return this._port;
@@ -3446,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;
@@ -3561,7 +4486,7 @@ export class Client extends BaseClient {
      * The module currently being served in the session, if any.
      */
     currentModule = () => {
-        return new Module_({
+        return new CurrentModule({
             queryTree: [
                 ...this._queryTree,
                 {
@@ -3754,6 +4679,21 @@ export class Client extends BaseClient {
             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.
      */
@@ -3889,6 +4829,21 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a GitModuleSource from its ID.
+     */
+    loadGitModuleSourceFromID = (id) => {
+        return new GitModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadGitModuleSourceFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a GitRef from its ID.
      */
@@ -3934,6 +4889,21 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a InputTypeDef from its ID.
+     */
+    loadInputTypeDefFromID = (id) => {
+        return new InputTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadInputTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a InterfaceTypeDef from its ID.
      */
@@ -3980,14 +4950,29 @@ export class Client extends BaseClient {
         });
     };
     /**
-     * Load a ModuleConfig from its ID.
+     * Load a LocalModuleSource from its ID.
+     */
+    loadLocalModuleSourceFromID = (id) => {
+        return new LocalModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadLocalModuleSourceFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a ModuleDependency from its ID.
      */
-    loadModuleConfigFromID = (id) => {
-        return new ModuleConfig({
+    loadModuleDependencyFromID = (id) => {
+        return new ModuleDependency({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "loadModuleConfigFromID",
+                    operation: "loadModuleDependencyFromID",
                     args: { id },
                 },
             ],
@@ -4009,6 +4994,21 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a ModuleSource from its ID.
+     */
+    loadModuleSourceFromID = (id) => {
+        return new ModuleSource({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadModuleSourceFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a ObjectTypeDef from its ID.
      */
@@ -4084,6 +5084,21 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * 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.
      */
@@ -4114,15 +5129,34 @@ 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.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,
@@ -4273,16 +5307,18 @@ export class Service extends BaseClient {
     _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.
@@ -4375,16 +5411,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.
+     * @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) {
+            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.
@@ -4414,6 +5472,51 @@ export class Socket extends BaseClient {
         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) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], 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.
  */
@@ -4445,6 +5548,23 @@ 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: [
+                ...this._queryTree,
+                {
+                    operation: "asInput",
+                },
+            ],
+            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: [
@@ -4456,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: [
@@ -4467,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: [
@@ -4478,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;
@@ -4490,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;