@dagger.io/dagger 0.11.9 → 0.12.1

package/dist/api/client.gen.js

@@ -82,6 +82,12 @@ export var TypeDefKind;
      * A boolean value.
      */
     TypeDefKind["BooleanKind"] = "BOOLEAN_KIND";
+    /**
+     * A GraphQL enum type and its values
+     *
+     * Always paired with an EnumTypeDef.
+     */
+    TypeDefKind["EnumKind"] = "ENUM_KIND";
     /**
      * A graphql input type, used only when representing the core API via TypeDefs.
      */
@@ -391,8 +397,6 @@ export 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").
      *
@@ -692,16 +696,24 @@ export class Container extends BaseClient {
      * It doesn't run the default command if no exec has been set.
      */
     sync = async () => {
-        await computeQuery([
+        const response = await computeQuery([
             ...this._queryTree,
             {
                 operation: "sync",
             },
         ], await this._ctx.connection());
-        return this;
+        return new Container({
+            queryTree: [
+                {
+                    operation: "loadContainerFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
-     * 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.
      *
@@ -709,7 +721,7 @@ export class Container extends BaseClient {
      * @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) => {
-        return new Terminal({
+        return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
@@ -835,7 +847,8 @@ export 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").
@@ -1078,7 +1091,7 @@ export 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.
      *
@@ -1086,13 +1099,13 @@ export class Container extends BaseClient {
      *
      * If the group is omitted, it defaults to the same as the user.
      */
-    withNewFile = (path, opts) => {
+    withNewFile = (path, contents, opts) => {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewFile",
-                    args: { path, ...opts },
+                    args: { path, contents, ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -1573,6 +1586,321 @@ export class CurrentModule extends BaseClient {
         });
     };
 }
+/**
+ * The Dagger engine configuration and state
+ */
+export class DaggerEngine extends BaseClient {
+    _id = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id) {
+        super(parent);
+        this._id = _id;
+    }
+    /**
+     * A unique identifier for this DaggerEngine.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The local (on-disk) cache for the Dagger engine
+     */
+    localCache = () => {
+        return new DaggerEngineCache({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "localCache",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+}
+/**
+ * A cache storage for the Dagger engine
+ */
+export class DaggerEngineCache extends BaseClient {
+    _id = undefined;
+    _keepBytes = undefined;
+    _prune = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _keepBytes, _prune) {
+        super(parent);
+        this._id = _id;
+        this._keepBytes = _keepBytes;
+        this._prune = _prune;
+    }
+    /**
+     * A unique identifier for this DaggerEngineCache.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The current set of entries in the cache
+     */
+    entrySet = () => {
+        return new DaggerEngineCacheEntrySet({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "entrySet",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * The maximum bytes to keep in the cache without pruning, after which automatic pruning may kick in.
+     */
+    keepBytes = async () => {
+        if (this._keepBytes) {
+            return this._keepBytes;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "keepBytes",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Prune the cache of releaseable entries
+     */
+    prune = async () => {
+        if (this._prune) {
+            return;
+        }
+        await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "prune",
+            },
+        ], await this._ctx.connection());
+    };
+}
+/**
+ * An individual cache entry in a cache entry set
+ */
+export class DaggerEngineCacheEntry extends BaseClient {
+    _id = undefined;
+    _activelyUsed = undefined;
+    _createdTimeUnixNano = undefined;
+    _description = undefined;
+    _diskSpaceBytes = undefined;
+    _mostRecentUseTimeUnixNano = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _activelyUsed, _createdTimeUnixNano, _description, _diskSpaceBytes, _mostRecentUseTimeUnixNano) {
+        super(parent);
+        this._id = _id;
+        this._activelyUsed = _activelyUsed;
+        this._createdTimeUnixNano = _createdTimeUnixNano;
+        this._description = _description;
+        this._diskSpaceBytes = _diskSpaceBytes;
+        this._mostRecentUseTimeUnixNano = _mostRecentUseTimeUnixNano;
+    }
+    /**
+     * A unique identifier for this DaggerEngineCacheEntry.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * Whether the cache entry is actively being used.
+     */
+    activelyUsed = async () => {
+        if (this._activelyUsed) {
+            return this._activelyUsed;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "activelyUsed",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The time the cache entry was created, in Unix nanoseconds.
+     */
+    createdTimeUnixNano = async () => {
+        if (this._createdTimeUnixNano) {
+            return this._createdTimeUnixNano;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "createdTimeUnixNano",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The description of the cache entry.
+     */
+    description = async () => {
+        if (this._description) {
+            return this._description;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "description",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The disk space used by the cache entry.
+     */
+    diskSpaceBytes = async () => {
+        if (this._diskSpaceBytes) {
+            return this._diskSpaceBytes;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "diskSpaceBytes",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The most recent time the cache entry was used, in Unix nanoseconds.
+     */
+    mostRecentUseTimeUnixNano = async () => {
+        if (this._mostRecentUseTimeUnixNano) {
+            return this._mostRecentUseTimeUnixNano;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "mostRecentUseTimeUnixNano",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
+/**
+ * A set of cache entries returned by a query to a cache
+ */
+export class DaggerEngineCacheEntrySet extends BaseClient {
+    _id = undefined;
+    _diskSpaceBytes = undefined;
+    _entryCount = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _diskSpaceBytes, _entryCount) {
+        super(parent);
+        this._id = _id;
+        this._diskSpaceBytes = _diskSpaceBytes;
+        this._entryCount = _entryCount;
+    }
+    /**
+     * A unique identifier for this DaggerEngineCacheEntrySet.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The total disk space used by the cache entries in this set.
+     */
+    diskSpaceBytes = async () => {
+        if (this._diskSpaceBytes) {
+            return this._diskSpaceBytes;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "diskSpaceBytes",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The list of individual cache entries in the set
+     */
+    entries = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "entries",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new DaggerEngineCacheEntry({
+            queryTree: [
+                {
+                    operation: "loadDaggerEngineCacheEntryFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
+    /**
+     * The number of cache entries in this set.
+     */
+    entryCount = async () => {
+        if (this._entryCount) {
+            return this._entryCount;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "entryCount",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * A directory.
  */
@@ -1611,6 +1939,7 @@ export 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) => {
         return new Module_({
@@ -1762,13 +2091,42 @@ export class Directory extends BaseClient {
      * Force evaluation in the engine.
      */
     sync = async () => {
-        await computeQuery([
+        const response = await computeQuery([
             ...this._queryTree,
             {
                 operation: "sync",
             },
         ], await this._ctx.connection());
-        return this;
+        return new Directory({
+            queryTree: [
+                {
+                    operation: "loadDirectoryFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * 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) => {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "terminal",
+                    args: { ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * Retrieves this directory plus a directory written at the given path.
@@ -1919,6 +2277,170 @@ export class Directory extends BaseClient {
         return arg(this);
     };
 }
+/**
+ * A definition of a custom enum defined in a Module.
+ */
+export class EnumTypeDef extends BaseClient {
+    _id = undefined;
+    _description = undefined;
+    _name = undefined;
+    _sourceModuleName = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _description, _name, _sourceModuleName) {
+        super(parent);
+        this._id = _id;
+        this._description = _description;
+        this._name = _name;
+        this._sourceModuleName = _sourceModuleName;
+    }
+    /**
+     * A unique identifier for this EnumTypeDef.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * A doc string for the enum, if any.
+     */
+    description = async () => {
+        if (this._description) {
+            return this._description;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "description",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The name of the enum.
+     */
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * If this EnumTypeDef is associated with a Module, the name of the module. Unset otherwise.
+     */
+    sourceModuleName = async () => {
+        if (this._sourceModuleName) {
+            return this._sourceModuleName;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "sourceModuleName",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The values of the enum.
+     */
+    values = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "values",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new EnumValueTypeDef({
+            queryTree: [
+                {
+                    operation: "loadEnumValueTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
+}
+/**
+ * A definition of a value in a custom enum defined in a Module.
+ */
+export class EnumValueTypeDef extends BaseClient {
+    _id = undefined;
+    _description = undefined;
+    _name = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _description, _name) {
+        super(parent);
+        this._id = _id;
+        this._description = _description;
+        this._name = _name;
+    }
+    /**
+     * A unique identifier for this EnumValueTypeDef.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * A doc string for the enum value, if any.
+     */
+    description = async () => {
+        if (this._description) {
+            return this._description;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "description",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The name of the enum value.
+     */
+    name = async () => {
+        if (this._name) {
+            return this._name;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "name",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * An environment variable name and value.
  */
@@ -2163,13 +2685,21 @@ export class File extends BaseClient {
      * Force evaluation in the engine.
      */
     sync = async () => {
-        await computeQuery([
+        const response = await computeQuery([
             ...this._queryTree,
             {
                 operation: "sync",
             },
         ], await this._ctx.connection());
-        return this;
+        return new File({
+            queryTree: [
+                {
+                    operation: "loadFileFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * Retrieves this file with its name set to the given name.
@@ -2562,16 +3092,15 @@ export class FunctionCall extends BaseClient {
      */
     returnValue = async (value) => {
         if (this._returnValue) {
-            return this._returnValue;
+            return;
         }
-        const response = await computeQuery([
+        await computeQuery([
             ...this._queryTree,
             {
                 operation: "returnValue",
                 args: { value },
             },
         ], await this._ctx.connection());
-        return response;
     };
 }
 /**
@@ -2930,16 +3459,13 @@ export class GitRef extends BaseClient {
     };
     /**
      * The filesystem tree at this ref.
-     * @param opts.sshKnownHosts DEPRECATED: This option should be passed to `git` instead.
-     * @param opts.sshAuthSocket DEPRECATED: This option should be passed to `git` instead.
      */
-    tree = (opts) => {
+    tree = () => {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "tree",
-                    args: { ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -3051,6 +3577,20 @@ export class GitRepository extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * tags that match any of the given glob patterns.
+     * @param opts.patterns Glob patterns (e.g., "refs/tags/v*").
+     */
+    tags = async (opts) => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "tags",
+                args: { ...opts },
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     /**
      * Header to authenticate the remote with.
      * @param header Secret used to populate the Authorization HTTP header
@@ -3668,6 +4208,29 @@ export class Module_ extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * Enumerations served by this module.
+     */
+    enums = async () => {
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "enums",
+            },
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response.map((r) => new TypeDef({
+            queryTree: [
+                {
+                    operation: "loadTypeDefFromID",
+                    args: { id: r.id },
+                },
+            ],
+            ctx: this._ctx,
+        }, r.id));
+    };
     /**
      * The generated files and directories made on top of the module source's context directory.
      */
@@ -3807,15 +4370,14 @@ export class Module_ extends BaseClient {
      */
     serve = async () => {
         if (this._serve) {
-            return this._serve;
+            return;
         }
-        const response = await computeQuery([
+        await computeQuery([
             ...this._queryTree,
             {
                 operation: "serve",
             },
         ], await this._ctx.connection());
-        return response;
     };
     /**
      * The source for the module.
@@ -3847,6 +4409,23 @@ export class Module_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * This module plus the given Enum type and associated values
+     */
+    withEnum = (enum_) => {
+        return new Module_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withEnum",
+                    args: {
+                        enum: enum_,
+                    },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * This module plus the given Interface type and associated functions
      */
@@ -3880,14 +4459,15 @@ export 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) => {
+    withSource = (source, opts) => {
         return new Module_({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withSource",
-                    args: { source },
+                    args: { source, ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -4034,13 +4614,15 @@ export class ModuleSource extends BaseClient {
     };
     /**
      * 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 = () => {
+    asModule = (opts) => {
         return new Module_({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "asModule",
+                    args: { ...opts },
                 },
             ],
             ctx: this._ctx,
@@ -4707,15 +5289,13 @@ export class Port extends BaseClient {
  * The root of the DAG.
  */
 export class Client extends BaseClient {
-    _checkVersionCompatibility = undefined;
     _defaultPlatform = undefined;
     _version = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _checkVersionCompatibility, _defaultPlatform, _version) {
+    constructor(parent, _defaultPlatform, _version) {
         super(parent);
-        this._checkVersionCompatibility = _checkVersionCompatibility;
         this._defaultPlatform = _defaultPlatform;
         this._version = _version;
     }
@@ -4776,25 +5356,10 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * Checks if the current Dagger Engine is compatible with an SDK's required version.
-     * @param version Version required by the SDK.
-     */
-    checkVersionCompatibility = async (version) => {
-        const response = await computeQuery([
-            ...this._queryTree,
-            {
-                operation: "checkVersionCompatibility",
-                args: { version },
-            },
-        ], await this._ctx.connection());
-        return response;
-    };
     /**
      * 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) => {
@@ -4862,6 +5427,20 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The Dagger engine container configuration and state
+     */
+    daggerEngine = () => {
+        return new DaggerEngine({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "daggerEngine",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * The default platform of the engine.
      */
@@ -4876,30 +5455,13 @@ export class Client extends BaseClient {
     };
     /**
      * Creates an empty directory.
-     * @param opts.id DEPRECATED: Use `loadDirectoryFromID` instead.
      */
-    directory = (opts) => {
+    directory = () => {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "directory",
-                    args: { ...opts },
-                },
-            ],
-            ctx: this._ctx,
-        });
-    };
-    /**
-     * @deprecated Use loadFileFromID instead.
-     */
-    file = (id) => {
-        return new File({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "file",
-                    args: { id },
                 },
             ],
             ctx: this._ctx,
@@ -5037,6 +5599,66 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a DaggerEngineCacheEntry from its ID.
+     */
+    loadDaggerEngineCacheEntryFromID = (id) => {
+        return new DaggerEngineCacheEntry({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadDaggerEngineCacheEntryFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a DaggerEngineCacheEntrySet from its ID.
+     */
+    loadDaggerEngineCacheEntrySetFromID = (id) => {
+        return new DaggerEngineCacheEntrySet({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadDaggerEngineCacheEntrySetFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a DaggerEngineCache from its ID.
+     */
+    loadDaggerEngineCacheFromID = (id) => {
+        return new DaggerEngineCache({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadDaggerEngineCacheFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a DaggerEngine from its ID.
+     */
+    loadDaggerEngineFromID = (id) => {
+        return new DaggerEngine({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadDaggerEngineFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a Directory from its ID.
      */
@@ -5052,6 +5674,36 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a EnumTypeDef from its ID.
+     */
+    loadEnumTypeDefFromID = (id) => {
+        return new EnumTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadEnumTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * Load a EnumValueTypeDef from its ID.
+     */
+    loadEnumValueTypeDefFromID = (id) => {
+        return new EnumValueTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadEnumValueTypeDefFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a EnvVariable from its ID.
      */
@@ -5587,22 +6239,6 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
-    /**
-     * Loads a socket by its ID.
-     * @deprecated Use loadSocketFromID instead.
-     */
-    socket = (id) => {
-        return new Socket({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "socket",
-                    args: { id },
-                },
-            ],
-            ctx: this._ctx,
-        });
-    };
     /**
      * Create a new TypeDef.
      */
@@ -5882,27 +6518,43 @@ export class Service extends BaseClient {
      * Services bound to a Container do not need to be manually started.
      */
     start = async () => {
-        await computeQuery([
+        const response = await computeQuery([
             ...this._queryTree,
             {
                 operation: "start",
             },
         ], await this._ctx.connection());
-        return this;
+        return new Service({
+            queryTree: [
+                {
+                    operation: "loadServiceFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * Stop the service.
      * @param opts.kill Immediately kill the service without waiting for a graceful exit
      */
     stop = async (opts) => {
-        await computeQuery([
+        const response = await computeQuery([
             ...this._queryTree,
             {
                 operation: "stop",
                 args: { ...opts },
             },
         ], await this._ctx.connection());
-        return this;
+        return new Service({
+            queryTree: [
+                {
+                    operation: "loadServiceFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
     /**
      * Creates a tunnel that forwards traffic from the caller's network to this service.
@@ -5913,16 +6565,15 @@ export class Service extends BaseClient {
      */
     up = async (opts) => {
         if (this._up) {
-            return this._up;
+            return;
         }
-        const response = await computeQuery([
+        await computeQuery([
             ...this._queryTree,
             {
                 operation: "up",
                 args: { ...opts },
             },
         ], await this._ctx.connection());
-        return response;
     };
 }
 /**
@@ -5958,14 +6609,14 @@ export class Socket extends BaseClient {
  */
 export class Terminal extends BaseClient {
     _id = undefined;
-    _websocketEndpoint = undefined;
+    _sync = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _websocketEndpoint) {
+    constructor(parent, _id, _sync) {
         super(parent);
         this._id = _id;
-        this._websocketEndpoint = _websocketEndpoint;
+        this._sync = _sync;
     }
     /**
      * A unique identifier for this Terminal.
@@ -5983,19 +6634,26 @@ export class Terminal extends BaseClient {
         return response;
     };
     /**
-     * An http endpoint at which this terminal can be connected to over a websocket.
+     * Forces evaluation of the pipeline in the engine.
+     *
+     * It doesn't run the default command if no exec has been set.
      */
-    websocketEndpoint = async () => {
-        if (this._websocketEndpoint) {
-            return this._websocketEndpoint;
-        }
+    sync = async () => {
         const response = await computeQuery([
             ...this._queryTree,
             {
-                operation: "websocketEndpoint",
+                operation: "sync",
             },
         ], await this._ctx.connection());
-        return response;
+        return new Terminal({
+            queryTree: [
+                {
+                    operation: "loadTerminalFromID",
+                    args: { id: response },
+                },
+            ],
+            ctx: this._ctx,
+        });
     };
 }
 /**
@@ -6029,6 +6687,20 @@ export class TypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * If kind is ENUM, the enum-specific type definition. If kind is not ENUM, this will be null.
+     */
+    asEnum = () => {
+        return new EnumTypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "asEnum",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * If kind is INPUT, the input-specific type definition. If kind is not INPUT, this will be null.
      */
@@ -6146,6 +6818,42 @@ export class TypeDef extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * 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, opts) => {
+        return new TypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withEnum",
+                    args: { name, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
+    /**
+     * 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, opts) => {
+        return new TypeDef({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withEnumValue",
+                    args: { value, ...opts },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * 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