@dagger.io/dagger 0.9.7 → 0.9.9

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

@@ -165,6 +165,12 @@ export type ContainerPublishOpts = {
      */
     mediaTypes?: ImageMediaTypes;
 };
+export type ContainerTerminalOpts = {
+    /**
+     * If set, override the container's default terminal command and invoke these command arguments instead.
+     */
+    cmd?: string[];
+};
 export type ContainerWithDirectoryOpts = {
     /**
      * Patterns to exclude in the written directory (e.g. ["node_modules/**", ".gitignore", ".git/"]).
@@ -232,6 +238,10 @@ export type ContainerWithExposedPortOpts = {
      * Optional port description
      */
     description?: string;
+    /**
+     * Skip the health check when run as a service.
+     */
+    experimentalSkipHealthcheck?: boolean;
 };
 export type ContainerWithFileOpts = {
     /**
@@ -349,15 +359,31 @@ export type ContainerWithoutExposedPortOpts = {
 export type ContainerID = string & {
     __ContainerID: never;
 };
+export type CurrentModuleWorkdirOpts = {
+    /**
+     * Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
+     */
+    exclude?: string[];
+    /**
+     * Include only artifacts that match the given pattern (e.g., ["app/", "package.*"]).
+     */
+    include?: string[];
+};
+/**
+ * The `CurrentModuleID` scalar type represents an identifier for an object of type CurrentModule.
+ */
+export type CurrentModuleID = string & {
+    __CurrentModuleID: never;
+};
 export type DirectoryAsModuleOpts = {
     /**
-     * An optional subpath of the directory which contains the module's source code.
+     * An optional subpath of the directory which contains the module's 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.
      *
      * If not set, the module source code is loaded from the root of the directory.
      */
-    sourceSubpath?: string;
+    sourceRootPath?: string;
 };
 export type DirectoryDockerBuildOpts = {
     /**
@@ -497,6 +523,12 @@ export type FunctionID = string & {
 export type GeneratedCodeID = string & {
     __GeneratedCodeID: never;
 };
+/**
+ * The `GitModuleSourceID` scalar type represents an identifier for an object of type GitModuleSource.
+ */
+export type GitModuleSourceID = string & {
+    __GitModuleSourceID: never;
+};
 export type GitRefTreeOpts = {
     /**
      * DEPRECATED: This option should be passed to `git` instead.
@@ -583,6 +615,12 @@ export declare enum ImageMediaTypes {
     Dockermediatypes = "DockerMediaTypes",
     Ocimediatypes = "OCIMediaTypes"
 }
+/**
+ * The `InputTypeDefID` scalar type represents an identifier for an object of type InputTypeDef.
+ */
+export type InputTypeDefID = string & {
+    __InputTypeDefID: never;
+};
 /**
  * The `InterfaceTypeDefID` scalar type represents an identifier for an object of type InterfaceTypeDef.
  */
@@ -607,21 +645,17 @@ export type LabelID = string & {
 export type ListTypeDefID = string & {
     __ListTypeDefID: never;
 };
-export type ModuleWithSourceOpts = {
-    /**
-     * An optional subpath of the directory which contains the module's source code.
-     *
-     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
-     *
-     * If not set, the module source code is loaded from the root of the directory.
-     */
-    subpath?: string;
+/**
+ * The `LocalModuleSourceID` scalar type represents an identifier for an object of type LocalModuleSource.
+ */
+export type LocalModuleSourceID = string & {
+    __LocalModuleSourceID: never;
 };
 /**
- * The `ModuleConfigID` scalar type represents an identifier for an object of type ModuleConfig.
+ * The `ModuleDependencyID` scalar type represents an identifier for an object of type ModuleDependency.
  */
-export type ModuleConfigID = string & {
-    __ModuleConfigID: never;
+export type ModuleDependencyID = string & {
+    __ModuleDependencyID: never;
 };
 /**
  * The `ModuleID` scalar type represents an identifier for an object of type Module.
@@ -629,6 +663,19 @@ export type ModuleConfigID = string & {
 export type ModuleID = string & {
     __ModuleID: never;
 };
+/**
+ * The `ModuleSourceID` scalar type represents an identifier for an object of type ModuleSource.
+ */
+export type ModuleSourceID = string & {
+    __ModuleSourceID: never;
+};
+/**
+ * The kind of module source.
+ */
+export declare enum ModuleSourceKind {
+    GitSource = "GIT_SOURCE",
+    LocalSource = "LOCAL_SOURCE"
+}
 /**
  * Transport layer network protocol associated to a port.
  */
@@ -720,8 +767,17 @@ export type ClientHttpOpts = {
      */
     experimentalServiceHost?: Service;
 };
-export type ClientModuleConfigOpts = {
-    subpath?: string;
+export type ClientModuleDependencyOpts = {
+    /**
+     * 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.
+     */
+    name?: string;
+};
+export type ClientModuleSourceOpts = {
+    /**
+     * If true, enforce that the source is a stable version for source kinds that support versioning.
+     */
+    stable?: boolean;
 };
 export type ClientPipelineOpts = {
     /**
@@ -749,6 +805,24 @@ export type ServiceEndpointOpts = {
      */
     scheme?: string;
 };
+export type ServiceStopOpts = {
+    /**
+     * Immediately kill the service without waiting for a graceful exit
+     */
+    kill?: boolean;
+};
+export type ServiceUpOpts = {
+    /**
+     * List of frontend/backend port mappings to forward.
+     *
+     * Frontend is the port accepting traffic on the host, backend is the service port.
+     */
+    ports?: PortForward[];
+    /**
+     * Bind each tunnel port to a random port on the host.
+     */
+    random?: boolean;
+};
 /**
  * The `ServiceID` scalar type represents an identifier for an object of type Service.
  */
@@ -761,6 +835,12 @@ export type ServiceID = string & {
 export type SocketID = string & {
     __SocketID: never;
 };
+/**
+ * The `TerminalID` scalar type represents an identifier for an object of type Terminal.
+ */
+export type TerminalID = string & {
+    __TerminalID: never;
+};
 export type TypeDefWithFieldOpts = {
     /**
      * A doc string for the field, if any
@@ -787,6 +867,10 @@ export declare enum TypeDefKind {
      * A boolean value.
      */
     BooleanKind = "BOOLEAN_KIND",
+    /**
+     * A graphql input type, used only when representing the core API via TypeDefs.
+     */
+    InputKind = "INPUT_KIND",
     /**
      * An integer value.
      */
@@ -862,7 +946,6 @@ export declare class Container extends BaseClient {
     private readonly _label?;
     private readonly _platform?;
     private readonly _publish?;
-    private readonly _shellEndpoint?;
     private readonly _stderr?;
     private readonly _stdout?;
     private readonly _sync?;
@@ -874,7 +957,7 @@ export declare class Container extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: ContainerID, _envVariable?: string, _export?: boolean, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _shellEndpoint?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
+    }, _id?: ContainerID, _envVariable?: string, _export?: boolean, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
     /**
      * A unique identifier for this Container.
      */
@@ -1050,12 +1133,6 @@ export declare class Container extends BaseClient {
      * Retrieves this container's root filesystem. Mounts are not included.
      */
     rootfs: () => Directory;
-    /**
-     * 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: () => Promise<string>;
     /**
      * The error stream of the last executed command.
      *
@@ -1074,6 +1151,11 @@ export declare class Container extends BaseClient {
      * It doesn't run the default command if no exec has been set.
      */
     sync: () => Promise<Container>;
+    /**
+     * 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?: ContainerTerminalOpts) => Terminal;
     /**
      * Retrieves the user to be set for all commands.
      */
@@ -1083,6 +1165,11 @@ export declare class Container extends BaseClient {
      * @param args Arguments to prepend to future executions (e.g., ["-v", "--no-cache"]).
      */
     withDefaultArgs: (args: string[]) => Container;
+    /**
+     * Set the default command to invoke for the container's terminal API.
+     * @param args The args of the command.
+     */
+    withDefaultTerminalCmd: (args: string[]) => Container;
     /**
      * Retrieves this container plus a directory written at the given path.
      * @param path Location of the written directory (e.g., "/tmp/directory").
@@ -1135,6 +1222,7 @@ export declare 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: number, opts?: ContainerWithExposedPortOpts) => Container;
     /**
@@ -1351,6 +1439,44 @@ export declare class Container extends BaseClient {
      */
     with: (arg: (param: Container) => Container) => Container;
 }
+/**
+ * Reflective module API provided to functions at runtime.
+ */
+export declare class CurrentModule extends BaseClient {
+    private readonly _id?;
+    private readonly _name?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: CurrentModuleID, _name?: string);
+    /**
+     * A unique identifier for this CurrentModule.
+     */
+    id: () => Promise<CurrentModuleID>;
+    /**
+     * The name of the module being executed in
+     */
+    name: () => Promise<string>;
+    /**
+     * The directory containing the module's source code loaded into the engine (plus any generated code that may have been created).
+     */
+    source: () => Directory;
+    /**
+     * 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: string, opts?: CurrentModuleWorkdirOpts) => Directory;
+    /**
+     * 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: string) => File;
+}
 /**
  * A directory.
  */
@@ -1371,7 +1497,7 @@ export declare class Directory extends BaseClient {
     id: () => Promise<DirectoryID>;
     /**
      * Load the directory as a Dagger module
-     * @param opts.sourceSubpath An optional subpath of the directory which contains the module's source code.
+     * @param opts.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.
      *
@@ -1500,7 +1626,13 @@ export declare class EnvVariable extends BaseClient {
      * A unique identifier for this EnvVariable.
      */
     id: () => Promise<EnvVariableID>;
+    /**
+     * The environment variable name.
+     */
     name: () => Promise<string>;
+    /**
+     * The environment variable value.
+     */
     value: () => Promise<string>;
 }
 /**
@@ -1523,8 +1655,17 @@ export declare class FieldTypeDef extends BaseClient {
      * A unique identifier for this FieldTypeDef.
      */
     id: () => Promise<FieldTypeDefID>;
+    /**
+     * A doc string for the field, if any.
+     */
     description: () => Promise<string>;
+    /**
+     * The name of the field in lowerCamelCase format.
+     */
     name: () => Promise<string>;
+    /**
+     * The type of the field.
+     */
     typeDef: () => TypeDef;
 }
 /**
@@ -1604,9 +1745,21 @@ export declare class Function_ extends BaseClient {
      * A unique identifier for this Function.
      */
     id: () => Promise<FunctionID>;
+    /**
+     * Arguments accepted by the function, if any.
+     */
     args: () => Promise<FunctionArg[]>;
+    /**
+     * A doc string for the function, if any.
+     */
     description: () => Promise<string>;
+    /**
+     * The name of the function.
+     */
     name: () => Promise<string>;
+    /**
+     * The type returned by the function.
+     */
     returnType: () => TypeDef;
     /**
      * Returns the function with the provided argument
@@ -1649,9 +1802,21 @@ export declare class FunctionArg extends BaseClient {
      * A unique identifier for this FunctionArg.
      */
     id: () => Promise<FunctionArgID>;
+    /**
+     * A default value to use for this argument when not explicitly set by the caller, if any.
+     */
     defaultValue: () => Promise<JSON>;
+    /**
+     * A doc string for the argument, if any.
+     */
     description: () => Promise<string>;
+    /**
+     * The name of the argument in lowerCamelCase format.
+     */
     name: () => Promise<string>;
+    /**
+     * The type of the argument.
+     */
     typeDef: () => TypeDef;
 }
 /**
@@ -1674,9 +1839,21 @@ export declare class FunctionCall extends BaseClient {
      * A unique identifier for this FunctionCall.
      */
     id: () => Promise<FunctionCallID>;
+    /**
+     * The argument values the function is being invoked with.
+     */
     inputArgs: () => Promise<FunctionCallArgValue[]>;
+    /**
+     * The name of the function being called.
+     */
     name: () => Promise<string>;
+    /**
+     * The value of the parent object of the function being called. If the function is top-level to the module, this is always an empty object.
+     */
     parent: () => Promise<JSON>;
+    /**
+     * The name of the parent object of the function being called. If the function is top-level to the module, this is the name of the module.
+     */
     parentName: () => Promise<string>;
     /**
      * Set the return value of the function call to the provided value.
@@ -1702,7 +1879,13 @@ export declare class FunctionCallArgValue extends BaseClient {
      * A unique identifier for this FunctionCallArgValue.
      */
     id: () => Promise<FunctionCallArgValueID>;
+    /**
+     * The name of the argument.
+     */
     name: () => Promise<string>;
+    /**
+     * The value of the argument represented as a JSON serialized string.
+     */
     value: () => Promise<JSON>;
 }
 /**
@@ -1721,8 +1904,17 @@ export declare class GeneratedCode extends BaseClient {
      * A unique identifier for this GeneratedCode.
      */
     id: () => Promise<GeneratedCodeID>;
+    /**
+     * The directory containing the generated code.
+     */
     code: () => Directory;
+    /**
+     * List of paths to mark generated in version control (i.e. .gitattributes).
+     */
     vcsGeneratedPaths: () => Promise<string[]>;
+    /**
+     * List of paths to ignore in version control (i.e. .gitignore).
+     */
     vcsIgnoredPaths: () => Promise<string[]>;
     /**
      * Set the list of paths to mark generated in version control.
@@ -1739,6 +1931,52 @@ export declare class GeneratedCode extends BaseClient {
      */
     with: (arg: (param: GeneratedCode) => GeneratedCode) => GeneratedCode;
 }
+/**
+ * Module source originating from a git repo.
+ */
+export declare class GitModuleSource extends BaseClient {
+    private readonly _id?;
+    private readonly _cloneURL?;
+    private readonly _commit?;
+    private readonly _htmlURL?;
+    private readonly _rootSubpath?;
+    private readonly _version?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: GitModuleSourceID, _cloneURL?: string, _commit?: string, _htmlURL?: string, _rootSubpath?: string, _version?: string);
+    /**
+     * A unique identifier for this GitModuleSource.
+     */
+    id: () => Promise<GitModuleSourceID>;
+    /**
+     * The URL from which the source's git repo can be cloned.
+     */
+    cloneURL: () => Promise<string>;
+    /**
+     * The resolved commit of the git repo this source points to.
+     */
+    commit: () => Promise<string>;
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory: () => Directory;
+    /**
+     * The URL to the source's git repo in a web browser
+     */
+    htmlURL: () => Promise<string>;
+    /**
+     * 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: () => Promise<string>;
+    /**
+     * The specified version of the git repo this source points to.
+     */
+    version: () => Promise<string>;
+}
 /**
  * A git ref (tag, branch, or commit).
  */
@@ -1793,6 +2031,11 @@ export declare class GitRepository extends BaseClient {
      * @param id Identifier of the commit (e.g., "b6315d8f2810962c601af73f86831f6866ea798b").
      */
     commit: (id: string) => GitRef;
+    /**
+     * 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: string) => GitRef;
     /**
      * Returns details of a tag.
      * @param name Tag's name (e.g., "v0.3.9").
@@ -1866,6 +2109,35 @@ export declare class Host extends BaseClient {
      */
     unixSocket: (path: string) => Socket;
 }
+/**
+ * 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 declare class InputTypeDef extends BaseClient {
+    private readonly _id?;
+    private readonly _name?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: InputTypeDefID, _name?: string);
+    /**
+     * A unique identifier for this InputTypeDef.
+     */
+    id: () => Promise<InputTypeDefID>;
+    /**
+     * Static fields defined on this input object, if any.
+     */
+    fields: () => Promise<FieldTypeDef[]>;
+    /**
+     * The name of the input object.
+     */
+    name: () => Promise<string>;
+}
 /**
  * A definition of a custom interface defined in a Module.
  */
@@ -1885,9 +2157,21 @@ export declare class InterfaceTypeDef extends BaseClient {
      * A unique identifier for this InterfaceTypeDef.
      */
     id: () => Promise<InterfaceTypeDefID>;
+    /**
+     * The doc string for the interface, if any.
+     */
     description: () => Promise<string>;
+    /**
+     * Functions defined on this interface, if any.
+     */
     functions: () => Promise<Function_[]>;
+    /**
+     * The name of the interface.
+     */
     name: () => Promise<string>;
+    /**
+     * If this InterfaceTypeDef is associated with a Module, the name of the module. Unset otherwise.
+     */
     sourceModuleName: () => Promise<string>;
 }
 /**
@@ -1908,7 +2192,13 @@ export declare class Label extends BaseClient {
      * A unique identifier for this Label.
      */
     id: () => Promise<LabelID>;
+    /**
+     * The label name.
+     */
     name: () => Promise<string>;
+    /**
+     * The label value.
+     */
     value: () => Promise<string>;
 }
 /**
@@ -1927,8 +2217,37 @@ export declare class ListTypeDef extends BaseClient {
      * A unique identifier for this ListTypeDef.
      */
     id: () => Promise<ListTypeDefID>;
+    /**
+     * The type of the elements in the list.
+     */
     elementTypeDef: () => TypeDef;
 }
+/**
+ * Module source that that originates from a path locally relative to an arbitrary directory.
+ */
+export declare class LocalModuleSource extends BaseClient {
+    private readonly _id?;
+    private readonly _rootSubpath?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: LocalModuleSourceID, _rootSubpath?: string);
+    /**
+     * A unique identifier for this LocalModuleSource.
+     */
+    id: () => Promise<LocalModuleSourceID>;
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory: () => Directory;
+    /**
+     * 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: () => Promise<string>;
+}
 /**
  * A Dagger module.
  */
@@ -1938,29 +2257,60 @@ export declare class Module_ extends BaseClient {
     private readonly _name?;
     private readonly _sdk?;
     private readonly _serve?;
-    private readonly _sourceDirectorySubpath?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void, _sourceDirectorySubpath?: string);
+    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void);
     /**
      * A unique identifier for this Module.
      */
     id: () => Promise<ModuleID>;
