@dagger.io/dagger 0.19.10 → 0.20.0

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

@@ -71,12 +71,62 @@ export declare enum CacheSharingMode {
 export type CacheVolumeID = string & {
     __CacheVolumeID: never;
 };
+export type ChangesetWithChangesetOpts = {
+    /**
+     * What to do on a merge conflict
+     */
+    onConflict?: ChangesetMergeConflict;
+};
+export type ChangesetWithChangesetsOpts = {
+    /**
+     * What to do on a merge conflict
+     */
+    onConflict?: ChangesetsMergeConflict;
+};
 /**
  * The `ChangesetID` scalar type represents an identifier for an object of type Changeset.
  */
 export type ChangesetID = string & {
     __ChangesetID: never;
 };
+/**
+ * Strategy to use when merging changesets with conflicting changes.
+ */
+export declare enum ChangesetMergeConflict {
+    /**
+     * Attempt the merge and fail if git merge fails due to conflicts
+     */
+    Fail = "FAIL",
+    /**
+     * Fail before attempting merge if file-level conflicts are detected
+     */
+    FailEarly = "FAIL_EARLY",
+    /**
+     * Let git create conflict markers in files. For modify/delete conflicts, keeps the modified version. Fails on binary conflicts.
+     */
+    LeaveConflictMarkers = "LEAVE_CONFLICT_MARKERS",
+    /**
+     * The conflict is resolved by applying the version of the calling changeset
+     */
+    PreferOurs = "PREFER_OURS",
+    /**
+     * The conflict is resolved by applying the version of the other changeset
+     */
+    PreferTheirs = "PREFER_THEIRS"
+}
+/**
+ * Strategy to use when merging multiple changesets with git octopus merge.
+ */
+export declare enum ChangesetsMergeConflict {
+    /**
+     * Attempt the octopus merge and fail if git merge fails due to conflicts
+     */
+    Fail = "FAIL",
+    /**
+     * Fail before attempting merge if file-level conflicts are detected between any changesets
+     */
+    FailEarly = "FAIL_EARLY"
+}
 /**
  * The `CheckGroupID` scalar type represents an identifier for an object of type CheckGroup.
  */
@@ -615,6 +665,12 @@ export type ContainerWithoutUnixSocketOpts = {
 export type ContainerID = string & {
     __ContainerID: never;
 };
+export type CurrentModuleGeneratorsOpts = {
+    /**
+     * Only include generators matching the specified patterns
+     */
+    include?: string[];
+};
 export type CurrentModuleWorkdirOpts = {
     /**
      * Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
@@ -680,6 +736,14 @@ export type DirectoryDockerBuildOpts = {
      * This should only be used if the user requires that their exec processes be the pid 1 process in the container. Otherwise it may result in unexpected behavior.
      */
     noInit?: boolean;
+    /**
+     * A socket to use for SSH authentication during the build
+     *
+     * (e.g., for Dockerfile RUN --mount=type=ssh instructions).
+     *
+     * Typically obtained via host.unixSocket() pointing to the SSH_AUTH_SOCK.
+     */
+    ssh?: Socket;
 };
 export type DirectoryEntriesOpts = {
     /**
@@ -855,6 +919,22 @@ export type EngineCachePruneOpts = {
      * Use the engine-wide default pruning policy if true, otherwise prune the whole cache of any releasable entries.
      */
     useDefaultPolicy?: boolean;
+    /**
+     * Override the maximum disk space to keep before pruning (e.g. "200GB" or "80%").
+     */
+    maxUsedSpace?: string;
+    /**
+     * Override the minimum disk space to retain during pruning (e.g. "500GB" or "10%").
+     */
+    reservedSpace?: string;
+    /**
+     * Override the minimum free disk space target during pruning (e.g. "20GB" or "20%").
+     */
+    minFreeSpace?: string;
+    /**
+     * Override the target disk space to keep after pruning (e.g. "200GB" or "50%").
+     */
+    targetSpace?: string;
 };
 /**
  * The `EngineCacheEntryID` scalar type represents an identifier for an object of type EngineCacheEntry.
@@ -892,6 +972,12 @@ export type EnumTypeDefID = string & {
 export type EnumValueTypeDefID = string & {
     __EnumValueTypeDefID: never;
 };
+export type EnvChecksOpts = {
+    /**
+     * Only include checks matching the specified patterns
+     */
+    include?: string[];
+};
 export type EnvFileGetOpts = {
     /**
      * Return the value exactly as written to the file. No quote removal or variable expansion
@@ -1097,6 +1183,7 @@ export type FunctionWithArgOpts = {
      * If deprecated, the reason or migration path.
      */
     deprecated?: string;
+    defaultAddress?: string;
 };
 export type FunctionWithCachePolicyOpts = {
     /**
@@ -1148,6 +1235,24 @@ export type FunctionID = string & {
 export type GeneratedCodeID = string & {
     __GeneratedCodeID: never;
 };
+export type GeneratorGroupChangesOpts = {
+    /**
+     * Strategy to apply on conflicts between generators
+     */
+    onConflict?: ChangesetsMergeConflict;
+};
+/**
+ * The `GeneratorGroupID` scalar type represents an identifier for an object of type GeneratorGroup.
+ */
+export type GeneratorGroupID = string & {
+    __GeneratorGroupID: never;
+};
+/**
+ * The `GeneratorID` scalar type represents an identifier for an object of type Generator.
+ */
+export type GeneratorID = string & {
+    __GeneratorID: never;
+};
 export type GitRefTreeOpts = {
     /**
      * Set to true to discard .git directory.
@@ -1322,6 +1427,12 @@ export type ModuleChecksOpts = {
      */
     include?: string[];
 };
+export type ModuleGeneratorsOpts = {
+    /**
+     * Only include generators matching the specified patterns
+     */
+    include?: string[];
+};
 export type ModuleServeOpts = {
     /**
      * Expose the dependencies of this module to the client
@@ -1423,6 +1534,12 @@ export type ClientContainerOpts = {
      */
     platform?: Platform;
 };
+export type ClientCurrentWorkspaceOpts = {
+    /**
+     * If true, skip legacy dagger.json migration checks.
+     */
+    skipMigrationCheck?: boolean;
+};
 export type ClientEnvOpts = {
     /**
      * Give the environment the same privileges as the caller: core API including host access, current module, and dependencies
@@ -1540,11 +1657,11 @@ export type ClientSecretOpts = {
  */
 export declare enum ReturnType {
     /**
-     * Any execution (exit codes 0-127)
+     * Any execution (exit codes 0-127 and 192-255)
      */
     Any = "ANY",
     /**
-     * A failed execution (exit codes 1-127)
+     * A failed execution (exit codes 1-127 and 192-255)
      */
     Failure = "FAILURE",
     /**
@@ -1838,6 +1955,32 @@ export declare enum TypeDefKind {
 export type Void = string & {
     __Void: never;
 };
+export type WorkspaceDirectoryOpts = {
+    /**
+     * Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
+     */
+    exclude?: string[];
+    /**
+     * Include only artifacts that match the given pattern (e.g., ["app/", "package.*"]).
+     */
+    include?: string[];
+    /**
+     * Apply .gitignore filter rules inside the directory.
+     */
+    gitignore?: boolean;
+};
+export type WorkspaceFindUpOpts = {
+    /**
+     * Path to start the search from, relative to the workspace root.
+     */
+    from?: string;
+};
+/**
+ * The `WorkspaceID` scalar type represents an identifier for an object of type Workspace.
+ */
+export type WorkspaceID = string & {
+    __WorkspaceID: never;
+};
 export type __DirectiveArgsOpts = {
     includeDeprecated?: boolean;
 };
@@ -1963,6 +2106,14 @@ export declare class Binding extends BaseClient {
      * Retrieve the binding value, as type File
      */
     asFile: () => File;
+    /**
+     * Retrieve the binding value, as type Generator
+     */
+    asGenerator: () => Generator;
+    /**
+     * Retrieve the binding value, as type GeneratorGroup
+     */
+    asGeneratorGroup: () => GeneratorGroup;
     /**
      * Retrieve the binding value, as type GitRef
      */
@@ -2015,6 +2166,10 @@ export declare class Binding extends BaseClient {
      * Returns the binding's string value
      */
     asString: () => Promise<string>;
+    /**
+     * Retrieve the binding value, as type Workspace
+     */
+    asWorkspace: () => Workspace;
     /**
      * Returns the digest of the binding value
      */
@@ -2103,6 +2258,30 @@ export declare class Changeset extends BaseClient {
      * Force evaluation in the engine.
      */
     sync: () => Promise<Changeset>;
+    /**
+     * Add changes to an existing changeset
+     *
+     * By default the operation will fail in case of conflicts, for instance a file modified in both changesets. The behavior can be adjusted using onConflict argument
+     * @param changes Changes to merge into the actual changeset
+     * @param opts.onConflict What to do on a merge conflict
+     */
+    withChangeset: (changes: Changeset, opts?: ChangesetWithChangesetOpts) => Changeset;
+    /**
+     * Add changes from multiple changesets using git octopus merge strategy
+     *
+     * This is more efficient than chaining multiple withChangeset calls when merging many changesets.
+     *
+     * Only FAIL and FAIL_EARLY conflict strategies are supported (octopus merge cannot use -X ours/theirs).
+     * @param changes List of changesets to merge into the actual changeset
+     * @param opts.onConflict What to do on a merge conflict
+     */
+    withChangesets: (changes: Changeset[], opts?: ChangesetWithChangesetsOpts) => Changeset;
+    /**
+     * Call the provided function with current Changeset.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: Changeset) => Changeset) => Changeset;
 }
 export declare class Check extends BaseClient {
     private readonly _id?;
@@ -2127,10 +2306,18 @@ export declare class Check extends BaseClient {
      * The description of the check
      */
     description: () => Promise<string>;
+    /**
+     * If the check failed, this is the error
+     */
+    error: () => Error;
     /**
      * Return the fully qualified name of the check
      */
     name: () => Promise<string>;
+    /**
+     * The original module in which the check has been defined
+     */
+    originalModule: () => Module_;
     /**
      * Whether the check passed
      */
@@ -2147,10 +2334,6 @@ export declare class Check extends BaseClient {
      * Execute the check
      */
     run: () => Check;
-    /**
-     * The module source where the check is defined (i.e., toolchains)
-     */
-    source: () => ModuleSource;
     /**
      * Call the provided function with current Check.
      *
@@ -2858,6 +3041,12 @@ export declare class CurrentModule extends BaseClient {
      * The generated files and directories made on top of the module source's context directory.
      */
     generatedContextDirectory: () => Directory;
+    /**
+     * Return all generators defined by the module
+     * @param opts.include Only include generators matching the specified patterns
+     * @experimental
+     */
+    generators: (opts?: CurrentModuleGeneratorsOpts) => GeneratorGroup;
     /**
      * The name of the module being executed in
      */
@@ -2960,6 +3149,11 @@ export declare class Directory extends BaseClient {
      * @param opts.noInit If set, skip the automatic init process injected into containers created by RUN statements.
      *
      * This should only be used if the user requires that their exec processes be the pid 1 process in the container. Otherwise it may result in unexpected behavior.
+     * @param opts.ssh A socket to use for SSH authentication during the build
+     *
+     * (e.g., for Dockerfile RUN --mount=type=ssh instructions).
+     *
+     * Typically obtained via host.unixSocket() pointing to the SSH_AUTH_SOCK.
      */
     dockerBuild: (opts?: DirectoryDockerBuildOpts) => Container;
     /**
@@ -3205,6 +3399,10 @@ export declare class EngineCache extends BaseClient {
     /**
      * Prune the cache of releaseable entries
      * @param opts.useDefaultPolicy Use the engine-wide default pruning policy if true, otherwise prune the whole cache of any releasable entries.
+     * @param opts.maxUsedSpace Override the maximum disk space to keep before pruning (e.g. "200GB" or "80%").
+     * @param opts.reservedSpace Override the minimum disk space to retain during pruning (e.g. "500GB" or "10%").
+     * @param opts.minFreeSpace Override the minimum free disk space target during pruning (e.g. "20GB" or "20%").
+     * @param opts.targetSpace Override the target disk space to keep after pruning (e.g. "200GB" or "50%").
      */
     prune: (opts?: EngineCachePruneOpts) => Promise<void>;
     /**
@@ -3226,10 +3424,11 @@ export declare class EngineCacheEntry extends BaseClient {
     private readonly _description?;
     private readonly _diskSpaceBytes?;
     private readonly _mostRecentUseTimeUnixNano?;
+    private readonly _recordType?;
     /**
      * 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);
+    constructor(ctx?: Context, _id?: EngineCacheEntryID, _activelyUsed?: boolean, _createdTimeUnixNano?: number, _description?: string, _diskSpaceBytes?: number, _mostRecentUseTimeUnixNano?: number, _recordType?: string);
     /**
      * A unique identifier for this EngineCacheEntry.
      */
@@ -3254,6 +3453,10 @@ export declare class EngineCacheEntry extends BaseClient {
      * The most recent time the cache entry was used, in Unix nanoseconds.
      */
     mostRecentUseTimeUnixNano: () => Promise<number>;
+    /**
+     * The type of the cache record (e.g. regular, internal, frontend, source.local, source.git.checkout, exec.cachemount).
+     */
+    recordType: () => Promise<string>;
 }
 /**
  * A set of cache entries returned by a query to a cache
@@ -3372,6 +3575,18 @@ export declare class Env extends BaseClient {
      * A unique identifier for this Env.
      */
     id: () => Promise<EnvID>;
+    /**
+     * Return the check with the given name from the installed modules. Must match exactly one check.
+     * @param name The name of the check to retrieve
+     * @experimental
+     */
+    check: (name: string) => Check;
+    /**
+     * Return all checks defined by the installed modules
+     * @param opts.include Only include checks matching the specified patterns
+     * @experimental
+     */
+    checks: (opts?: EnvChecksOpts) => CheckGroup;
     /**
      * Retrieves an input binding by name
      */
@@ -3537,6 +3752,32 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withFileOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type GeneratorGroup in the environment
+     * @param name The name of the binding
+     * @param value The GeneratorGroup value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withGeneratorGroupInput: (name: string, value: GeneratorGroup, description: string) => Env;
+    /**
+     * Declare a desired GeneratorGroup output to be assigned in the environment
+     * @param name The name of the binding
+     * @param description A description of the desired value of the binding
+     */
+    withGeneratorGroupOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Generator in the environment
+     * @param name The name of the binding
+     * @param value The Generator value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withGeneratorInput: (name: string, value: Generator, description: string) => Env;
+    /**
+     * Declare a desired Generator output to be assigned in the environment
+     * @param name The name of the binding
+     * @param description A description of the desired value of the binding
+     */
+    withGeneratorOutput: (name: string, description: string) => Env;
     /**
      * Create or update a binding of type GitRef in the environment
      * @param name The name of the binding
@@ -3576,10 +3817,17 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withJSONValueOutput: (name: string, description: string) => Env;
+    /**
+     * Sets the main module for this environment (the project being worked on)
+     *
+     * Contextual path arguments will be populated using the environment's workspace.
+     */
+    withMainModule: (module_: Module_) => Env;
     /**
      * Installs a module into the environment, exposing its functions to the model
      *
      * Contextual path arguments will be populated using the environment's workspace.
+     * @deprecated Use withMainModule instead
      */
     withModule: (module_: Module_) => Env;
     /**
@@ -3717,6 +3965,19 @@ export declare class Env extends BaseClient {
      * @param workspace The directory to set as the host filesystem
      */
     withWorkspace: (workspace: Directory) => Env;
+    /**
+     * Create or update a binding of type Workspace in the environment
+     * @param name The name of the binding
+     * @param value The Workspace value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withWorkspaceInput: (name: string, value: Workspace, description: string) => Env;
+    /**
+     * Declare a desired Workspace output to be assigned in the environment
+     * @param name The name of the binding
+     * @param description A description of the desired value of the binding
+     */
+    withWorkspaceOutput: (name: string, description: string) => Env;
     /**
      * Returns a new environment without any outputs
      */
@@ -4097,6 +4358,10 @@ export declare class Function_ extends BaseClient {
      * @param description The doc string to set.
      */
     withDescription: (description: string) => Function_;
+    /**
+     * Returns the function with a flag indicating it's a generator.
+     */
+    withGenerator: () => Function_;
     /**
      * Returns the function with the given source map.
      * @param sourceMap The source map for the function definition.
@@ -4116,6 +4381,7 @@ export declare class Function_ extends BaseClient {
  */
 export declare class FunctionArg extends BaseClient {
     private readonly _id?;
+    private readonly _defaultAddress?;
     private readonly _defaultPath?;
     private readonly _defaultValue?;
     private readonly _deprecated?;
@@ -4124,11 +4390,15 @@ export declare class FunctionArg extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: FunctionArgID, _defaultPath?: string, _defaultValue?: JSON, _deprecated?: string, _description?: string, _name?: string);
+    constructor(ctx?: Context, _id?: FunctionArgID, _defaultAddress?: string, _defaultPath?: string, _defaultValue?: JSON, _deprecated?: string, _description?: string, _name?: string);
     /**
      * A unique identifier for this FunctionArg.
      */
     id: () => Promise<FunctionArgID>;
+    /**
+     * Only applies to arguments of type Container. If the argument is not set, load it from the given address (e.g. alpine:latest)
+     */
+    defaultAddress: () => Promise<string>;
     /**
      * Only applies to arguments of type File or Directory. If the argument is not set, load it from the given path in the context directory
      */
@@ -4271,6 +4541,98 @@ export declare class GeneratedCode extends BaseClient {
      */
     with: (arg: (param: GeneratedCode) => GeneratedCode) => GeneratedCode;
 }
+export declare class Generator extends BaseClient {
+    private readonly _id?;
+    private readonly _completed?;
+    private readonly _description?;
+    private readonly _isEmpty?;
+    private readonly _name?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: GeneratorID, _completed?: boolean, _description?: string, _isEmpty?: boolean, _name?: string);
+    /**
+     * A unique identifier for this Generator.
+     */
+    id: () => Promise<GeneratorID>;
+    /**
+     * The generated changeset
+     */
+    changes: () => Changeset;
+    /**
+     * Whether the generator complete
+     */
+    completed: () => Promise<boolean>;
+    /**
+     * Return the description of the generator
+     */
+    description: () => Promise<string>;
+    /**
+     * Wether changeset from the generator execution is empty or not
+     */
+    isEmpty: () => Promise<boolean>;
+    /**
+     * Return the fully qualified name of the generator
+     */
+    name: () => Promise<string>;
+    /**
+     * The original module in which the generator has been defined
+     */
+    originalModule: () => Module_;
+    /**
+     * The path of the generator within its module
+     */
+    path: () => Promise<string[]>;
+    /**
+     * Execute the generator
+     */
+    run: () => Generator;
+    /**
+     * Call the provided function with current Generator.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: Generator) => Generator) => Generator;
+}
+export declare class GeneratorGroup extends BaseClient {
+    private readonly _id?;
+    private readonly _isEmpty?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: GeneratorGroupID, _isEmpty?: boolean);
+    /**
+     * A unique identifier for this GeneratorGroup.
+     */
+    id: () => Promise<GeneratorGroupID>;
+    /**
+     * The combined changes from the generators execution
+     *
+     * If any conflict occurs, for instance if the same file is modified by multiple generators, or if a file is both modified and deleted, an error is raised and the merge of the changesets will failed.
+     *
+     * Set 'continueOnConflicts' flag to force to merge the changes in a 'last write wins' strategy.
+     * @param opts.onConflict Strategy to apply on conflicts between generators
+     */
+    changes: (opts?: GeneratorGroupChangesOpts) => Changeset;
+    /**
+     * Whether the generated changeset is empty or not
+     */
+    isEmpty: () => Promise<boolean>;
+    /**
+     * Return a list of individual generators and their details
+     */
+    list: () => Promise<Generator[]>;
+    /**
+     * Execute all selected generators
+     */
+    run: () => GeneratorGroup;
+    /**
+     * Call the provided function with current GeneratorGroup.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: GeneratorGroup) => GeneratorGroup) => GeneratorGroup;
+}
 /**
  * A git ref (tag, branch, or commit).
  */
@@ -4827,6 +5189,18 @@ export declare class Module_ extends BaseClient {
      * The generated files and directories made on top of the module source's context directory.
      */
     generatedContextDirectory: () => Directory;
+    /**
+     * Return the generator defined by the module with the given name. Must match to exactly one generator.
+     * @param name The name of the generator to retrieve
+     * @experimental
+     */
+    generator: (name: string) => Generator;
+    /**
+     * Return all generators defined by the module
+     * @param opts.include Only include generators matching the specified patterns
+     * @experimental
+     */
+    generators: (opts?: ModuleGeneratorsOpts) => GeneratorGroup;
     /**
      * Interfaces served by this module.
      */
@@ -5321,6 +5695,12 @@ export declare class Client extends BaseClient {
      * The TypeDef representations of the objects currently being served in the session.
      */
     currentTypeDefs: () => Promise<TypeDef[]>;
+    /**
+     * Detect and return the current workspace.
+     * @param opts.skipMigrationCheck If true, skip legacy dagger.json migration checks.
+     * @experimental
+     */
+    currentWorkspace: (opts?: ClientCurrentWorkspaceOpts) => Workspace;
     /**
      * The default platform of the engine.
      */
@@ -5519,6 +5899,14 @@ export declare class Client extends BaseClient {
      * Load a GeneratedCode from its ID.
      */
     loadGeneratedCodeFromID: (id: GeneratedCodeID) => GeneratedCode;
+    /**
+     * Load a Generator from its ID.
+     */
+    loadGeneratorFromID: (id: GeneratorID) => Generator;
+    /**
+     * Load a GeneratorGroup from its ID.
+     */
+    loadGeneratorGroupFromID: (id: GeneratorGroupID) => GeneratorGroup;
     /**
      * Load a GitRef from its ID.
      */
@@ -5623,6 +6011,10 @@ export declare class Client extends BaseClient {
      * Load a TypeDef from its ID.
      */
     loadTypeDefFromID: (id: TypeDefID) => TypeDef;
+    /**
+     * Load a Workspace from its ID.
+     */
+    loadWorkspaceFromID: (id: WorkspaceID) => Workspace;
     /**
      * Create a new module.
      */
@@ -6118,6 +6510,58 @@ export declare class TypeDef extends BaseClient {
      */
     with: (arg: (param: TypeDef) => TypeDef) => TypeDef;
 }
+/**
+ * A Dagger workspace detected from the current working directory.
+ */
+export declare class Workspace extends BaseClient {
+    private readonly _id?;
+    private readonly _clientId?;
+    private readonly _findUp?;
+    private readonly _root?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: WorkspaceID, _clientId?: string, _findUp?: string, _root?: string);
+    /**
+     * A unique identifier for this Workspace.
+     */
+    id: () => Promise<WorkspaceID>;
+    /**
+     * The client ID that owns this workspace's host filesystem.
+     */
+    clientId: () => Promise<string>;
+    /**
+     * Returns a Directory from the workspace.
+     *
+     * Path is relative to workspace root. Use "." for the root directory.
+     * @param path Location of the directory to retrieve, relative to the workspace root (e.g., "src", ".").
+     * @param opts.exclude Exclude artifacts that match the given pattern (e.g., ["node_modules/", ".git*"]).
+     * @param opts.include Include only artifacts that match the given pattern (e.g., ["app/", "package.*"]).
+     * @param opts.gitignore Apply .gitignore filter rules inside the directory.
+     */
+    directory: (path: string, opts?: WorkspaceDirectoryOpts) => Directory;
+    /**
+     * Returns a File from the workspace.
+     *
+     * Path is relative to workspace root.
+     * @param path Location of the file to retrieve, relative to the workspace root (e.g., "go.mod").
+     */
+    file: (path: string) => File;
+    /**
+     * Search for a file or directory by walking up from the start path within the workspace.
+     *
+     * Returns the path relative to the workspace root if found, or null if not found.
+     *
+     * The search stops at the workspace root and will not traverse above it.
+     * @param name The name of the file or directory to search for.
+     * @param opts.from Path to start the search from, relative to the workspace root.
+     */
+    findUp: (name: string, opts?: WorkspaceFindUpOpts) => Promise<string>;
+    /**
+     * Absolute path to the workspace root directory.
+     */
+    root: () => Promise<string>;
+}
 export declare const dag: Client;
 export {};
 //# sourceMappingURL=client.gen.d.ts.map