@dagger.io/dagger 0.13.7 → 0.15.0

package/dist/{api → src/api}/client.gen.d.ts

@@ -2,37 +2,13 @@
  * This file was auto-generated by `client-gen`.
  * Do not make direct changes to the file.
  */
-import { Context } from "../context/context.js";
-/**
- * @hidden
- */
-export type QueryTree = {
-    operation: string;
-    args?: Record<string, unknown>;
-};
-/**
- * @hidden
- */
-export type Metadata = {
-    [key: string]: {
-        is_enum?: boolean;
-    };
-};
-interface ClientConfig {
-    queryTree?: QueryTree[];
-    ctx?: Context;
-}
+import { Context } from "../common/context.js";
 declare class BaseClient {
-    protected _queryTree: QueryTree[];
     protected _ctx: Context;
     /**
      * @hidden
      */
-    constructor({ queryTree, ctx }?: ClientConfig);
-    /**
-     * @hidden
-     */
-    get queryTree(): QueryTree[];
+    constructor(_ctx?: Context);
 }
 export type BuildArg = {
     /**
@@ -67,6 +43,38 @@ export declare enum CacheSharingMode {
 export type CacheVolumeID = string & {
     __CacheVolumeID: never;
 };
+export type ContainerAsServiceOpts = {
+    /**
+     * Command to run instead of the container's default command (e.g., ["go", "run", "main.go"]).
+     *
+     * If empty, the container's default command is used.
+     */
+    args?: string[];
+    /**
+     * If the container has an entrypoint, prepend it to the args.
+     */
+    useEntrypoint?: boolean;
+    /**
+     * 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;
+    /**
+     * Replace "${VAR}" or "$VAR" in the args according to the current environment variables defined in the container (e.g. "/$VAR/foo").
+     */
+    expand?: boolean;
+    /**
+     * If set, skip the automatic init process injected into containers by default.
+     *
+     * This should only be used if the user requires that their exec process be the pid 1 process in the container. Otherwise it may result in unexpected behavior.
+     */
+    noInit?: boolean;
+};
 export type ContainerAsTarballOpts = {
     /**
      * Identifiers for other platform specific containers.
@@ -521,30 +529,6 @@ 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.
@@ -655,6 +639,33 @@ export type DirectoryWithNewFileOpts = {
 export type DirectoryID = string & {
     __DirectoryID: never;
 };
+export type EngineCacheEntrySetOpts = {
+    key?: string;
+};
+/**
+ * The `EngineCacheEntryID` scalar type represents an identifier for an object of type EngineCacheEntry.
+ */
+export type EngineCacheEntryID = string & {
+    __EngineCacheEntryID: never;
+};
+/**
+ * The `EngineCacheEntrySetID` scalar type represents an identifier for an object of type EngineCacheEntrySet.
+ */
+export type EngineCacheEntrySetID = string & {
+    __EngineCacheEntrySetID: never;
+};
+/**
+ * The `EngineCacheID` scalar type represents an identifier for an object of type EngineCache.
+ */
+export type EngineCacheID = string & {
+    __EngineCacheID: never;
+};
+/**
+ * The `EngineID` scalar type represents an identifier for an object of type Engine.
+ */
+export type EngineID = string & {
+    __EngineID: never;
+};
 /**
  * The `EnumTypeDefID` scalar type represents an identifier for an object of type EnumTypeDef.
  */
@@ -673,6 +684,12 @@ export type EnumValueTypeDefID = string & {
 export type EnvVariableID = string & {
     __EnvVariableID: never;
 };
+/**
+ * The `ErrorID` scalar type represents an identifier for an object of type Error.
+ */
+export type ErrorID = string & {
+    __ErrorID: never;
+};
 /**
  * The `FieldTypeDefID` scalar type represents an identifier for an object of type FieldTypeDef.
  */
@@ -1244,10 +1261,7 @@ export declare class CacheVolume extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: CacheVolumeID);
+    constructor(ctx?: Context, _id?: CacheVolumeID);
     /**
      * A unique identifier for this CacheVolume.
      */
@@ -1274,10 +1288,7 @@ export declare class Container extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ContainerID, _envVariable?: string, _exitCode?: number, _export?: string, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _up?: Void, _user?: string, _workdir?: string);
+    constructor(ctx?: Context, _id?: ContainerID, _envVariable?: string, _exitCode?: number, _export?: string, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _up?: Void, _user?: string, _workdir?: string);
     /**
      * A unique identifier for this Container.
      */
