@dagger.io/dagger 0.18.16 → 0.18.17

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

@@ -691,6 +691,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.
@@ -841,6 +887,16 @@ export declare enum ExistsType {
 export type FieldTypeDefID = string & {
     __FieldTypeDefID: never;
 };
+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 +909,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 +1060,10 @@ export type HostDirectoryOpts = {
      * If true, the directory will always be reloaded from the host.
      */
     noCache?: boolean;
+    /**
+     * Don't apply .gitignore filter rules inside the directory
+     */
+    noGitAutoIgnore?: boolean;
 };
 export type HostFileOpts = {
     /**
@@ -1032,6 +1138,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.
  */
@@ -1279,6 +1401,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 +1435,9 @@ export type ServiceStopOpts = {
      */
     kill?: boolean;
 };
+export type ServiceTerminalOpts = {
+    cmd?: string[];
+};
 export type ServiceUpOpts = {
     /**
      * List of frontend/backend port mappings to forward.
@@ -1581,6 +1718,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 +1738,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
      */
@@ -1668,6 +1817,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 +1836,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 +1887,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.
      */
@@ -2423,6 +2579,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.
      */
@@ -2850,6 +3023,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 +3088,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
@@ -3093,8 +3305,10 @@ export declare class File extends BaseClient {
     id: () => Promise<FileID>;
     /**
      * 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 +3324,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 +3352,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 +3650,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 +3697,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
@@ -3483,12 +3733,18 @@ export declare class Host extends BaseClient {
      * 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.noGitAutoIgnore Don't apply .gitignore filter rules inside the directory
      */
     directory: (path: string, opts?: HostDirectoryOpts) => Directory;
     /**
@@ -3600,6 +3856,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?;
@@ -4283,6 +4617,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
@@ -4402,6 +4740,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 +4788,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 +4915,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 +5014,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 +5053,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.