@dagger.io/dagger 0.11.8 → 0.12.0

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

@@ -225,9 +225,13 @@ export type ContainerWithEnvVariableOpts = {
 };
 export type ContainerWithExecOpts = {
     /**
-     * If the container has an entrypoint, ignore it for args rather than using it to wrap them.
+     * DEPRECATED: For true this can be removed. For false, use `useEntrypoint` instead.
      */
     skipEntrypoint?: boolean;
+    /**
+     * If the container has an entrypoint, prepend it to the args.
+     */
+    useEntrypoint?: boolean;
     /**
      * Content to write to the command's standard input before closing (e.g., "Hello world").
      */
@@ -350,10 +354,6 @@ export type ContainerWithMountedSecretOpts = {
     mode?: number;
 };
 export type ContainerWithNewFileOpts = {
-    /**
-     * Content of the file to write (e.g., "Hello world!").
-     */
-    contents?: string;
     /**
      * Permission given to the written file (e.g., 0600).
      */
@@ -411,6 +411,30 @@ export type CurrentModuleWorkdirOpts = {
 export type CurrentModuleID = string & {
     __CurrentModuleID: never;
 };
+/**
+ * The `DaggerEngineCacheEntryID` scalar type represents an identifier for an object of type DaggerEngineCacheEntry.
+ */
+export type DaggerEngineCacheEntryID = string & {
+    __DaggerEngineCacheEntryID: never;
+};
+/**
+ * The `DaggerEngineCacheEntrySetID` scalar type represents an identifier for an object of type DaggerEngineCacheEntrySet.
+ */
+export type DaggerEngineCacheEntrySetID = string & {
+    __DaggerEngineCacheEntrySetID: never;
+};
+/**
+ * The `DaggerEngineCacheID` scalar type represents an identifier for an object of type DaggerEngineCache.
+ */
+export type DaggerEngineCacheID = string & {
+    __DaggerEngineCacheID: never;
+};
+/**
+ * The `DaggerEngineID` scalar type represents an identifier for an object of type DaggerEngine.
+ */
+export type DaggerEngineID = string & {
+    __DaggerEngineID: never;
+};
 export type DirectoryAsModuleOpts = {
     /**
      * An optional subpath of the directory which contains the module's configuration file.
@@ -420,6 +444,10 @@ export type DirectoryAsModuleOpts = {
      * If not set, the module source code is loaded from the root of the directory.
      */
     sourceRootPath?: string;
+    /**
+     * The engine version to upgrade to.
+     */
+    engineVersion?: string;
 };
 export type DirectoryDockerBuildOpts = {
     /**
@@ -467,6 +495,26 @@ export type DirectoryPipelineOpts = {
      */
     labels?: PipelineLabel[];
 };
+export type DirectoryTerminalOpts = {
+    /**
+     * If set, override the container's default terminal command and invoke these command arguments instead.
+     */
+    cmd?: string[];
+    /**
+     * Provides Dagger access to the executed command.
+     *
+     * Do not use this option unless you trust the command being executed; the command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
+     */
+    experimentalPrivilegedNesting?: boolean;
+    /**
+     * Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
+     */
+    insecureRootCapabilities?: boolean;
+    /**
+     * If set, override the default container used for the terminal.
+     */
+    container?: Container;
+};
 export type DirectoryWithDirectoryOpts = {
     /**
      * Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
@@ -507,6 +555,18 @@ export type DirectoryWithNewFileOpts = {
 export type DirectoryID = string & {
     __DirectoryID: never;
 };
+/**
+ * The `EnumTypeDefID` scalar type represents an identifier for an object of type EnumTypeDef.
+ */
+export type EnumTypeDefID = string & {
+    __EnumTypeDefID: never;
+};
+/**
+ * The `EnumValueTypeDefID` scalar type represents an identifier for an object of type EnumValueTypeDef.
+ */
+export type EnumValueTypeDefID = string & {
+    __EnumValueTypeDefID: never;
+};
 /**
  * The `EnvVariableID` scalar type represents an identifier for an object of type EnvVariable.
  */
@@ -577,22 +637,18 @@ export type GeneratedCodeID = string & {
 export type GitModuleSourceID = string & {
     __GitModuleSourceID: never;
 };
-export type GitRefTreeOpts = {
-    /**
-     * DEPRECATED: This option should be passed to `git` instead.
-     */
-    sshKnownHosts?: string;
-    /**
-     * DEPRECATED: This option should be passed to `git` instead.
-     */
-    sshAuthSocket?: Socket;
-};
 /**
  * The `GitRefID` scalar type represents an identifier for an object of type GitRef.
  */
 export type GitRefID = string & {
     __GitRefID: never;
 };
+export type GitRepositoryTagsOpts = {
+    /**
+     * Glob patterns (e.g., "refs/tags/v*").
+     */
+    patterns?: string[];
+};
 /**
  * The `GitRepositoryID` scalar type represents an identifier for an object of type GitRepository.
  */
@@ -699,6 +755,12 @@ export type ListTypeDefID = string & {
 export type LocalModuleSourceID = string & {
     __LocalModuleSourceID: never;
 };
+export type ModuleWithSourceOpts = {
+    /**
+     * The engine version to upgrade to.
+     */
+    engineVersion?: string;
+};
 /**
  * The `ModuleDependencyID` scalar type represents an identifier for an object of type ModuleDependency.
  */
@@ -711,6 +773,12 @@ export type ModuleDependencyID = string & {
 export type ModuleID = string & {
     __ModuleID: never;
 };
+export type ModuleSourceAsModuleOpts = {
+    /**
+     * The engine version to upgrade to.
+     */
+    engineVersion?: string;
+};
 export type ModuleSourceResolveDirectoryFromCallerOpts = {
     /**
      * If set, the name of the view to apply to the path.
@@ -788,21 +856,11 @@ export type PortID = string & {
     __PortID: never;
 };
 export type ClientContainerOpts = {
-    /**
-     * DEPRECATED: Use `loadContainerFromID` instead.
-     */
-    id?: ContainerID;
     /**
      * Platform to initialize the container with.
      */
     platform?: Platform;
 };
-export type ClientDirectoryOpts = {
-    /**
-     * DEPRECATED: Use `loadDirectoryFromID` instead.
-     */
-    id?: DirectoryID;
-};
 export type ClientGitOpts = {
     /**
      * Set to true to keep .git directory.
@@ -910,6 +968,18 @@ export type SocketID = string & {
 export type TerminalID = string & {
     __TerminalID: never;
 };
+export type TypeDefWithEnumOpts = {
+    /**
+     * A doc string for the enum, if any
+     */
+    description?: string;
+};
+export type TypeDefWithEnumValueOpts = {
+    /**
+     * A doc string for the value, if any
+     */
+    description?: string;
+};
 export type TypeDefWithFieldOpts = {
     /**
      * A doc string for the field, if any
@@ -939,6 +1009,12 @@ export declare enum TypeDefKind {
      * A boolean value.
      */
     BooleanKind = "BOOLEAN_KIND",
+    /**
+     * A GraphQL enum type and its values
+     *
+     * Always paired with an EnumTypeDef.
+     */
+    EnumKind = "ENUM_KIND",
     /**
      * A graphql input type, used only when representing the core API via TypeDefs.
      */
@@ -1033,7 +1109,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, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
+    }, _id?: ContainerID, _envVariable?: string, _export?: string, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
     /**
      * A unique identifier for this Container.
      */
@@ -1114,8 +1190,6 @@ export declare class Container extends BaseClient {
     /**
      * Writes the container as an OCI tarball to the destination file path on the host.
      *
-     * Return true on success.
-     *
      * It can also export platform variants.
      * @param path Host's destination path (e.g., "./tarball").
      *
@@ -1130,7 +1204,7 @@ export declare class Container extends BaseClient {
      *
      * Defaults to OCI, which is largely compatible with most recent container runtimes, but Docker may be needed for older runtimes without OCI support.
      */
-    export: (path: string, opts?: ContainerExportOpts) => Promise<boolean>;
+    export: (path: string, opts?: ContainerExportOpts) => Promise<string>;
     /**
      * Retrieves the list of exposed ports.
      *
@@ -1228,14 +1302,14 @@ export declare class Container extends BaseClient {
      */
     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).
+     * Opens 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.
      * @param opts.experimentalPrivilegedNesting Provides Dagger access to the executed command.
      *
      * Do not use this option unless you trust the command being executed; the command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      * @param opts.insecureRootCapabilities Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
      */
-    terminal: (opts?: ContainerTerminalOpts) => Terminal;
+    terminal: (opts?: ContainerTerminalOpts) => Container;
     /**
      * Retrieves the user to be set for all commands.
      */
@@ -1285,7 +1359,8 @@ export declare class Container extends BaseClient {
      * @param args Command to run instead of the container's default command (e.g., ["run", "main.go"]).
      *
      * If empty, the container's default command is used.
-     * @param opts.skipEntrypoint If the container has an entrypoint, ignore it for args rather than using it to wrap them.
+     * @param opts.skipEntrypoint DEPRECATED: For true this can be removed. For false, use `useEntrypoint` instead.
+     * @param opts.useEntrypoint If the container has an entrypoint, prepend it to the args.
      * @param opts.stdin Content to write to the command's standard input before closing (e.g., "Hello world").
      * @param opts.redirectStdout Redirect the command's standard output to a file in the container (e.g., "/tmp/stdout").
      * @param opts.redirectStderr Redirect the command's standard error to a file in the container (e.g., "/tmp/stderr").
@@ -1402,7 +1477,7 @@ export declare class Container extends BaseClient {
     /**
      * Retrieves this container plus a new file written at the given path.
      * @param path Location of the written file (e.g., "/tmp/file.txt").
-     * @param opts.contents Content of the file to write (e.g., "Hello world!").
+     * @param contents Content of the file to write (e.g., "Hello world!").
      * @param opts.permissions Permission given to the written file (e.g., 0600).
      * @param opts.owner A user:group to set for the file.
      *
@@ -1410,7 +1485,7 @@ export declare class Container extends BaseClient {
      *
      * If the group is omitted, it defaults to the same as the user.
      */
-    withNewFile: (path: string, opts?: ContainerWithNewFileOpts) => Container;
+    withNewFile: (path: string, contents: string, opts?: ContainerWithNewFileOpts) => Container;
     /**
      * Retrieves this container with a registry authentication for a given address.
      * @param address Registry's address to bind the authentication to.
@@ -1588,6 +1663,131 @@ export declare class CurrentModule extends BaseClient {
      */
     workdirFile: (path: string) => File;
 }
+/**
+ * The Dagger engine configuration and state
+ */
+export declare class DaggerEngine extends BaseClient {
+    private readonly _id?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: DaggerEngineID);
+    /**
+     * A unique identifier for this DaggerEngine.
+     */
+    id: () => Promise<DaggerEngineID>;
+    /**
+     * The local (on-disk) cache for the Dagger engine
+     */
+    localCache: () => DaggerEngineCache;
+}
+/**
+ * A cache storage for the Dagger engine
+ */
+export declare class DaggerEngineCache extends BaseClient {
+    private readonly _id?;
+    private readonly _keepBytes?;
+    private readonly _prune?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: DaggerEngineCacheID, _keepBytes?: number, _prune?: Void);
+    /**
+     * A unique identifier for this DaggerEngineCache.
+     */
+    id: () => Promise<DaggerEngineCacheID>;
+    /**
+     * The current set of entries in the cache
+     */
+    entrySet: () => DaggerEngineCacheEntrySet;
+    /**
+     * The maximum bytes to keep in the cache without pruning, after which automatic pruning may kick in.
+     */
+    keepBytes: () => Promise<number>;
+    /**
+     * Prune the cache of releaseable entries
+     */
+    prune: () => Promise<void>;
+}
+/**
+ * An individual cache entry in a cache entry set
+ */
+export declare class DaggerEngineCacheEntry extends BaseClient {
+    private readonly _id?;
+    private readonly _activelyUsed?;
+    private readonly _createdTimeUnixNano?;
+    private readonly _description?;
+    private readonly _diskSpaceBytes?;
+    private readonly _mostRecentUseTimeUnixNano?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: DaggerEngineCacheEntryID, _activelyUsed?: boolean, _createdTimeUnixNano?: number, _description?: string, _diskSpaceBytes?: number, _mostRecentUseTimeUnixNano?: number);
+    /**
+     * A unique identifier for this DaggerEngineCacheEntry.
+     */
+    id: () => Promise<DaggerEngineCacheEntryID>;
+    /**
+     * Whether the cache entry is actively being used.
+     */
+    activelyUsed: () => Promise<boolean>;
+    /**
+     * The time the cache entry was created, in Unix nanoseconds.
+     */
+    createdTimeUnixNano: () => Promise<number>;
+    /**
+     * The description of the cache entry.
+     */
+    description: () => Promise<string>;
+    /**
+     * The disk space used by the cache entry.
+     */
+    diskSpaceBytes: () => Promise<number>;
+    /**
+     * The most recent time the cache entry was used, in Unix nanoseconds.
+     */
+    mostRecentUseTimeUnixNano: () => Promise<number>;
+}
+/**
+ * A set of cache entries returned by a query to a cache
+ */
+export declare class DaggerEngineCacheEntrySet extends BaseClient {
+    private readonly _id?;
+    private readonly _diskSpaceBytes?;
+    private readonly _entryCount?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: DaggerEngineCacheEntrySetID, _diskSpaceBytes?: number, _entryCount?: number);
+    /**
+     * A unique identifier for this DaggerEngineCacheEntrySet.
+     */
+    id: () => Promise<DaggerEngineCacheEntrySetID>;
+    /**
+     * The total disk space used by the cache entries in this set.
+     */
+    diskSpaceBytes: () => Promise<number>;
+    /**
+     * The list of individual cache entries in the set
+     */
+    entries: () => Promise<DaggerEngineCacheEntry[]>;
+    /**
+     * The number of cache entries in this set.
+     */
+    entryCount: () => Promise<number>;
+}
 /**
  * A directory.
  */
@@ -1601,7 +1801,7 @@ export declare class Directory extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: DirectoryID, _export?: boolean, _sync?: DirectoryID);
+    }, _id?: DirectoryID, _export?: string, _sync?: DirectoryID);
     /**
      * A unique identifier for this Directory.
      */
@@ -1613,6 +1813,7 @@ export declare class Directory extends BaseClient {
      * 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.
+     * @param opts.engineVersion The engine version to upgrade to.
      */
     asModule: (opts?: DirectoryAsModuleOpts) => Module_;
     /**
@@ -1646,7 +1847,7 @@ export declare class Directory extends BaseClient {
      * @param path Location of the copied directory (e.g., "logs/").
      * @param opts.wipe If true, then the host directory will be wiped clean before exporting so that it exactly matches the directory being exported; this means it will delete any files on the host that aren't in the exported dir. If false (the default), the contents of the directory will be merged with any existing contents of the host directory, leaving any existing files on the host that aren't in the exported directory alone.
      */
-    export: (path: string, opts?: DirectoryExportOpts) => Promise<boolean>;
+    export: (path: string, opts?: DirectoryExportOpts) => Promise<string>;
     /**
      * Retrieves a file at the given path.
      * @param path Location of the file to retrieve (e.g., "README.md").
@@ -1668,6 +1869,16 @@ export declare class Directory extends BaseClient {
      * Force evaluation in the engine.
      */
     sync: () => Promise<Directory>;
+    /**
+     * Opens an interactive terminal in new container with this directory mounted inside.
+     * @param opts.cmd If set, override the container's default terminal command and invoke these command arguments instead.
+     * @param opts.experimentalPrivilegedNesting Provides Dagger access to the executed command.
+     *
+     * Do not use this option unless you trust the command being executed; the command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
+     * @param opts.insecureRootCapabilities Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
+     * @param opts.container If set, override the default container used for the terminal.
+     */
+    terminal: (opts?: DirectoryTerminalOpts) => Directory;
     /**
      * Retrieves this directory plus a directory written at the given path.
      * @param path Location of the written directory (e.g., "/src/").
@@ -1727,6 +1938,69 @@ export declare class Directory extends BaseClient {
      */
     with: (arg: (param: Directory) => Directory) => Directory;
 }
+/**
+ * A definition of a custom enum defined in a Module.
+ */
+export declare class EnumTypeDef extends BaseClient {
+    private readonly _id?;
+    private readonly _description?;
+    private readonly _name?;
+    private readonly _sourceModuleName?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: EnumTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
+    /**
+     * A unique identifier for this EnumTypeDef.
+     */
+    id: () => Promise<EnumTypeDefID>;
+    /**
+     * A doc string for the enum, if any.
+     */
+    description: () => Promise<string>;
+    /**
+     * The name of the enum.
+     */
+    name: () => Promise<string>;
+    /**
+     * If this EnumTypeDef is associated with a Module, the name of the module. Unset otherwise.
+     */
+    sourceModuleName: () => Promise<string>;
+    /**
+     * The values of the enum.
+     */
+    values: () => Promise<EnumValueTypeDef[]>;
+}
+/**
+ * A definition of a value in a custom enum defined in a Module.
+ */
+export declare class EnumValueTypeDef extends BaseClient {
+    private readonly _id?;
+    private readonly _description?;
+    private readonly _name?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        ctx: Context;
+    }, _id?: EnumValueTypeDefID, _description?: string, _name?: string);
+    /**
+     * A unique identifier for this EnumValueTypeDef.
+     */
+    id: () => Promise<EnumValueTypeDefID>;
+    /**
+     * A doc string for the enum value, if any.
+     */
+    description: () => Promise<string>;
+    /**
+     * The name of the enum value.
+     */
+    name: () => Promise<string>;
+}
 /**
  * An environment variable name and value.
  */