+    /**
+     * Modules used by this module.
+     */
     dependencies: () => Promise<Module_[]>;
-    dependencyConfig: () => Promise<string[]>;
+    /**
+     * The dependencies as configured by the module.
+     */
+    dependencyConfig: () => Promise<ModuleDependency[]>;
+    /**
+     * The doc string of the module, if any
+     */
     description: () => Promise<string>;
-    generatedCode: () => GeneratedCode;
+    /**
+     * The generated files and directories made on top of the module source's context directory.
+     */
+    generatedContextDiff: () => Directory;
+    /**
+     * The module source's context plus any configuration and source files created by codegen.
+     */
+    generatedContextDirectory: () => Directory;
     /**
      * Retrieves the module with the objects loaded via its SDK.
      */
     initialize: () => Module_;
+    /**
+     * Interfaces served by this module.
+     */
     interfaces: () => Promise<TypeDef[]>;
+    /**
+     * The name of the module
+     */
     name: () => Promise<string>;
+    /**
+     * Objects served by this module.
+     */
     objects: () => Promise<TypeDef[]>;
+    /**
+     * The container that runs the module's entrypoint. It will fail to execute if the module doesn't compile.
+     */
+    runtime: () => Container;
+    /**
+     * 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: () => Promise<string>;
     /**
      * Serve a module's API in the current session.
@@ -1968,8 +2318,15 @@ export declare class Module_ extends BaseClient {
      * Note: this can only be called once per session. In the future, it could return a stream or service to remove the side effect.
      */
     serve: () => Promise<Void>;