@@ -1286,8 +1297,20 @@ export declare class Container extends BaseClient {
      * Turn the container into a Service.
      *
      * Be sure to set any exposed ports before this conversion.
+     * @param opts.args Command to run instead of the container's default command (e.g., ["go", "run", "main.go"]).
+     *
+     * If empty, the container's default command is used.
+     * @param opts.useEntrypoint If the container has an entrypoint, prepend it to the args.
+     * @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.expand Replace "${VAR}" or "$VAR" in the args according to the current environment variables defined in the container (e.g. "/$VAR/foo").
+     * @param opts.noInit If set, skip the automatic init process injected into containers by default.
+     *
+     * This should only be used if the user requires that their exec process be the pid 1 process in the container. Otherwise it may result in unexpected behavior.
      */
-    asService: () => Service;
+    asService: (opts?: ContainerAsServiceOpts) => Service;
     /**
      * Returns a File representing the container serialized to a tarball.
      * @param opts.platformVariants Identifiers for other platform specific containers.
@@ -1543,7 +1566,7 @@ export declare class Container extends BaseClient {
     withEnvVariable: (name: string, value: string, opts?: ContainerWithEnvVariableOpts) => Container;
     /**
      * Retrieves this container after executing the specified command inside it.
-     * @param args Command to run instead of the container's default command (e.g., ["run", "main.go"]).
+     * @param args Command to run instead of the container's default command (e.g., ["go", "run", "main.go"]).
      *
      * If empty, the container's default command is used.
      * @param opts.useEntrypoint If the container has an entrypoint, prepend it to the args.
@@ -1601,10 +1624,6 @@ export declare class Container extends BaseClient {
      * @param opts.expand Replace "${VAR}" or "$VAR" in the value of path according to the current environment variables defined in the container (e.g. "/$VAR/foo.txt").
      */
     withFiles: (path: string, sources: File[], opts?: ContainerWithFilesOpts) => Container;
-    /**
-     * Indicate that subsequent operations should be featured more prominently in the UI.
-     */
-    withFocus: () => Container;
     /**
      * Retrieves this container plus the given label.
      * @param name The name of the label (e.g., "org.opencontainers.artifact.created").
@@ -1613,7 +1632,7 @@ export declare class Container extends BaseClient {
     withLabel: (name: string, value: string) => Container;
     /**
      * Retrieves this container plus a cache volume mounted at the given path.
-     * @param path Location of the cache directory (e.g., "/cache/node_modules").
+     * @param path Location of the cache directory (e.g., "/root/.npm").
      * @param cache Identifier of the cache volume to mount.
      * @param opts.source Identifier of the directory to use as the cache volume's root.
      * @param opts.sharing Sharing mode of the cache volume.
@@ -1784,12 +1803,6 @@ export declare class Container extends BaseClient {
      * @param opts.expand Replace "${VAR}" or "$VAR" in the value of paths according to the current environment variables defined in the container (e.g. "/$VAR/foo.txt").
      */
     withoutFiles: (paths: string[], opts?: ContainerWithoutFilesOpts) => Container;
-    /**
-     * Indicate that subsequent operations should not be featured more prominently in the UI.
-     *
-     * This is the initial state of all containers.
-     */
-    withoutFocus: () => Container;
     /**
      * Retrieves this container minus the given environment label.
      * @param name The name of the label to remove (e.g., "org.opencontainers.artifact.created").
@@ -1797,7 +1810,7 @@ export declare class Container extends BaseClient {
     withoutLabel: (name: string) => Container;
     /**
      * Retrieves this container after unmounting everything at the given path.
-     * @param path Location of the cache directory (e.g., "/cache/node_modules").
+     * @param path Location of the cache directory (e.g., "/root/.npm").
      * @param opts.expand Replace "${VAR}" or "$VAR" in the value of path according to the current environment variables defined in the container (e.g. "/$VAR/foo").
      */
     withoutMount: (path: string, opts?: ContainerWithoutMountOpts) => Container;
@@ -1851,10 +1864,7 @@ export declare class CurrentModule extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: CurrentModuleID, _name?: string);
+    constructor(ctx?: Context, _id?: CurrentModuleID, _name?: string);
     /**
      * A unique identifier for this CurrentModule.
      */