@@ -1803,7 +2077,7 @@ export declare class File extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _id?: FileID, _contents?: string, _export?: boolean, _name?: string, _size?: number, _sync?: FileID);
+    }, _id?: FileID, _contents?: string, _export?: string, _name?: string, _size?: number, _sync?: FileID);
     /**
      * A unique identifier for this File.
      */
@@ -1817,7 +2091,7 @@ export declare class File extends BaseClient {
      * @param path Location of the written directory (e.g., "output.txt").
      * @param opts.allowParentDirPath If allowParentDirPath is true, the path argument can be a directory path, in which case the file will be created in that directory.
      */
-    export: (path: string, opts?: FileExportOpts) => Promise<boolean>;
+    export: (path: string, opts?: FileExportOpts) => Promise<string>;
     /**
      * Retrieves the name of the file.
      */
@@ -1983,7 +2257,7 @@ export declare class FunctionCall extends BaseClient {
      * Set the return value of the function call to the provided value.
      * @param value JSON serialization of the return value.
      */
-    returnValue: (value: JSON) => Promise<Void>;
+    returnValue: (value: JSON) => Promise<void>;
 }
 /**
  * A value passed as a named argument to a function call.
@@ -2129,10 +2403,8 @@ export declare class GitRef extends BaseClient {
     commit: () => Promise<string>;
     /**
      * The filesystem tree at this ref.
-     * @param opts.sshKnownHosts DEPRECATED: This option should be passed to `git` instead.
-     * @param opts.sshAuthSocket DEPRECATED: This option should be passed to `git` instead.
      */
-    tree: (opts?: GitRefTreeOpts) => Directory;
+    tree: () => Directory;
 }
 /**
  * A git repository.
@@ -2174,6 +2446,11 @@ export declare class GitRepository extends BaseClient {
      * @param name Tag's name (e.g., "v0.3.9").
      */
     tag: (name: string) => GitRef;