-    sourceDirectory: () => Directory;
-    sourceDirectorySubpath: () => Promise<string>;
+    /**
+     * The source for the module.
+     */
+    source: () => ModuleSource;
+    /**
+     * Retrieves the module with the given description
+     * @param description The description to set
+     */
+    withDescription: (description: string) => Module_;
     /**
      * This module plus the given Interface type and associated functions
      */
@@ -1979,15 +2336,10 @@ export declare class Module_ extends BaseClient {
      */
     withObject: (object: TypeDef) => Module_;
     /**
-     * Retrieves the module with basic configuration loaded, ready for initialization.
-     * @param directory The directory containing the module's source code.
-     * @param opts.subpath An optional subpath of the directory which contains the module's source code.
-     *
-     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
-     *
-     * If not set, the module source code is loaded from the root of the directory.
+     * Retrieves the module with basic configuration loaded if present.
+     * @param source The module source to initialize from.
      */
-    withSource: (directory: Directory, opts?: ModuleWithSourceOpts) => Module_;
+    withSource: (source: ModuleSource) => Module_;
     /**
      * Call the provided function with current Module.
      *
@@ -1996,30 +2348,152 @@ export declare class Module_ extends BaseClient {
     with: (arg: (param: Module_) => Module_) => Module_;
 }
 /**
- * Static configuration for a module (e.g. parsed contents of dagger.json)
+ * The configuration of dependency of a module.
  */
-export declare class ModuleConfig extends BaseClient {
+export declare class ModuleDependency extends BaseClient {
     private readonly _id?;
     private readonly _name?;
-    private readonly _root?;
-    private readonly _sdk?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: ModuleConfigID, _name?: string, _root?: string, _sdk?: string);
+    }, _id?: ModuleDependencyID, _name?: string);
+    /**
+     * A unique identifier for this ModuleDependency.
+     */
+    id: () => Promise<ModuleDependencyID>;
     /**
-     * A unique identifier for this ModuleConfig.
+     * The name of the dependency module.
      */