@@ -1880,144 +1890,6 @@ 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 _maxUsedSpace?;
-    private readonly _minFreeSpace?;
-    private readonly _prune?;
-    private readonly _reservedSpace?;
-    /**
-     * Constructor is used for internal usage only, do not create object from it.
-     */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: DaggerEngineCacheID, _keepBytes?: number, _maxUsedSpace?: number, _minFreeSpace?: number, _prune?: Void, _reservedSpace?: number);
-    /**
-     * 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.
-     * @deprecated Use minFreeSpace instead.
-     */
-    keepBytes: () => Promise<number>;
-    /**
-     * The maximum bytes to keep in the cache without pruning.
-     */
-    maxUsedSpace: () => Promise<number>;
-    /**
-     * The target amount of free disk space the garbage collector will attempt to leave.
-     */
-    minFreeSpace: () => Promise<number>;
-    /**
-     * Prune the cache of releaseable entries
-     */
-    prune: () => Promise<void>;
-    reservedSpace: () => Promise<number>;
-}
-/**
- * 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.
  */
@@ -2029,10 +1901,7 @@ export declare class Directory extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: DirectoryID, _digest?: string, _export?: string, _sync?: DirectoryID);
+    constructor(ctx?: Context, _id?: DirectoryID, _digest?: string, _export?: string, _sync?: DirectoryID);
     /**
      * A unique identifier for this Directory.
      */
@@ -2171,6 +2040,132 @@ export declare class Directory extends BaseClient {
      */
     with: (arg: (param: Directory) => Directory) => Directory;
 }
+/**
+ * The Dagger engine configuration and state
+ */
+export declare class Engine extends BaseClient {
+    private readonly _id?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: EngineID);
+    /**
+     * A unique identifier for this Engine.
+     */
+    id: () => Promise<EngineID>;
+    /**
+     * The local (on-disk) cache for the Dagger engine
+     */
+    localCache: () => EngineCache;
+}
+/**
+ * A cache storage for the Dagger engine
+ */
+export declare class EngineCache extends BaseClient {
+    private readonly _id?;
+    private readonly _keepBytes?;
+    private readonly _maxUsedSpace?;
+    private readonly _minFreeSpace?;
+    private readonly _prune?;
+    private readonly _reservedSpace?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: EngineCacheID, _keepBytes?: number, _maxUsedSpace?: number, _minFreeSpace?: number, _prune?: Void, _reservedSpace?: number);
+    /**
+     * A unique identifier for this EngineCache.
+     */
+    id: () => Promise<EngineCacheID>;
+    /**
+     * The current set of entries in the cache
+     */
+    entrySet: (opts?: EngineCacheEntrySetOpts) => EngineCacheEntrySet;
+    /**
+     * The maximum bytes to keep in the cache without pruning, after which automatic pruning may kick in.
+     * @deprecated Use minFreeSpace instead.
+     */
+    keepBytes: () => Promise<number>;
+    /**
+     * The maximum bytes to keep in the cache without pruning.
+     */
+    maxUsedSpace: () => Promise<number>;
+    /**
+     * The target amount of free disk space the garbage collector will attempt to leave.
+     */
+    minFreeSpace: () => Promise<number>;
+    /**
+     * Prune the cache of releaseable entries
+     */
+    prune: () => Promise<void>;
+    reservedSpace: () => Promise<number>;
+}
+/**
+ * An individual cache entry in a cache entry set
+ */
+export declare class EngineCacheEntry 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(ctx?: Context, _id?: EngineCacheEntryID, _activelyUsed?: boolean, _createdTimeUnixNano?: number, _description?: string, _diskSpaceBytes?: number, _mostRecentUseTimeUnixNano?: number);
+    /**
+     * A unique identifier for this EngineCacheEntry.
+     */
+    id: () => Promise<EngineCacheEntryID>;
+    /**
+     * 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 EngineCacheEntrySet 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(ctx?: Context, _id?: EngineCacheEntrySetID, _diskSpaceBytes?: number, _entryCount?: number);
+    /**
+     * A unique identifier for this EngineCacheEntrySet.
+     */
+    id: () => Promise<EngineCacheEntrySetID>;
+    /**
+     * 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<EngineCacheEntry[]>;
+    /**
+     * The number of cache entries in this set.
+     */
+    entryCount: () => Promise<number>;
+}
 /**
  * A definition of a custom enum defined in a Module.
  */