+    /**
+     * tags that match any of the given glob patterns.
+     * @param opts.patterns Glob patterns (e.g., "refs/tags/v*").
+     */
+    tags: (opts?: GitRepositoryTagsOpts) => Promise<string[]>;
     /**
      * Header to authenticate the remote with.
      * @param header Secret used to populate the Authorization HTTP header
@@ -2429,6 +2706,10 @@ export declare class Module_ extends BaseClient {
      * The doc string of the module, if any
      */
     description: () => Promise<string>;
+    /**
+     * Enumerations served by this module.
+     */
+    enums: () => Promise<TypeDef[]>;
     /**
      * The generated files and directories made on top of the module source's context directory.
      */
@@ -2466,7 +2747,7 @@ 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>;
+    serve: () => Promise<void>;
     /**
      * The source for the module.
      */
@@ -2476,6 +2757,10 @@ export declare class Module_ extends BaseClient {
      * @param description The description to set
      */
     withDescription: (description: string) => Module_;
+    /**
+     * This module plus the given Enum type and associated values
+     */
+    withEnum: (enum_: TypeDef) => Module_;
     /**
      * This module plus the given Interface type and associated functions
      */
@@ -2487,8 +2772,9 @@ export declare class Module_ extends BaseClient {
     /**
      * Retrieves the module with basic configuration loaded if present.
      * @param source The module source to initialize from.
+     * @param opts.engineVersion The engine version to upgrade to.
      */
-    withSource: (source: ModuleSource) => Module_;
+    withSource: (source: ModuleSource, opts?: ModuleWithSourceOpts) => Module_;
     /**
      * Call the provided function with current Module.
      *
@@ -2556,8 +2842,9 @@ export declare class ModuleSource extends BaseClient {
     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
+     * @param opts.engineVersion The engine version to upgrade to.
      */
-    asModule: () => Module_;
+    asModule: (opts?: ModuleSourceAsModuleOpts) => Module_;
     /**
      * A human readable ref string representation of this module source.
      */
@@ -2776,7 +3063,6 @@ export declare class Port extends BaseClient {
  * The root of the DAG.
  */
 export declare class Client extends BaseClient {
-    private readonly _checkVersionCompatibility?;
     private readonly _defaultPlatform?;
     private readonly _version?;
     /**
@@ -2785,7 +3071,7 @@ export declare class Client extends BaseClient {
     constructor(parent?: {
         queryTree?: QueryTree[];
         ctx: Context;
-    }, _checkVersionCompatibility?: boolean, _defaultPlatform?: Platform, _version?: string);
+    }, _defaultPlatform?: Platform, _version?: string);
     /**
      * Get the Raw GraphQL client.
      */
@@ -2808,16 +3094,10 @@ export declare class Client extends BaseClient {
      * @param key A string identifier to target this cache volume (e.g., "modules-cache").
      */
     cacheVolume: (key: string) => CacheVolume;
-    /**
-     * Checks if the current Dagger Engine is compatible with an SDK's required version.
-     * @param version Version required by the SDK.
-     */
-    checkVersionCompatibility: (version: string) => Promise<boolean>;
     /**
      * Creates a scratch container.
      *
      * Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.
-     * @param opts.id DEPRECATED: Use `loadContainerFromID` instead.
      * @param opts.platform Platform to initialize the container with.
      */
     container: (opts?: ClientContainerOpts) => Container;
@@ -2835,19 +3115,18 @@ export declare class Client extends BaseClient {
      * The TypeDef representations of the objects currently being served in the session.
      */
     currentTypeDefs: () => Promise<TypeDef[]>;
+    /**
+     * The Dagger engine container configuration and state
+     */
+    daggerEngine: () => DaggerEngine;
     /**
      * The default platform of the engine.
      */
     defaultPlatform: () => Promise<Platform>;
     /**
      * Creates an empty directory.
-     * @param opts.id DEPRECATED: Use `loadDirectoryFromID` instead.
      */
-    directory: (opts?: ClientDirectoryOpts) => Directory;
-    /**
-     * @deprecated Use loadFileFromID instead.
-     */
-    file: (id: FileID) => File;
+    directory: () => Directory;
     /**
      * Creates a function.
      * @param name Name of the function, in its original format from the implementation language.
@@ -2893,10 +3172,34 @@ export declare class Client extends BaseClient {
      * Load a CurrentModule from its ID.
      */
     loadCurrentModuleFromID: (id: CurrentModuleID) => CurrentModule;
+    /**
+     * Load a DaggerEngineCacheEntry from its ID.
+     */
+    loadDaggerEngineCacheEntryFromID: (id: DaggerEngineCacheEntryID) => DaggerEngineCacheEntry;
+    /**
+     * Load a DaggerEngineCacheEntrySet from its ID.
+     */
+    loadDaggerEngineCacheEntrySetFromID: (id: DaggerEngineCacheEntrySetID) => DaggerEngineCacheEntrySet;
+    /**
+     * Load a DaggerEngineCache from its ID.
+     */
+    loadDaggerEngineCacheFromID: (id: DaggerEngineCacheID) => DaggerEngineCache;
+    /**
+     * Load a DaggerEngine from its ID.
+     */
+    loadDaggerEngineFromID: (id: DaggerEngineID) => DaggerEngine;
     /**
      * Load a Directory from its ID.
      */
     loadDirectoryFromID: (id: DirectoryID) => Directory;
+    /**
+     * Load a EnumTypeDef from its ID.
+     */
+    loadEnumTypeDefFromID: (id: EnumTypeDefID) => EnumTypeDef;
+    /**
+     * Load a EnumValueTypeDef from its ID.
+     */
+    loadEnumValueTypeDefFromID: (id: EnumValueTypeDefID) => EnumValueTypeDef;
     /**
      * Load a EnvVariable from its ID.
      */
@@ -3048,11 +3351,6 @@ export declare class Client extends BaseClient {
      * @param plaintext The plaintext of the secret
      */
     setSecret: (name: string, plaintext: string) => Secret;
-    /**
-     * Loads a socket by its ID.
-     * @deprecated Use loadSocketFromID instead.
-     */
-    socket: (id: SocketID) => Socket;
     /**
      * Create a new TypeDef.
      */
@@ -3184,7 +3482,7 @@ export declare class Service extends BaseClient {
      * 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>;
+    up: (opts?: ServiceUpOpts) => Promise<void>;
 }
 /**
  * A Unix or TCP/IP socket that can be mounted into a container.
@@ -3208,22 +3506,17 @@ export declare class Socket extends BaseClient {
  */
 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);
+    }, _id?: TerminalID);
     /**
      * 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.
@@ -3243,6 +3536,10 @@ export declare class TypeDef extends BaseClient {
      * A unique identifier for this TypeDef.
      */
     id: () => Promise<TypeDefID>;
+    /**
+     * If kind is ENUM, the enum-specific type definition. If kind is not ENUM, this will be null.
+     */
+    asEnum: () => EnumTypeDef;
     /**
      * If kind is INPUT, the input-specific type definition. If kind is not INPUT, this will be null.
      */
@@ -3275,6 +3572,20 @@ export declare class TypeDef extends BaseClient {
      * Adds a function for constructing a new instance of an Object TypeDef, failing if the type is not an object.
      */
     withConstructor: (function_: Function_) => TypeDef;
+    /**
+     * Returns a TypeDef of kind Enum with the provided name.
+     *
+     * Note that an enum's values may be omitted if the intent is only to refer to an enum. This is how functions are able to return their own, or any other circular reference.
+     * @param name The name of the enum
+     * @param opts.description A doc string for the enum, if any
+     */
+    withEnum: (name: string, opts?: TypeDefWithEnumOpts) => TypeDef;
+    /**
+     * Adds a static value for an Enum TypeDef, failing if the type is not an enum.
+     * @param value The name of the value in the enum
+     * @param opts.description A doc string for the value, if any
+     */
+    withEnumValue: (value: string, opts?: TypeDefWithEnumValueOpts) => TypeDef;
     /**
      * Adds a static field for an Object TypeDef, failing if the type is not an object.
      * @param name The name of the field in the object