-    id: () => Promise<ModuleConfigID>;
-    dependencies: () => Promise<string[]>;
-    exclude: () => Promise<string[]>;
-    include: () => Promise<string[]>;
     name: () => Promise<string>;
-    root: () => Promise<string>;
-    sdk: () => Promise<string>;
+    /**
+     * The source for the dependency module.
+     */
+    source: () => ModuleSource;
+}
+/**
+ * The source needed to load and run a module, along with any metadata about the source such as versions/urls/etc.
+ */
+export declare class ModuleSource extends BaseClient {
+    private readonly _id?;
+    private readonly _asString?;
+    private readonly _configExists?;
+    private readonly _kind?;
+    private readonly _moduleName?;
+    private readonly _moduleOriginalName?;
+    private readonly _resolveContextPathFromCaller?;
+    private readonly _sourceRootSubpath?;
+    private readonly _sourceSubpath?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: ModuleSourceID, _asString?: string, _configExists?: boolean, _kind?: ModuleSourceKind, _moduleName?: string, _moduleOriginalName?: string, _resolveContextPathFromCaller?: string, _sourceRootSubpath?: string, _sourceSubpath?: string);
+    /**
+     * A unique identifier for this ModuleSource.
+     */
+    id: () => Promise<ModuleSourceID>;
+    /**
+     * If the source is a of kind git, the git source representation of it.
+     */
+    asGitSource: () => GitModuleSource;
+    /**
+     * If the source is of kind local, the local source representation of it.
+     */
+    asLocalSource: () => LocalModuleSource;
+    /**
+     * Load the source as a module. If this is a local source, the parent directory must have been provided during module source creation
+     */
+    asModule: () => Module_;
+    /**
+     * A human readable ref string representation of this module source.
+     */
+    asString: () => Promise<string>;
+    /**
+     * Returns whether the module source has a configuration file.
+     */
+    configExists: () => Promise<boolean>;
+    /**
+     * The directory containing everything needed to load load and use the module.
+     */
+    contextDirectory: () => Directory;
+    /**
+     * The dependencies of the module source. Includes dependencies from the configuration and any extras from withDependencies calls.
+     */
+    dependencies: () => Promise<ModuleDependency[]>;
+    /**
+     * 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: string) => Directory;
+    /**
+     * The kind of source (e.g. local, git, etc.)
+     */
+    kind: () => Promise<ModuleSourceKind>;
+    /**
+     * If set, the name of the module this source references, including any overrides at runtime by callers.
+     */
+    moduleName: () => Promise<string>;
+    /**
+     * The original name of the module this source references, as defined in the module configuration.
+     */
+    moduleOriginalName: () => Promise<string>;
+    /**
+     * The path to the module source's context directory on the caller's filesystem. Only valid for local sources.
+     */
+    resolveContextPathFromCaller: () => Promise<string>;
+    /**
+     * Resolve the provided module source arg as a dependency relative to this module source.
+     * @param dep The dependency module source to resolve.
+     */
+    resolveDependency: (dep: ModuleSource) => ModuleSource;
+    /**
+     * Load the source from its path on the caller's filesystem, including only needed+configured files and directories. Only valid for local sources.
+     */
+    resolveFromCaller: () => ModuleSource;
+    /**
+     * 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: () => Promise<string>;
+    /**
+     * The path relative to context of the module implementation source code.
+     */
+    sourceSubpath: () => Promise<string>;
+    /**
+     * 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: Directory) => ModuleSource;
+    /**
+     * Append the provided dependencies to the module source's dependency list.
+     * @param dependencies The dependencies to append.
+     */
+    withDependencies: (dependencies: ModuleDependency[]) => ModuleSource;
+    /**
+     * Update the module source with a new name.
+     * @param name The name to set.
+     */
+    withName: (name: string) => ModuleSource;
+    /**
+     * Update the module source with a new SDK.
+     * @param sdk The SDK to set.
+     */
+    withSDK: (sdk: string) => ModuleSource;
+    /**
+     * Update the module source with a new source subpath.
+     * @param path The path to set as the source subpath.
+     */
+    withSourceSubpath: (path: string) => ModuleSource;
+    /**
+     * Call the provided function with current ModuleSource.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: ModuleSource) => ModuleSource) => ModuleSource;
 }
 /**
  * A definition of a custom object defined in a Module.
@@ -2040,11 +2514,29 @@ export declare class ObjectTypeDef extends BaseClient {
      * A unique identifier for this ObjectTypeDef.
      */
     id: () => Promise<ObjectTypeDefID>;