@@ -2182,10 +2177,7 @@ export declare class EnumTypeDef extends BaseClient {
     /**
      * 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);
+    constructor(ctx?: Context, _id?: EnumTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
      * A unique identifier for this EnumTypeDef.
      */
@@ -2221,10 +2213,7 @@ export declare class EnumValueTypeDef extends BaseClient {
     /**
      * 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);
+    constructor(ctx?: Context, _id?: EnumValueTypeDefID, _description?: string, _name?: string);
     /**
      * A unique identifier for this EnumValueTypeDef.
      */
@@ -2252,10 +2241,7 @@ export declare class EnvVariable extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: EnvVariableID, _name?: string, _value?: string);
+    constructor(ctx?: Context, _id?: EnvVariableID, _name?: string, _value?: string);
     /**
      * A unique identifier for this EnvVariable.
      */
@@ -2269,6 +2255,22 @@ export declare class EnvVariable extends BaseClient {
      */
     value: () => Promise<string>;
 }
+export declare class Error extends BaseClient {
+    private readonly _id?;
+    private readonly _message?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: ErrorID, _message?: string);
+    /**
+     * A unique identifier for this Error.
+     */
+    id: () => Promise<ErrorID>;
+    /**
+     * A description of the error.
+     */
+    message: () => Promise<string>;
+}
 /**
  * A definition of a field on a custom object defined in a Module.
  *
@@ -2281,10 +2283,7 @@ export declare class FieldTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FieldTypeDefID, _description?: string, _name?: string);
+    constructor(ctx?: Context, _id?: FieldTypeDefID, _description?: string, _name?: string);
     /**
      * A unique identifier for this FieldTypeDef.
      */
@@ -2320,10 +2319,7 @@ export declare class File extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FileID, _contents?: string, _digest?: string, _export?: string, _name?: string, _size?: number, _sync?: FileID);
+    constructor(ctx?: Context, _id?: FileID, _contents?: string, _digest?: string, _export?: string, _name?: string, _size?: number, _sync?: FileID);
     /**
      * A unique identifier for this File.
      */
@@ -2386,10 +2382,7 @@ export declare class Function_ extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FunctionID, _description?: string, _name?: string);
+    constructor(ctx?: Context, _id?: FunctionID, _description?: string, _name?: string);
     /**
      * A unique identifier for this Function.
      */
@@ -2455,10 +2448,7 @@ export declare class FunctionArg extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FunctionArgID, _defaultPath?: string, _defaultValue?: JSON, _description?: string, _name?: string);
+    constructor(ctx?: Context, _id?: FunctionArgID, _defaultPath?: string, _defaultValue?: JSON, _description?: string, _name?: string);
     /**
      * A unique identifier for this FunctionArg.
      */
@@ -2500,14 +2490,12 @@ export declare class FunctionCall extends BaseClient {
     private readonly _name?;
     private readonly _parent?;
     private readonly _parentName?;
+    private readonly _returnError?;
     private readonly _returnValue?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FunctionCallID, _name?: string, _parent?: JSON, _parentName?: string, _returnValue?: Void);
+    constructor(ctx?: Context, _id?: FunctionCallID, _name?: string, _parent?: JSON, _parentName?: string, _returnError?: Void, _returnValue?: Void);
     /**
      * A unique identifier for this FunctionCall.
      */
