@dagger.io/dagger 0.18.16 → 0.18.18

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

@@ -53,6 +53,12 @@ export declare enum CacheSharingMode {
 export type CacheVolumeID = string & {
     __CacheVolumeID: never;
 };
+/**
+ * The `ChangesetID` scalar type represents an identifier for an object of type Changeset.
+ */
+export type ChangesetID = string & {
+    __ChangesetID: never;
+};
 /**
  * The `CloudID` scalar type represents an identifier for an object of type Cloud.
  */
@@ -691,6 +697,52 @@ export type DirectoryFilterOpts = {
      */
     include?: string[];
 };
+export type DirectorySearchOpts = {
+    /**
+     * Directory or file paths to search
+     */
+    paths?: string[];
+    /**
+     * Glob patterns to match (e.g., "*.md")
+     */
+    globs?: string[];
+    /**
+     * The text to match.
+     */
+    pattern: string;
+    /**
+     * Interpret the pattern as a literal string instead of a regular expression.
+     */
+    literal?: boolean;
+    /**
+     * Enable searching across multiple lines.
+     */
+    multiline?: boolean;
+    /**
+     * Allow the . pattern to match newlines in multiline mode.
+     */
+    dotall?: boolean;
+    /**
+     * Enable case-insensitive matching.
+     */
+    insensitive?: boolean;
+    /**
+     * Honor .gitignore, .ignore, and .rgignore files.
+     */
+    skipIgnored?: boolean;
+    /**
+     * Skip hidden files (files starting with .).
+     */
+    skipHidden?: boolean;
+    /**
+     * Only return matching files, not lines and content
+     */
+    filesOnly?: boolean;
+    /**
+     * Limit the number of results to return
+     */
+    limit?: number;
+};
 export type DirectoryTerminalOpts = {
     /**
      * If set, override the default container used for the terminal.
@@ -718,12 +770,28 @@ export type DirectoryWithDirectoryOpts = {
      * Include only artifacts that match the given pattern (e.g., ["app/", "package.*"]).
      */
     include?: string[];
+    /**
+     * A user:group to set for the copied directory and its contents.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
+     */
+    owner?: string;
 };
 export type DirectoryWithFileOpts = {
     /**
      * Permission given to the copied file (e.g., 0600).
      */
     permissions?: number;
+    /**
+     * A user:group to set for the copied directory and its contents.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
+     */
+    owner?: string;
 };
 export type DirectoryWithFilesOpts = {
     /**
@@ -794,6 +862,12 @@ export type EnumTypeDefID = string & {
 export type EnumValueTypeDefID = string & {
     __EnumValueTypeDefID: never;
 };
+/**
+ * The `EnvFileID` scalar type represents an identifier for an object of type EnvFile.
+ */
+export type EnvFileID = string & {
+    __EnvFileID: never;
+};
 /**
  * The `EnvID` scalar type represents an identifier for an object of type Env.
  */
@@ -841,6 +915,22 @@ export declare enum ExistsType {
 export type FieldTypeDefID = string & {
     __FieldTypeDefID: never;
 };
+export type FileAsEnvFileOpts = {
+    /**
+     * Replace "${VAR}" or "$VAR" with the value of other vars
+     */
+    expand?: boolean;
+};
+export type FileContentsOpts = {
+    /**
+     * Start reading after this line
+     */
+    offsetLines?: number;
+    /**
+     * Maximum number of lines to read
+     */
+    limitLines?: number;
+};
 export type FileDigestOpts = {
     /**
      * If true, exclude metadata from the digest.
@@ -853,6 +943,52 @@ export type FileExportOpts = {
      */
     allowParentDirPath?: boolean;
 };
+export type FileSearchOpts = {
+    /**
+     * Interpret the pattern as a literal string instead of a regular expression.
+     */
+    literal?: boolean;
+    /**
+     * Enable searching across multiple lines.
+     */
+    multiline?: boolean;
+    /**
+     * Allow the . pattern to match newlines in multiline mode.
+     */
+    dotall?: boolean;
+    /**
+     * Enable case-insensitive matching.
+     */
+    insensitive?: boolean;
+    /**
+     * Honor .gitignore, .ignore, and .rgignore files.
+     */
+    skipIgnored?: boolean;
+    /**
+     * Skip hidden files (files starting with .).
+     */
+    skipHidden?: boolean;
+    /**
+     * Only return matching files, not lines and content
+     */
+    filesOnly?: boolean;
+    /**
+     * Limit the number of results to return
+     */
+    limit?: number;
+    paths?: string[];
+    globs?: string[];
+};
+export type FileWithReplacedOpts = {
+    /**
+     * Replace all occurrences of the pattern.
+     */
+    all?: boolean;
+    /**
+     * Replace the first match starting from the specified line.
+     */
+    firstFrom?: number;
+};
 /**
  * The `FileID` scalar type represents an identifier for an object of type File.
  */
@@ -958,6 +1094,10 @@ export type HostDirectoryOpts = {
      * If true, the directory will always be reloaded from the host.
      */
     noCache?: boolean;
+    /**
+     * Apply .gitignore filter rules inside the directory
+     */
+    gitignore?: boolean;
 };
 export type HostFileOpts = {
     /**
@@ -965,6 +1105,9 @@ export type HostFileOpts = {
      */
     noCache?: boolean;
 };
+export type HostFindUpOpts = {
+    noCache?: boolean;
+};
 export type HostServiceOpts = {
     /**
      * Upstream host to forward traffic to.
@@ -1032,6 +1175,22 @@ export type InterfaceTypeDefID = string & {
 export type JSON = string & {
     __JSON: never;
 };
+export type JSONValueContentsOpts = {
+    /**
+     * Pretty-print
+     */
+    pretty?: boolean;
+    /**
+     * Optional line prefix
+     */
+    indent?: string;
+};
+/**
+ * The `JSONValueID` scalar type represents an identifier for an object of type JSONValue.
+ */
+export type JSONValueID = string & {
+    __JSONValueID: never;
+};
 /**
  * The `LLMID` scalar type represents an identifier for an object of type LLM.
  */
@@ -1158,6 +1317,12 @@ export type ClientEnvOpts = {
      */
     writable?: boolean;
 };
+export type ClientEnvFileOpts = {
+    /**
+     * Replace "${VAR}" or "$VAR" with the value of other vars
+     */
+    expand?: boolean;
+};
 export type ClientFileOpts = {
     /**
      * Permissions of the new file. Example: 0600
@@ -1279,6 +1444,18 @@ export type SDKConfigID = string & {
 export type ScalarTypeDefID = string & {
     __ScalarTypeDefID: never;
 };
+/**
+ * The `SearchResultID` scalar type represents an identifier for an object of type SearchResult.
+ */
+export type SearchResultID = string & {
+    __SearchResultID: never;
+};
+/**
+ * The `SearchSubmatchID` scalar type represents an identifier for an object of type SearchSubmatch.
+ */
+export type SearchSubmatchID = string & {
+    __SearchSubmatchID: never;
+};
 /**
  * The `SecretID` scalar type represents an identifier for an object of type Secret.
  */
@@ -1301,6 +1478,9 @@ export type ServiceStopOpts = {
      */
     kill?: boolean;
 };
+export type ServiceTerminalOpts = {
+    cmd?: string[];
+};
 export type ServiceUpOpts = {
     /**
      * List of frontend/backend port mappings to forward.
@@ -1553,6 +1733,10 @@ export declare class Binding extends BaseClient {
      * Retrieve the binding value, as type CacheVolume
      */
     asCacheVolume: () => CacheVolume;
+    /**
+     * Retrieve the binding value, as type Changeset
+     */
+    asChangeset: () => Changeset;
     /**
      * Retrieve the binding value, as type Cloud
      */
@@ -1569,6 +1753,10 @@ export declare class Binding extends BaseClient {
      * Retrieve the binding value, as type Env
      */
     asEnv: () => Env;
+    /**
+     * Retrieve the binding value, as type EnvFile
+     */
+    asEnvFile: () => EnvFile;
     /**
      * Retrieve the binding value, as type File
      */
@@ -1581,6 +1769,10 @@ export declare class Binding extends BaseClient {
      * Retrieve the binding value, as type GitRepository
      */
     asGitRepository: () => GitRepository;
+    /**
+     * Retrieve the binding value, as type JSONValue
+     */
+    asJSONValue: () => JSONValue;
     /**
      * Retrieve the binding value, as type LLM
      */
@@ -1597,6 +1789,14 @@ export declare class Binding extends BaseClient {
      * Retrieve the binding value, as type ModuleSource
      */
     asModuleSource: () => ModuleSource;
+    /**
+     * Retrieve the binding value, as type SearchResult
+     */
+    asSearchResult: () => SearchResult;
+    /**
+     * Retrieve the binding value, as type SearchSubmatch
+     */
+    asSearchSubmatch: () => SearchSubmatch;
     /**
      * Retrieve the binding value, as type Secret
      */
@@ -1644,6 +1844,53 @@ export declare class CacheVolume extends BaseClient {
      */
     id: () => Promise<CacheVolumeID>;
 }
+/**
+ * A comparison between two directories representing changes that can be applied.
+ */
+export declare class Changeset extends BaseClient {
+    private readonly _id?;
+    private readonly _sync?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: ChangesetID, _sync?: ChangesetID);
+    /**
+     * A unique identifier for this Changeset.
+     */
+    id: () => Promise<ChangesetID>;
+    /**
+     * Files and directories that were added in the newer directory.
+     */
+    addedPaths: () => Promise<string[]>;
+    /**
+     * The newer/upper snapshot.
+     */
+    after: () => Directory;
+    /**
+     * Return a Git-compatible patch of the changes
+     */
+    asPatch: () => File;
+    /**
+     * The older/lower snapshot to compare against.
+     */
+    before: () => Directory;
+    /**
+     * Return a snapshot containing only the created and modified files
+     */
+    layer: () => Directory;
+    /**
+     * Files and directories that existed before and were updated in the newer directory.
+     */
+    modifiedPaths: () => Promise<string[]>;
+    /**
+     * Files and directories that were removed. Directories are indicated by a trailing slash, and their child paths are not included.
+     */
+    removedPaths: () => Promise<string[]>;
+    /**
+     * Force evaluation in the engine.
+     */
+    sync: () => Promise<Changeset>;
+}
 /**
  * Dagger Cloud configuration and state
  */
@@ -1668,6 +1915,7 @@ export declare class Cloud extends BaseClient {
  */
 export declare class Container extends BaseClient {
     private readonly _id?;
+    private readonly _combinedOutput?;
     private readonly _envVariable?;
     private readonly _exists?;
     private readonly _exitCode?;
@@ -1686,7 +1934,7 @@ export declare class Container extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: ContainerID, _envVariable?: string, _exists?: boolean, _exitCode?: number, _export?: string, _exportImage?: Void, _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, _combinedOutput?: string, _envVariable?: string, _exists?: boolean, _exitCode?: number, _export?: string, _exportImage?: Void, _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.
      */
@@ -1737,6 +1985,12 @@ export declare class Container extends BaseClient {
      * @deprecated Use `Directory.build` instead
      */
     build: (context: Directory, opts?: ContainerBuildOpts) => Container;
+    /**
+     * The combined buffered standard output and standard error stream of the last executed command
+     *
+     * Returns an error if no command was executed
+     */
+    combinedOutput: () => Promise<string>;
     /**
      * Return the container's default arguments.
      */
@@ -2329,12 +2583,13 @@ export declare class Directory extends BaseClient {
     private readonly _digest?;
     private readonly _exists?;
     private readonly _export?;
+    private readonly _findUp?;
     private readonly _name?;
     private readonly _sync?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: DirectoryID, _digest?: string, _exists?: boolean, _export?: string, _name?: string, _sync?: DirectoryID);
+    constructor(ctx?: Context, _id?: DirectoryID, _digest?: string, _exists?: boolean, _export?: string, _findUp?: string, _name?: string, _sync?: DirectoryID);
     /**
      * A unique identifier for this Directory.
      */
@@ -2357,6 +2612,23 @@ export declare class Directory extends BaseClient {
      * If not set, the module source code is loaded from the root of the directory.
      */
     asModuleSource: (opts?: DirectoryAsModuleSourceOpts) => ModuleSource;
+    /**
+     * Return the difference between this directory and another directory, typically an older snapshot.
+     *
+     * The difference is encoded as a changeset, which also tracks removed files, and can be applied to other directories.
+     * @param from The base directory snapshot to compare against
+     */
+    changes: (from: Directory) => Changeset;
+    /**
+     * Change the owner of the directory contents recursively.
+     * @param path Path of the directory to change ownership of (e.g., "/").
+     * @param owner A user:group to set for the mounted directory and its contents.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
+     */
+    chown: (path: string, owner: string) => Directory;
     /**
      * Return the difference between this directory and an another directory. The difference is encoded as a directory.
      * @param other The directory to compare against
@@ -2414,6 +2686,12 @@ export declare class Directory extends BaseClient {
      * @param opts.include If set, only paths matching one of these glob patterns is included in the new snapshot. Example: (e.g., ["app/", "package.*"]).
      */
     filter: (opts?: DirectoryFilterOpts) => Directory;
+    /**
+     * Search up the directory tree for a file or directory, and return its path. If no match, return null
+     * @param name The name of the file or directory to search for
+     * @param start The path to start the search from
+     */
+    findUp: (name: string, start: string) => Promise<string>;
     /**
      * Returns a list of files and directories that matche the given pattern.
      * @param pattern Pattern to match (e.g., "*.md").
@@ -2423,6 +2701,23 @@ export declare class Directory extends BaseClient {
      * Returns the name of the directory.
      */
     name: () => Promise<string>;
+    /**
+     * Searches for content matching the given regular expression or literal string.
+     *
+     * Uses Rust regex syntax; escape literal ., [, ], {, }, | with backslashes.
+     * @param opts.paths Directory or file paths to search
+     * @param opts.globs Glob patterns to match (e.g., "*.md")
+     * @param opts.pattern The text to match.
+     * @param opts.literal Interpret the pattern as a literal string instead of a regular expression.
+     * @param opts.multiline Enable searching across multiple lines.
+     * @param opts.dotall Allow the . pattern to match newlines in multiline mode.
+     * @param opts.insensitive Enable case-insensitive matching.
+     * @param opts.skipIgnored Honor .gitignore, .ignore, and .rgignore files.
+     * @param opts.skipHidden Skip hidden files (files starting with .).
+     * @param opts.filesOnly Only return matching files, not lines and content
+     * @param opts.limit Limit the number of results to return
+     */
+    search: (opts?: DirectorySearchOpts) => Promise<SearchResult[]>;
     /**
      * Force evaluation in the engine.
      */
@@ -2435,12 +2730,22 @@ export declare class Directory extends BaseClient {
      * @param opts.insecureRootCapabilities Execute the command with all root capabilities. This is similar to running a command with "sudo" or executing "docker run" with the "--privileged" flag. Containerization does not provide any security guarantees when using this option. It should only be used when absolutely necessary and only with trusted commands.
      */
     terminal: (opts?: DirectoryTerminalOpts) => Directory;
+    /**
+     * Return a directory with changes from another directory applied to it.
+     * @param changes Changes to apply to the directory
+     */
+    withChanges: (changes: Changeset) => Directory;
     /**
      * Return a snapshot with a directory added
      * @param path Location of the written directory (e.g., "/src/").
      * @param directory Identifier of the directory to copy.
      * @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.owner A user:group to set for the copied directory and its contents.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
      */
     withDirectory: (path: string, directory: Directory, opts?: DirectoryWithDirectoryOpts) => Directory;
     /**
@@ -2448,6 +2753,11 @@ export declare class Directory extends BaseClient {
      * @param path Location of the copied file (e.g., "/file.txt").
      * @param source Identifier of the file to copy.
      * @param opts.permissions Permission given to the copied file (e.g., 0600).
+     * @param opts.owner A user:group to set for the copied directory and its contents.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
      */
     withFile: (path: string, source: File, opts?: DirectoryWithFileOpts) => Directory;
     /**
@@ -2476,6 +2786,12 @@ export declare class Directory extends BaseClient {
      * @experimental
      */
     withPatch: (patch: string) => Directory;
+    /**
+     * Retrieves this directory with the given Git-compatible patch file applied.
+     * @param patch File containing the patch to apply
+     * @experimental
+     */
+    withPatchFile: (patch: File) => Directory;
     /**
      * Return a snapshot with a symlink
      * @param target Location of the file or directory to link to (e.g., "/existing/file").
@@ -2759,6 +3075,19 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withCacheVolumeOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Changeset in the environment
+     * @param name The name of the binding
+     * @param value The Changeset value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withChangesetInput: (name: string, value: Changeset, description: string) => Env;
+    /**
+     * Declare a desired Changeset 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
+     */
+    withChangesetOutput: (name: string, description: string) => Env;
     /**
      * Create or update a binding of type Cloud in the environment
      * @param name The name of the binding
@@ -2798,6 +3127,19 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withDirectoryOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type EnvFile in the environment
+     * @param name The name of the binding
+     * @param value The EnvFile value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withEnvFileInput: (name: string, value: EnvFile, description: string) => Env;
+    /**
+     * Declare a desired EnvFile 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
+     */
+    withEnvFileOutput: (name: string, description: string) => Env;
     /**
      * Create or update a binding of type Env in the environment
      * @param name The name of the binding
@@ -2850,6 +3192,19 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withGitRepositoryOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type JSONValue in the environment
+     * @param name The name of the binding
+     * @param value The JSONValue value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withJSONValueInput: (name: string, value: JSONValue, description: string) => Env;
+    /**
+     * Declare a desired JSONValue 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
+     */
+    withJSONValueOutput: (name: string, description: string) => Env;
     /**
      * Create or update a binding of type LLM in the environment
      * @param name The name of the binding
@@ -2902,6 +3257,32 @@ export declare class Env extends BaseClient {
      * @param description A description of the desired value of the binding
      */
     withModuleSourceOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type SearchResult in the environment
+     * @param name The name of the binding
+     * @param value The SearchResult value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withSearchResultInput: (name: string, value: SearchResult, description: string) => Env;
+    /**
+     * Declare a desired SearchResult 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
+     */
+    withSearchResultOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type SearchSubmatch in the environment
+     * @param name The name of the binding
+     * @param value The SearchSubmatch value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withSearchSubmatchInput: (name: string, value: SearchSubmatch, description: string) => Env;
+    /**
+     * Declare a desired SearchSubmatch 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
+     */
+    withSearchSubmatchOutput: (name: string, description: string) => Env;
     /**
      * Create or update a binding of type Secret in the environment
      * @param name The name of the binding
@@ -2961,6 +3342,57 @@ export declare class Env extends BaseClient {
      */
     with: (arg: (param: Env) => Env) => Env;
 }
+/**
+ * A collection of environment variables.
+ */
+export declare class EnvFile extends BaseClient {
+    private readonly _id?;
+    private readonly _exists?;
+    private readonly _get?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: EnvFileID, _exists?: boolean, _get?: string);
+    /**
+     * A unique identifier for this EnvFile.
+     */
+    id: () => Promise<EnvFileID>;
+    /**
+     * Return as a file
+     */
+    asFile: () => File;
+    /**
+     * Check if a variable exists
+     * @param name Variable name
+     */
+    exists: (name: string) => Promise<boolean>;
+    /**
+     * Lookup a variable (last occurrence wins) and return its value, or an empty string
+     * @param name Variable name
+     */
+    get: (name: string) => Promise<string>;
+    /**
+     * Return all variables
+     */
+    variables: () => Promise<EnvVariable[]>;
+    /**
+     * Add a variable
+     * @param name Variable name
+     * @param value Variable value
+     */
+    withVariable: (name: string, value: string) => EnvFile;
+    /**
+     * Remove all occurrences of the named variable
+     * @param name Variable name
+     */
+    withoutVariable: (name: string) => EnvFile;
+    /**
+     * Call the provided function with current EnvFile.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: EnvFile) => EnvFile) => EnvFile;
+}
 /**
  * An environment variable name and value.
  */
@@ -3091,10 +3523,26 @@ export declare class File extends BaseClient {
      * A unique identifier for this File.
      */
     id: () => Promise<FileID>;
+    /**
+     * Parse as an env file
+     * @param opts.expand Replace "${VAR}" or "$VAR" with the value of other vars
+     */
+    asEnvFile: (opts?: FileAsEnvFileOpts) => EnvFile;
+    /**
+     * Change the owner of the file recursively.
+     * @param owner A user:group to set for the file.
+     *
+     * The user and group must be an ID (1000:1000), not a name (foo:bar).
+     *
+     * If the group is omitted, it defaults to the same as the user.
+     */
+    chown: (owner: string) => File;
     /**
      * Retrieves the contents of the file.
+     * @param opts.offsetLines Start reading after this line
+     * @param opts.limitLines Maximum number of lines to read
      */
-    contents: () => Promise<string>;
+    contents: (opts?: FileContentsOpts) => Promise<string>;
     /**
      * Return the file's digest. The format of the digest is not guaranteed to be stable between releases of Dagger. It is guaranteed to be stable between invocations of the same Dagger engine.
      * @param opts.excludeMetadata If true, exclude metadata from the digest.
@@ -3110,6 +3558,21 @@ export declare class File extends BaseClient {
      * Retrieves the name of the file.
      */
     name: () => Promise<string>;
+    /**
+     * Searches for content matching the given regular expression or literal string.
+     *
+     * Uses Rust regex syntax; escape literal ., [, ], {, }, | with backslashes.
+     * @param pattern The text to match.
+     * @param opts.literal Interpret the pattern as a literal string instead of a regular expression.
+     * @param opts.multiline Enable searching across multiple lines.
+     * @param opts.dotall Allow the . pattern to match newlines in multiline mode.
+     * @param opts.insensitive Enable case-insensitive matching.
+     * @param opts.skipIgnored Honor .gitignore, .ignore, and .rgignore files.
+     * @param opts.skipHidden Skip hidden files (files starting with .).
+     * @param opts.filesOnly Only return matching files, not lines and content
+     * @param opts.limit Limit the number of results to return
+     */
+    search: (pattern: string, opts?: FileSearchOpts) => Promise<SearchResult[]>;
     /**
      * Retrieves the size of the file, in bytes.
      */
@@ -3123,6 +3586,22 @@ export declare class File extends BaseClient {
      * @param name Name to set file to.
      */
     withName: (name: string) => File;
+    /**
+     * Retrieves the file with content replaced with the given text.
+     *
+     * If 'all' is true, all occurrences of the pattern will be replaced.
+     *
+     * If 'firstAfter' is specified, only the first match starting at the specified line will be replaced.
+     *
+     * If neither are specified, and there are multiple matches for the pattern, this will error.
+     *
+     * If there are no matches for the pattern, this will error.
+     * @param search The text to match.
+     * @param replacement The text to match.
+     * @param opts.all Replace all occurrences of the pattern.
+     * @param opts.firstFrom Replace the first match starting from the specified line.
+     */
+    withReplaced: (search: string, replacement: string, opts?: FileWithReplacedOpts) => File;
     /**
      * Retrieves this file with its created/modified timestamps set to the given time.
      * @param timestamp Timestamp to set dir/files in.
@@ -3405,10 +3884,11 @@ export declare class GitRef extends BaseClient {
  */
 export declare class GitRepository extends BaseClient {
     private readonly _id?;
+    private readonly _url?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: GitRepositoryID);
+    constructor(ctx?: Context, _id?: GitRepositoryID, _url?: string);
     /**
      * A unique identifier for this GitRepository.
      */
@@ -3451,6 +3931,10 @@ export declare class GitRepository extends BaseClient {
      * @param opts.patterns Glob patterns (e.g., "refs/tags/v*").
      */
     tags: (opts?: GitRepositoryTagsOpts) => Promise<string[]>;
+    /**
+     * The URL of the git repository.
+     */
+    url: () => Promise<string>;
     /**
      * Header to authenticate the remote with.
      * @param header Secret used to populate the Authorization HTTP header
@@ -3475,20 +3959,27 @@ export declare class GitRepository extends BaseClient {
  */
 export declare class Host extends BaseClient {
     private readonly _id?;
+    private readonly _findUp?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: HostID);
+    constructor(ctx?: Context, _id?: HostID, _findUp?: string);
     /**
      * A unique identifier for this Host.
      */
     id: () => Promise<HostID>;
+    /**
+     * Accesses a container image on the host.
+     * @param name Name of the image to access.
+     */
+    containerImage: (name: string) => Container;
     /**
      * Accesses a directory on the host.
      * @param path Location of the directory to access (e.g., ".").
      * @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.noCache If true, the directory will always be reloaded from the host.
+     * @param opts.gitignore Apply .gitignore filter rules inside the directory
      */
     directory: (path: string, opts?: HostDirectoryOpts) => Directory;
     /**
@@ -3497,6 +3988,11 @@ export declare class Host extends BaseClient {
      * @param opts.noCache If true, the file will always be reloaded from the host.
      */
     file: (path: string, opts?: HostFileOpts) => File;
+    /**
+     * Search for a file or directory by walking up the tree from system workdir. Return its relative path. If no match, return null
+     * @param name name of the file or directory to search for
+     */
+    findUp: (name: string, opts?: HostFindUpOpts) => Promise<string>;
     /**
      * Creates a service that forwards traffic to a specified address via the host.
      * @param ports Ports to expose via the service, forwarding through the host network.
@@ -3600,6 +4096,84 @@ export declare class InterfaceTypeDef extends BaseClient {
      */
     sourceModuleName: () => Promise<string>;
 }
+export declare class JSONValue extends BaseClient {
+    private readonly _id?;
+    private readonly _asBoolean?;
+    private readonly _asInteger?;
+    private readonly _asString?;
+    private readonly _contents?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: JSONValueID, _asBoolean?: boolean, _asInteger?: number, _asString?: string, _contents?: JSON);
+    /**
+     * A unique identifier for this JSONValue.
+     */
+    id: () => Promise<JSONValueID>;
+    /**
+     * Decode an array from json
+     */
+    asArray: () => Promise<JSONValue[]>;
+    /**
+     * Decode a boolean from json
+     */
+    asBoolean: () => Promise<boolean>;
+    /**
+     * Decode an integer from json
+     */
+    asInteger: () => Promise<number>;
+    /**
+     * Decode a string from json
+     */
+    asString: () => Promise<string>;
+    /**
+     * Return the value encoded as json
+     * @param opts.pretty Pretty-print
+     * @param opts.indent Optional line prefix
+     */
+    contents: (opts?: JSONValueContentsOpts) => Promise<JSON>;
+    /**
+     * Lookup the field at the given path, and return its value.
+     * @param path Path of the field to lookup, encoded as an array of field names
+     */
+    field: (path: string[]) => JSONValue;
+    /**
+     * List fields of the encoded object
+     */
+    fields: () => Promise<string[]>;
+    /**
+     * Encode a boolean to json
+     * @param value New boolean value
+     */
+    newBoolean: (value: boolean) => JSONValue;
+    /**
+     * Encode an integer to json
+     * @param value New integer value
+     */
+    newInteger: (value: number) => JSONValue;
+    /**
+     * Encode a string to json
+     * @param value New string value
+     */
+    newString: (value: string) => JSONValue;
+    /**
+     * Return a new json value, decoded from the given content
+     * @param contents New JSON-encoded contents
+     */
+    withContents: (contents: JSON) => JSONValue;
+    /**
+     * Set a new field at the given path
+     * @param path Path of the field to set, encoded as an array of field names
+     * @param value The new value of the field
+     */
+    withField: (path: string[], value: JSONValue) => JSONValue;
+    /**
+     * Call the provided function with current JSONValue.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: JSONValue) => JSONValue) => JSONValue;
+}
 export declare class LLM extends BaseClient {
     private readonly _id?;
     private readonly _historyJSON?;
@@ -4232,6 +4806,11 @@ export declare class Client extends BaseClient {
      * @experimental
      */
     env: (opts?: ClientEnvOpts) => Env;
+    /**
+     * Initialize an environment file
+     * @param opts.expand Replace "${VAR}" or "$VAR" with the value of other vars
+     */
+    envFile: (opts?: ClientEnvFileOpts) => EnvFile;
     /**
      * Create a new error.
      * @param message A brief description of the error.
@@ -4283,6 +4862,10 @@ export declare class Client extends BaseClient {
      * @param opts.experimentalServiceHost A service which must be started before the URL is fetched.
      */
     http: (url: string, opts?: ClientHttpOpts) => File;
+    /**
+     * Initialize a JSON value
+     */
+    json: () => JSONValue;
     /**
      * Initialize a Large Language Model (LLM)
      * @param opts.model Model to use
@@ -4298,6 +4881,10 @@ export declare class Client extends BaseClient {
      * Load a CacheVolume from its ID.
      */
     loadCacheVolumeFromID: (id: CacheVolumeID) => CacheVolume;
+    /**
+     * Load a Changeset from its ID.
+     */
+    loadChangesetFromID: (id: ChangesetID) => Changeset;
     /**
      * Load a Cloud from its ID.
      */
@@ -4338,6 +4925,10 @@ export declare class Client extends BaseClient {
      * Load a EnumValueTypeDef from its ID.
      */
     loadEnumValueTypeDefFromID: (id: EnumValueTypeDefID) => EnumValueTypeDef;
+    /**
+     * Load a EnvFile from its ID.
+     */
+    loadEnvFileFromID: (id: EnvFileID) => EnvFile;
     /**
      * Load a Env from its ID.
      */
@@ -4402,6 +4993,10 @@ export declare class Client extends BaseClient {
      * Load a InterfaceTypeDef from its ID.
      */
     loadInterfaceTypeDefFromID: (id: InterfaceTypeDefID) => InterfaceTypeDef;
+    /**
+     * Load a JSONValue from its ID.
+     */
+    loadJSONValueFromID: (id: JSONValueID) => JSONValue;
     /**
      * Load a LLM from its ID.
      */
@@ -4446,6 +5041,14 @@ export declare class Client extends BaseClient {
      * Load a ScalarTypeDef from its ID.
      */
     loadScalarTypeDefFromID: (id: ScalarTypeDefID) => ScalarTypeDef;
+    /**
+     * Load a SearchResult from its ID.
+     */
+    loadSearchResultFromID: (id: SearchResultID) => SearchResult;
+    /**
+     * Load a SearchSubmatch from its ID.
+     */
+    loadSearchSubmatchFromID: (id: SearchSubmatchID) => SearchSubmatch;
     /**
      * Load a Secret from its ID.
      */
@@ -4565,6 +5168,67 @@ export declare class ScalarTypeDef extends BaseClient {
      */
     sourceModuleName: () => Promise<string>;
 }
+export declare class SearchResult extends BaseClient {
+    private readonly _id?;
+    private readonly _absoluteOffset?;
+    private readonly _filePath?;
+    private readonly _lineNumber?;
+    private readonly _matchedLines?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: SearchResultID, _absoluteOffset?: number, _filePath?: string, _lineNumber?: number, _matchedLines?: string);
+    /**
+     * A unique identifier for this SearchResult.
+     */
+    id: () => Promise<SearchResultID>;
+    /**
+     * The byte offset of this line within the file.
+     */
+    absoluteOffset: () => Promise<number>;
+    /**
+     * The path to the file that matched.
+     */
+    filePath: () => Promise<string>;
+    /**
+     * The first line that matched.
+     */
+    lineNumber: () => Promise<number>;
+    /**
+     * The line content that matched.
+     */
+    matchedLines: () => Promise<string>;
+    /**
+     * Sub-match positions and content within the matched lines.
+     */
+    submatches: () => Promise<SearchSubmatch[]>;
+}
+export declare class SearchSubmatch extends BaseClient {
+    private readonly _id?;
+    private readonly _end?;
+    private readonly _start?;
+    private readonly _text?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: SearchSubmatchID, _end?: number, _start?: number, _text?: string);
+    /**
+     * A unique identifier for this SearchSubmatch.
+     */
+    id: () => Promise<SearchSubmatchID>;
+    /**
+     * The match's end offset within the matched lines.
+     */
+    end: () => Promise<number>;
+    /**
+     * The match's start offset within the matched lines.
+     */
+    start: () => Promise<number>;
+    /**
+     * The matched text.
+     */
+    text: () => Promise<string>;
+}
 /**
  * A reference to a secret value, which can be handled more safely than the value itself.
  */
@@ -4603,11 +5267,12 @@ export declare class Service extends BaseClient {
     private readonly _hostname?;
     private readonly _start?;
     private readonly _stop?;
+    private readonly _sync?;
     private readonly _up?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(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, _sync?: ServiceID, _up?: Void);
     /**
      * A unique identifier for this Service.
      */
@@ -4641,6 +5306,11 @@ export declare class Service extends BaseClient {
      * @param opts.kill Immediately kill the service without waiting for a graceful exit
      */
     stop: (opts?: ServiceStopOpts) => Promise<Service>;
+    /**
+     * Forces evaluation of the pipeline in the engine.
+     */
+    sync: () => Promise<Service>;
+    terminal: (opts?: ServiceTerminalOpts) => Service;
     /**
      * Creates a tunnel that forwards traffic from the caller's network to this service.
      * @param opts.ports List of frontend/backend port mappings to forward.