+    /**
+     * The function used to construct new instances of this object, if any
+     */
     constructor_: () => Function_;
+    /**
+     * The doc string for the object, if any.
+     */
     description: () => Promise<string>;
+    /**
+     * Static fields defined on this object, if any.
+     */
     fields: () => Promise<FieldTypeDef[]>;
+    /**
+     * Functions defined on this object, if any.
+     */
     functions: () => Promise<Function_[]>;
+    /**
+     * The name of the object.
+     */
     name: () => Promise<string>;
+    /**
+     * If this ObjectTypeDef is associated with a Module, the name of the module. Unset otherwise.
+     */
     sourceModuleName: () => Promise<string>;
 }
 /**
@@ -2053,6 +2545,7 @@ export declare class ObjectTypeDef extends BaseClient {
 export declare class Port extends BaseClient {
     private readonly _id?;
     private readonly _description?;
+    private readonly _experimentalSkipHealthcheck?;
     private readonly _port?;
     private readonly _protocol?;
     /**
@@ -2061,13 +2554,26 @@ export declare class Port extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: PortID, _description?: string, _port?: number, _protocol?: NetworkProtocol);
+    }, _id?: PortID, _description?: string, _experimentalSkipHealthcheck?: boolean, _port?: number, _protocol?: NetworkProtocol);
     /**
      * A unique identifier for this Port.
      */
     id: () => Promise<PortID>;