@@ -2528,6 +2516,11 @@ export declare class FunctionCall extends BaseClient {
      * 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>;
+    /**
+     * Return an error from the function.
+     * @param error The error to return.
+     */
+    returnError: (error: Error) => Promise<void>;
     /**
      * Set the return value of the function call to the provided value.
      * @param value JSON serialization of the return value.
@@ -2544,10 +2537,7 @@ export declare class FunctionCallArgValue extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: FunctionCallArgValueID, _name?: string, _value?: JSON);
+    constructor(ctx?: Context, _id?: FunctionCallArgValueID, _name?: string, _value?: JSON);
     /**
      * A unique identifier for this FunctionCallArgValue.
      */
@@ -2569,10 +2559,7 @@ export declare class GeneratedCode extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: GeneratedCodeID);
+    constructor(ctx?: Context, _id?: GeneratedCodeID);
     /**
      * A unique identifier for this GeneratedCode.
      */
@@ -2619,10 +2606,7 @@ export declare class GitModuleSource extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: GitModuleSourceID, _cloneRef?: string, _commit?: string, _htmlRepoURL?: string, _htmlURL?: string, _root?: string, _rootSubpath?: string, _version?: string);
+    constructor(ctx?: Context, _id?: GitModuleSourceID, _cloneRef?: string, _commit?: string, _htmlRepoURL?: string, _htmlURL?: string, _root?: string, _rootSubpath?: string, _version?: string);
     /**
      * A unique identifier for this GitModuleSource.
      */
@@ -2669,10 +2653,7 @@ export declare class GitRef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: GitRefID, _commit?: string);
+    constructor(ctx?: Context, _id?: GitRefID, _commit?: string);
     /**
      * A unique identifier for this GitRef.
      */
@@ -2695,10 +2676,7 @@ export declare class GitRepository extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: GitRepositoryID);
+    constructor(ctx?: Context, _id?: GitRepositoryID);
     /**
      * A unique identifier for this GitRepository.
      */
@@ -2757,10 +2735,7 @@ export declare class Host extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: HostID);
+    constructor(ctx?: Context, _id?: HostID);
     /**
      * A unique identifier for this Host.
      */
@@ -2828,10 +2803,7 @@ export declare class InputTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: InputTypeDefID, _name?: string);
+    constructor(ctx?: Context, _id?: InputTypeDefID, _name?: string);
     /**
      * A unique identifier for this InputTypeDef.
      */
@@ -2856,10 +2828,7 @@ export declare class InterfaceTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: InterfaceTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
+    constructor(ctx?: Context, _id?: InterfaceTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
      * A unique identifier for this InterfaceTypeDef.
      */
@@ -2895,10 +2864,7 @@ export declare class Label extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: LabelID, _name?: string, _value?: string);
+    constructor(ctx?: Context, _id?: LabelID, _name?: string, _value?: string);
     /**
      * A unique identifier for this Label.
      */
@@ -2920,10 +2886,7 @@ export declare class ListTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ListTypeDefID);
+    constructor(ctx?: Context, _id?: ListTypeDefID);
     /**
      * A unique identifier for this ListTypeDef.
      */
@@ -2943,10 +2906,7 @@ export declare class LocalModuleSource extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: LocalModuleSourceID, _relHostPath?: string, _rootSubpath?: string);
+    constructor(ctx?: Context, _id?: LocalModuleSourceID, _relHostPath?: string, _rootSubpath?: string);
     /**
      * A unique identifier for this LocalModuleSource.
      */
@@ -2976,10 +2936,7 @@ export declare class Module_ extends BaseClient {
     /**
      * 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);
+    constructor(ctx?: Context, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void);
     /**
      * A unique identifier for this Module.
      */
@@ -3081,10 +3038,7 @@ export declare class ModuleDependency extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ModuleDependencyID, _name?: string);
+    constructor(ctx?: Context, _id?: ModuleDependencyID, _name?: string);
     /**
      * A unique identifier for this ModuleDependency.
      */
@@ -3109,16 +3063,14 @@ export declare class ModuleSource extends BaseClient {
     private readonly _kind?;
     private readonly _moduleName?;
     private readonly _moduleOriginalName?;
+    private readonly _pin?;
     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, _digest?: string, _kind?: ModuleSourceKind, _moduleName?: string, _moduleOriginalName?: string, _resolveContextPathFromCaller?: string, _sourceRootSubpath?: string, _sourceSubpath?: string);
