@dagger.io/dagger 0.14.0 → 0.15.1

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.
@@ -631,6 +639,9 @@ 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.
  */
@@ -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.
@@ -1609,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.
@@ -1787,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;
@@ -1841,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.
      */
@@ -1881,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.
      */
@@ -2031,10 +2048,7 @@ export declare class Engine extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: EngineID);
+    constructor(ctx?: Context, _id?: EngineID);
     /**
      * A unique identifier for this Engine.
      */
@@ -2057,10 +2071,7 @@ export declare class EngineCache extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: EngineCacheID, _keepBytes?: number, _maxUsedSpace?: number, _minFreeSpace?: number, _prune?: Void, _reservedSpace?: number);
+    constructor(ctx?: Context, _id?: EngineCacheID, _keepBytes?: number, _maxUsedSpace?: number, _minFreeSpace?: number, _prune?: Void, _reservedSpace?: number);
     /**
      * A unique identifier for this EngineCache.
      */
@@ -2068,7 +2079,7 @@ export declare class EngineCache extends BaseClient {
     /**
      * The current set of entries in the cache
      */
-    entrySet: () => EngineCacheEntrySet;
+    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.
@@ -2101,10 +2112,7 @@ export declare class EngineCacheEntry extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: EngineCacheEntryID, _activelyUsed?: boolean, _createdTimeUnixNano?: number, _description?: string, _diskSpaceBytes?: number, _mostRecentUseTimeUnixNano?: number);
+    constructor(ctx?: Context, _id?: EngineCacheEntryID, _activelyUsed?: boolean, _createdTimeUnixNano?: number, _description?: string, _diskSpaceBytes?: number, _mostRecentUseTimeUnixNano?: number);
     /**
      * A unique identifier for this EngineCacheEntry.
      */
@@ -2140,10 +2148,7 @@ export declare class EngineCacheEntrySet extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent?: {
-        queryTree?: QueryTree[];
-        ctx: Context;
-    }, _id?: EngineCacheEntrySetID, _diskSpaceBytes?: number, _entryCount?: number);
+    constructor(ctx?: Context, _id?: EngineCacheEntrySetID, _diskSpaceBytes?: number, _entryCount?: number);
     /**
      * A unique identifier for this EngineCacheEntrySet.
      */
@@ -2172,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.
      */
@@ -2211,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.
      */
@@ -2242,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.
      */
@@ -2259,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.
  *
@@ -2271,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.
      */
@@ -2310,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.
      */
@@ -2376,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.
      */
@@ -2445,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.
      */
@@ -2490,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.
      */
@@ -2518,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.
@@ -2534,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.
      */
@@ -2559,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.
      */
@@ -2609,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.
      */
@@ -2659,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.
      */
@@ -2685,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.
      */
@@ -2747,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.
      */
@@ -2818,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.
      */
@@ -2846,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.
      */
@@ -2885,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.
      */
@@ -2910,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.
      */
@@ -2933,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.
      */
@@ -2966,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.
      */
@@ -3071,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.
      */
@@ -3099,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.
      */
@@ -3135,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[]>;
     /**
@@ -3163,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.
      */
@@ -3236,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.
      *
@@ -3252,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.
      */
@@ -3280,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.
      */
@@ -3329,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.
      */
@@ -3363,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.
      */
@@ -3374,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
@@ -3422,6 +3378,11 @@ export declare class Client extends BaseClient {
      * 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.
@@ -3499,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.
      */
@@ -3672,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.
      */
@@ -3703,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.
      */
@@ -3733,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.
      */
@@ -3798,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.
      */
@@ -3819,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.
      */
@@ -3853,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.
      */
@@ -3878,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.
      */