+    /**
+     * The port description.
+     */
     description: () => Promise<string>;
+    /**
+     * Skip the health check when run as a service.
+     */
+    experimentalSkipHealthcheck: () => Promise<boolean>;
+    /**
+     * The port number.
+     */
     port: () => Promise<number>;
+    /**
+     * The transport layer protocol.
+     */
     protocol: () => Promise<NetworkProtocol>;
 }
 /**
@@ -2118,7 +2624,7 @@ export declare class Client extends BaseClient {
     /**
      * The module currently being served in the session, if any.
      */
-    currentModule: () => Module_;
+    currentModule: () => CurrentModule;
     /**
      * The TypeDef representations of the objects currently being served in the session.
      */
@@ -2177,6 +2683,10 @@ export declare class Client extends BaseClient {
      * Load a Container from its ID.
      */
     loadContainerFromID: (id: ContainerID) => Container;
+    /**
+     * Load a CurrentModule from its ID.
+     */
+    loadCurrentModuleFromID: (id: CurrentModuleID) => CurrentModule;
     /**
      * Load a Directory from its ID.
      */
@@ -2213,6 +2723,10 @@ export declare class Client extends BaseClient {
      * Load a GeneratedCode from its ID.
      */
     loadGeneratedCodeFromID: (id: GeneratedCodeID) => GeneratedCode;
+    /**
+     * Load a GitModuleSource from its ID.
+     */
+    loadGitModuleSourceFromID: (id: GitModuleSourceID) => GitModuleSource;
     /**
      * Load a GitRef from its ID.
      */
@@ -2225,6 +2739,10 @@ export declare class Client extends BaseClient {
      * Load a Host from its ID.
      */
     loadHostFromID: (id: HostID) => Host;
+    /**
+     * Load a InputTypeDef from its ID.
+     */
+    loadInputTypeDefFromID: (id: InputTypeDefID) => InputTypeDef;
     /**
      * Load a InterfaceTypeDef from its ID.
      */
@@ -2238,13 +2756,21 @@ export declare class Client extends BaseClient {
      */
     loadListTypeDefFromID: (id: ListTypeDefID) => ListTypeDef;
     /**
-     * Load a ModuleConfig from its ID.
+     * Load a LocalModuleSource from its ID.
      */
-    loadModuleConfigFromID: (id: ModuleConfigID) => ModuleConfig;
+    loadLocalModuleSourceFromID: (id: LocalModuleSourceID) => LocalModuleSource;
+    /**
+     * Load a ModuleDependency from its ID.
+     */
+    loadModuleDependencyFromID: (id: ModuleDependencyID) => ModuleDependency;
     /**
      * Load a Module from its ID.
      */
     loadModuleFromID: (id: ModuleID) => Module_;
+    /**
+     * Load a ModuleSource from its ID.
+     */
+    loadModuleSourceFromID: (id: ModuleSourceID) => ModuleSource;
     /**
      * Load a ObjectTypeDef from its ID.
      */
@@ -2265,6 +2791,10 @@ export declare class Client extends BaseClient {
      * Load a Socket from its ID.
      */
     loadSocketFromID: (id: SocketID) => Socket;
+    /**
+     * Load a Terminal from its ID.
+     */
+    loadTerminalFromID: (id: TerminalID) => Terminal;
     /**
      * Load a TypeDef from its ID.
      */
@@ -2274,9 +2804,17 @@ export declare class Client extends BaseClient {
      */
     module_: () => Module_;
     /**
-     * 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.
      */
-    moduleConfig: (sourceDirectory: Directory, opts?: ClientModuleConfigOpts) => ModuleConfig;
+    moduleDependency: (source: ModuleSource, opts?: ClientModuleDependencyOpts) => ModuleDependency;
+    /**
+     * 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.
+     */
+    moduleSource: (refString: string, opts?: ClientModuleSourceOpts) => ModuleSource;
     /**
      * Creates a named sub-pipeline.
      * @param name Name of the sub-pipeline.
@@ -2343,13 +2881,14 @@ export declare class Service extends BaseClient {
     private readonly _hostname?;
     private readonly _start?;
     private readonly _stop?;
+    private readonly _up?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: ServiceID, _endpoint?: string, _hostname?: string, _start?: ServiceID, _stop?: ServiceID);
+    }, _id?: ServiceID, _endpoint?: string, _hostname?: string, _start?: ServiceID, _stop?: ServiceID, _up?: Void);
     /**
      * A unique identifier for this Service.
      */
@@ -2380,8 +2919,17 @@ export declare class Service extends BaseClient {
     start: () => Promise<Service>;
     /**
      * Stop the service.
+     * @param opts.kill Immediately kill the service without waiting for a graceful exit
      */
-    stop: () => Promise<Service>;
+    stop: (opts?: ServiceStopOpts) => Promise<Service>;
+    /**
+     * 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: (opts?: ServiceUpOpts) => Promise<Void>;
 }
 /**
  * A Unix or TCP/IP socket that can be mounted into a container.
@@ -2400,6 +2948,28 @@ export declare class Socket extends BaseClient {
      */
     id: () => Promise<SocketID>;
 }
+/**
+ * An interactive terminal that clients can connect to.
+ */
+export declare class Terminal extends BaseClient {
+    private readonly _id?;
+    private readonly _websocketEndpoint?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: TerminalID, _websocketEndpoint?: string);
+    /**
+     * A unique identifier for this Terminal.
+     */
+    id: () => Promise<TerminalID>;
+    /**
+     * An http endpoint at which this terminal can be connected to over a websocket.
+     */
+    websocketEndpoint: () => Promise<string>;
+}
 /**
  * A definition of a parameter or return type in a Module.
  */
@@ -2418,10 +2988,29 @@ export declare class TypeDef extends BaseClient {
      * A unique identifier for this TypeDef.
      */
     id: () => Promise<TypeDefID>;
+    /**
+     * If kind is INPUT, the input-specific type definition. If kind is not INPUT, this will be null.
+     */
+    asInput: () => InputTypeDef;
+    /**
+     * If kind is INTERFACE, the interface-specific type definition. If kind is not INTERFACE, this will be null.
+     */
     asInterface: () => InterfaceTypeDef;
+    /**
+     * If kind is LIST, the list-specific type definition. If kind is not LIST, this will be null.
+     */
     asList: () => ListTypeDef;
+    /**
+     * If kind is OBJECT, the object-specific type definition. If kind is not OBJECT, this will be null.
+     */
     asObject: () => ObjectTypeDef;
+    /**
+     * The kind of type this is (e.g. primitive, list, object).
+     */
     kind: () => Promise<TypeDefKind>;
+    /**
+     * Whether this type can be set to null. Defaults to false.
+     */
     optional: () => Promise<boolean>;
     /**
      * Adds a function for constructing a new instance of an Object TypeDef, failing if the type is not an object.