+    constructor(ctx?: Context, _id?: ModuleSourceID, _asString?: string, _configExists?: boolean, _digest?: string, _kind?: ModuleSourceKind, _moduleName?: string, _moduleOriginalName?: string, _pin?: string, _resolveContextPathFromCaller?: string, _sourceRootSubpath?: string, _sourceSubpath?: string);
     /**
      * A unique identifier for this ModuleSource.
      */
@@ -3145,11 +3097,11 @@ export declare class ModuleSource extends BaseClient {
      */
     configExists: () => Promise<boolean>;
     /**
-     * The directory containing everything needed to load load and use the module.
+     * The directory containing everything needed to load and use the module.
      */
     contextDirectory: () => Directory;
     /**
-     * The dependencies of the module source. Includes dependencies from the configuration and any extras from withDependencies calls.
+     * The effective module source dependencies from the configuration, and calls to withDependencies and withoutDependencies.
      */
     dependencies: () => Promise<ModuleDependency[]>;
     /**
@@ -3173,6 +3125,10 @@ export declare class ModuleSource extends BaseClient {
      * The original name of the module this source references, as defined in the module configuration.
      */
     moduleOriginalName: () => Promise<string>;
+    /**
+     * The pinned version of this module source.
+     */
+    pin: () => Promise<string>;
     /**
      * The path to the module source's context directory on the caller's filesystem. Only valid for local sources.
      */
@@ -3246,6 +3202,11 @@ export declare class ModuleSource extends BaseClient {
      * @param patterns The patterns to set as the view filters.
      */
     withView: (name: string, patterns: string[]) => ModuleSource;
+    /**
+     * Remove the provided dependencies from the module source's dependency list.
+     * @param dependencies The dependencies to remove.
+     */
+    withoutDependencies: (dependencies: string[]) => ModuleSource;
     /**
      * Call the provided function with current ModuleSource.
      *
@@ -3262,10 +3223,7 @@ export declare class ModuleSourceView extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ModuleSourceViewID, _name?: string);
+    constructor(ctx?: Context, _id?: ModuleSourceViewID, _name?: string);
     /**
      * A unique identifier for this ModuleSourceView.
      */
@@ -3290,10 +3248,7 @@ export declare class ObjectTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ObjectTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
+    constructor(ctx?: Context, _id?: ObjectTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
      * A unique identifier for this ObjectTypeDef.
      */
@@ -3339,10 +3294,7 @@ export declare class Port extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: PortID, _description?: string, _experimentalSkipHealthcheck?: boolean, _port?: number, _protocol?: NetworkProtocol);
+    constructor(ctx?: Context, _id?: PortID, _description?: string, _experimentalSkipHealthcheck?: boolean, _port?: number, _protocol?: NetworkProtocol);
     /**
      * A unique identifier for this Port.
      */
@@ -3373,10 +3325,7 @@ export declare class Client extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _defaultPlatform?: Platform, _version?: string);
+    constructor(ctx?: Context, _defaultPlatform?: Platform, _version?: string);
     /**
      * Get the Raw GraphQL client.
      */
@@ -3384,11 +3333,8 @@ export declare class Client extends BaseClient {
     /**
      * Retrieves a content-addressed blob.
      * @param digest Digest of the blob
-     * @param size Size of the blob
-     * @param mediaType Media type of the blob
-     * @param uncompressed Digest of the uncompressed blob
      */
-    blob: (digest: string, size: number, mediaType: string, uncompressed: string) => Directory;
+    blob: (digest: string) => Directory;
     /**
      * Retrieves a container builtin to the engine.
      * @param digest Digest of the image manifest
@@ -3420,10 +3366,6 @@ 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.
      */
@@ -3432,6 +3374,15 @@ export declare class Client extends BaseClient {
      * Creates an empty directory.
      */
     directory: () => Directory;
+    /**
+     * The Dagger engine container configuration and state
+     */
+    engine: () => Engine;
+    /**
+     * Create a new error.
+     * @param message A brief description of the error.
+     */
+    error: (message: string) => Error;
     /**
      * Creates a function.
      * @param name Name of the function, in its original format from the implementation language.
@@ -3478,25 +3429,25 @@ export declare class Client extends BaseClient {
      */
     loadCurrentModuleFromID: (id: CurrentModuleID) => CurrentModule;
     /**
-     * Load a DaggerEngineCacheEntry from its ID.
+     * Load a Directory from its ID.
      */
-    loadDaggerEngineCacheEntryFromID: (id: DaggerEngineCacheEntryID) => DaggerEngineCacheEntry;
+    loadDirectoryFromID: (id: DirectoryID) => Directory;
     /**
-     * Load a DaggerEngineCacheEntrySet from its ID.
+     * Load a EngineCacheEntry from its ID.
      */
-    loadDaggerEngineCacheEntrySetFromID: (id: DaggerEngineCacheEntrySetID) => DaggerEngineCacheEntrySet;
+    loadEngineCacheEntryFromID: (id: EngineCacheEntryID) => EngineCacheEntry;
     /**
-     * Load a DaggerEngineCache from its ID.
+     * Load a EngineCacheEntrySet from its ID.
      */
-    loadDaggerEngineCacheFromID: (id: DaggerEngineCacheID) => DaggerEngineCache;
+    loadEngineCacheEntrySetFromID: (id: EngineCacheEntrySetID) => EngineCacheEntrySet;
     /**
-     * Load a DaggerEngine from its ID.
+     * Load a EngineCache from its ID.
      */
-    loadDaggerEngineFromID: (id: DaggerEngineID) => DaggerEngine;
+    loadEngineCacheFromID: (id: EngineCacheID) => EngineCache;
     /**
-     * Load a Directory from its ID.
+     * Load a Engine from its ID.
      */
-    loadDirectoryFromID: (id: DirectoryID) => Directory;
+    loadEngineFromID: (id: EngineID) => Engine;
     /**
      * Load a EnumTypeDef from its ID.
      */
@@ -3509,6 +3460,10 @@ export declare class Client extends BaseClient {
      * Load a EnvVariable from its ID.
      */
     loadEnvVariableFromID: (id: EnvVariableID) => EnvVariable;
+    /**
+     * Load a Error from its ID.
+     */
+    loadErrorFromID: (id: ErrorID) => Error;
     /**
      * Load a FieldTypeDef from its ID.
      */
@@ -3682,10 +3637,7 @@ export declare class ScalarTypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: ScalarTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
+    constructor(ctx?: Context, _id?: ScalarTypeDefID, _description?: string, _name?: string, _sourceModuleName?: string);
     /**
      * A unique identifier for this ScalarTypeDef.
      */
@@ -3713,10 +3665,7 @@ export declare class Secret extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: SecretID, _name?: string, _plaintext?: string);
+    constructor(ctx?: Context, _id?: SecretID, _name?: string, _plaintext?: string);
     /**
      * A unique identifier for this Secret.
      */
@@ -3743,10 +3692,7 @@ export declare class Service extends BaseClient {
     /**
      * 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, _up?: Void);
+    constructor(ctx?: Context, _id?: ServiceID, _endpoint?: string, _hostname?: string, _start?: ServiceID, _stop?: ServiceID, _up?: Void);
     /**
      * A unique identifier for this Service.
      */
@@ -3808,10 +3754,7 @@ export declare class Socket extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: SocketID);
+    constructor(ctx?: Context, _id?: SocketID);
     /**
      * A unique identifier for this Socket.
      */
@@ -3829,10 +3772,7 @@ export declare class SourceMap extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: SourceMapID, _column?: number, _filename?: string, _line?: number, _module?: string);
+    constructor(ctx?: Context, _id?: SourceMapID, _column?: number, _filename?: string, _line?: number, _module?: string);
     /**
      * A unique identifier for this SourceMap.
      */
@@ -3863,10 +3803,7 @@ export declare class Terminal extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: TerminalID, _sync?: TerminalID);
+    constructor(ctx?: Context, _id?: TerminalID, _sync?: TerminalID);
     /**
      * A unique identifier for this Terminal.
      */
@@ -3888,10 +3825,7 @@ export declare class TypeDef extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: TypeDefID, _kind?: TypeDefKind, _optional?: boolean);
+    constructor(ctx?: Context, _id?: TypeDefID, _kind?: TypeDefKind, _optional?: boolean);
     /**
      * A unique identifier for this TypeDef.
      */