@dagger.io/dagger 0.17.0 → 0.17.2

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

@@ -615,6 +615,16 @@ export type DirectoryExportOpts = {
      */
     wipe?: boolean;
 };
+export type DirectoryFilterOpts = {
+    /**
+     * 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[];
+};
 export type DirectoryTerminalOpts = {
     /**
      * If set, override the container's default terminal command and invoke these command arguments instead.
@@ -917,6 +927,12 @@ export type JSON = string & {
 export type LLMID = string & {
     __LLMID: never;
 };
+/**
+ * The `LLMTokenUsageID` scalar type represents an identifier for an object of type LLMTokenUsage.
+ */
+export type LLMTokenUsageID = string & {
+    __LLMTokenUsageID: never;
+};
 /**
  * The `LLMVariableID` scalar type represents an identifier for an object of type LLMVariable.
  */
@@ -2014,6 +2030,12 @@ export declare class Directory extends BaseClient {
      * @param path Location of the file to retrieve (e.g., "README.md").
      */
     file: (path: string) => File;
+    /**
+     * Retrieves this directory as per exclude/include filters.
+     * @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.*"]).
+     */
+    filter: (opts?: DirectoryFilterOpts) => Directory;
     /**
      * Returns a list of files and directories that matche the given pattern.
      * @param pattern Pattern to match (e.g., "*.md").
@@ -2901,6 +2923,7 @@ export declare class InterfaceTypeDef extends BaseClient {
 }
 export declare class LLM extends BaseClient {
     private readonly _id?;
+    private readonly _currentType?;
     private readonly _getString?;
     private readonly _historyJSON?;
     private readonly _lastReply?;
@@ -2911,84 +2934,77 @@ export declare class LLM extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: LLMID, _getString?: string, _historyJSON?: string, _lastReply?: string, _model?: string, _provider?: string, _sync?: LLMID, _tools?: string);
+    constructor(ctx?: Context, _id?: LLMID, _currentType?: string, _getString?: string, _historyJSON?: string, _lastReply?: string, _model?: string, _provider?: string, _sync?: LLMID, _tools?: string);
     /**
      * A unique identifier for this LLM.
      */
     id: () => Promise<LLMID>;
+    /**
+     * create a branch in the LLM's history
+     */
+    attempt: (number_: number) => LLM;
     /**
      * Retrieve a the current value in the LLM environment, of type CacheVolume
-     * @deprecated use get<TargetType> instead
      */
     cacheVolume: () => CacheVolume;
     /**
      * Retrieve a the current value in the LLM environment, of type Container
-     * @deprecated use get<TargetType> instead
      */
     container: () => Container;
     /**
      * Retrieve a the current value in the LLM environment, of type CurrentModule
-     * @deprecated use get<TargetType> instead
      */
     currentModule: () => CurrentModule;
+    /**
+     * returns the type of the current state
+     */
+    currentType: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type Directory
-     * @deprecated use get<TargetType> instead
      */
     directory: () => Directory;
     /**
      * Retrieve a the current value in the LLM environment, of type EnumTypeDef
-     * @deprecated use get<TargetType> instead
      */
     enumTypeDef: () => EnumTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type EnumValueTypeDef
-     * @deprecated use get<TargetType> instead
      */
     enumValueTypeDef: () => EnumValueTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type Error
-     * @deprecated use get<TargetType> instead
      */
     error: () => Error;
     /**
      * Retrieve a the current value in the LLM environment, of type ErrorValue
-     * @deprecated use get<TargetType> instead
      */
     errorValue: () => ErrorValue;
     /**
      * Retrieve a the current value in the LLM environment, of type FieldTypeDef
-     * @deprecated use get<TargetType> instead
      */
     fieldTypeDef: () => FieldTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type File
-     * @deprecated use get<TargetType> instead
      */
     file: () => File;
     /**
      * Retrieve a the current value in the LLM environment, of type Function
-     * @deprecated use get<TargetType> instead
      */
     function_: () => Function_;
     /**
      * Retrieve a the current value in the LLM environment, of type FunctionArg
-     * @deprecated use get<TargetType> instead
      */
     functionArg: () => FunctionArg;
     /**
      * Retrieve a the current value in the LLM environment, of type FunctionCall
-     * @deprecated use get<TargetType> instead
      */
     functionCall: () => FunctionCall;
     /**
      * Retrieve a the current value in the LLM environment, of type FunctionCallArgValue
-     * @deprecated use get<TargetType> instead
      */
     functionCallArgValue: () => FunctionCallArgValue;
     /**
      * Retrieve a the current value in the LLM environment, of type GeneratedCode
-     * @deprecated use get<TargetType> instead
      */
     generatedCode: () => GeneratedCode;
     /**
@@ -3163,12 +3179,10 @@ export declare class LLM extends BaseClient {
     getTypeDef: (name: string) => TypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type GitRef
-     * @deprecated use get<TargetType> instead
      */
     gitRef: () => GitRef;
     /**
      * Retrieve a the current value in the LLM environment, of type GitRepository
-     * @deprecated use get<TargetType> instead
      */
     gitRepository: () => GitRepository;
     /**
@@ -3181,17 +3195,14 @@ export declare class LLM extends BaseClient {
     historyJSON: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type InputTypeDef
-     * @deprecated use get<TargetType> instead
      */
     inputTypeDef: () => InputTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type InterfaceTypeDef
-     * @deprecated use get<TargetType> instead
      */
     interfaceTypeDef: () => InterfaceTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type LLM
-     * @deprecated use get<TargetType> instead
      */
     lLM: () => LLM;
     /**
@@ -3200,12 +3211,10 @@ export declare class LLM extends BaseClient {
     lastReply: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type ListTypeDef
-     * @deprecated use get<TargetType> instead
      */
     listTypeDef: () => ListTypeDef;
     /**
      * synchronize LLM state
-     * @deprecated use sync
      */
     loop: () => LLM;
     /**
@@ -3214,22 +3223,18 @@ export declare class LLM extends BaseClient {
     model: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type Module
-     * @deprecated use get<TargetType> instead
      */
     module_: () => Module_;
     /**
      * Retrieve a the current value in the LLM environment, of type ModuleConfigClient
-     * @deprecated use get<TargetType> instead
      */
     moduleConfigClient: () => ModuleConfigClient;
     /**
      * Retrieve a the current value in the LLM environment, of type ModuleSource
-     * @deprecated use get<TargetType> instead
      */
     moduleSource: () => ModuleSource;
     /**
      * Retrieve a the current value in the LLM environment, of type ObjectTypeDef
-     * @deprecated use get<TargetType> instead
      */
     objectTypeDef: () => ObjectTypeDef;
     /**
@@ -3238,22 +3243,18 @@ export declare class LLM extends BaseClient {
     provider: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type ScalarTypeDef
-     * @deprecated use get<TargetType> instead
      */
     scalarTypeDef: () => ScalarTypeDef;
     /**
      * Retrieve a the current value in the LLM environment, of type SDKConfig
-     * @deprecated use get<TargetType> instead
      */
     sdkconfig: () => SDKConfig;
     /**
      * Retrieve a the current value in the LLM environment, of type Secret
-     * @deprecated use get<TargetType> instead
      */
     secret: () => Secret;
     /**
      * Retrieve a the current value in the LLM environment, of type Service
-     * @deprecated use get<TargetType> instead
      */
     service: () => Service;
     /**
@@ -3462,12 +3463,10 @@ export declare class LLM extends BaseClient {
     setTypeDef: (name: string, value: TypeDef) => LLM;
     /**
      * Retrieve a the current value in the LLM environment, of type Socket
-     * @deprecated use get<TargetType> instead
      */
     socket: () => Socket;
     /**
      * Retrieve a the current value in the LLM environment, of type SourceMap
-     * @deprecated use get<TargetType> instead
      */
     sourceMap: () => SourceMap;
     /**
@@ -3476,16 +3475,18 @@ export declare class LLM extends BaseClient {
     sync: () => Promise<LLM>;
     /**
      * Retrieve a the current value in the LLM environment, of type Terminal
-     * @deprecated use get<TargetType> instead
      */
     terminal: () => Terminal;
+    /**
+     * returns the token usage of the current state
+     */
+    tokenUsage: () => LLMTokenUsage;
     /**
      * print documentation for available tools
      */
     tools: () => Promise<string>;
     /**
      * Retrieve a the current value in the LLM environment, of type TypeDef
-     * @deprecated use get<TargetType> instead
      */
     typeDef: () => TypeDef;
     /**
@@ -3495,127 +3496,106 @@ export declare class LLM extends BaseClient {
     /**
      * Set a variable of type CacheVolume in the llm environment
      * @param value The CacheVolume value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withCacheVolume: (value: CacheVolume) => LLM;
     /**
      * Set a variable of type Container in the llm environment
      * @param value The Container value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withContainer: (value: Container) => LLM;
     /**
      * Set a variable of type CurrentModule in the llm environment
      * @param value The CurrentModule value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withCurrentModule: (value: CurrentModule) => LLM;
     /**
      * Set a variable of type Directory in the llm environment
      * @param value The Directory value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withDirectory: (value: Directory) => LLM;
     /**
      * Set a variable of type EnumTypeDef in the llm environment
      * @param value The EnumTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withEnumTypeDef: (value: EnumTypeDef) => LLM;
     /**
      * Set a variable of type EnumValueTypeDef in the llm environment
      * @param value The EnumValueTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withEnumValueTypeDef: (value: EnumValueTypeDef) => LLM;
     /**
      * Set a variable of type Error in the llm environment
      * @param value The Error value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withError: (value: Error) => LLM;
     /**
      * Set a variable of type ErrorValue in the llm environment
      * @param value The ErrorValue value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withErrorValue: (value: ErrorValue) => LLM;
     /**
      * Set a variable of type FieldTypeDef in the llm environment
      * @param value The FieldTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFieldTypeDef: (value: FieldTypeDef) => LLM;
     /**
      * Set a variable of type File in the llm environment
      * @param value The File value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFile: (value: File) => LLM;
     /**
      * Set a variable of type Function in the llm environment
      * @param value The Function value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFunction: (value: Function_) => LLM;
     /**
      * Set a variable of type FunctionArg in the llm environment
      * @param value The FunctionArg value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFunctionArg: (value: FunctionArg) => LLM;
     /**
      * Set a variable of type FunctionCall in the llm environment
      * @param value The FunctionCall value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFunctionCall: (value: FunctionCall) => LLM;
     /**
      * Set a variable of type FunctionCallArgValue in the llm environment
      * @param value The FunctionCallArgValue value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withFunctionCallArgValue: (value: FunctionCallArgValue) => LLM;
     /**
      * Set a variable of type GeneratedCode in the llm environment
      * @param value The GeneratedCode value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withGeneratedCode: (value: GeneratedCode) => LLM;
     /**
      * Set a variable of type GitRef in the llm environment
      * @param value The GitRef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withGitRef: (value: GitRef) => LLM;
     /**
      * Set a variable of type GitRepository in the llm environment
      * @param value The GitRepository value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withGitRepository: (value: GitRepository) => LLM;
     /**
      * Set a variable of type InputTypeDef in the llm environment
      * @param value The InputTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withInputTypeDef: (value: InputTypeDef) => LLM;
     /**
      * Set a variable of type InterfaceTypeDef in the llm environment
      * @param value The InterfaceTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withInterfaceTypeDef: (value: InterfaceTypeDef) => LLM;
     /**
      * Set a variable of type LLM in the llm environment
      * @param value The LLM value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withLLM: (value: LLM) => LLM;
     /**
      * Set a variable of type ListTypeDef in the llm environment
      * @param value The ListTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withListTypeDef: (value: ListTypeDef) => LLM;
     /**
@@ -3626,25 +3606,21 @@ export declare class LLM extends BaseClient {
     /**
      * Set a variable of type Module in the llm environment
      * @param value The Module value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withModule: (value: Module_) => LLM;
     /**
      * Set a variable of type ModuleConfigClient in the llm environment
      * @param value The ModuleConfigClient value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withModuleConfigClient: (value: ModuleConfigClient) => LLM;
     /**
      * Set a variable of type ModuleSource in the llm environment
      * @param value The ModuleSource value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withModuleSource: (value: ModuleSource) => LLM;
     /**
      * Set a variable of type ObjectTypeDef in the llm environment
      * @param value The ObjectTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withObjectTypeDef: (value: ObjectTypeDef) => LLM;
     /**
@@ -3663,52 +3639,53 @@ export declare class LLM extends BaseClient {
      * @param value The variable value
      */
     withPromptVar: (name: string, value: string) => LLM;
+    /**
+     * Provide the entire Query object to the LLM
+     */
+    withQuery: () => LLM;
     /**
      * Set a variable of type SDKConfig in the llm environment
      * @param value The SDKConfig value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withSDKConfig: (value: SDKConfig) => LLM;
     /**
      * Set a variable of type ScalarTypeDef in the llm environment
      * @param value The ScalarTypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withScalarTypeDef: (value: ScalarTypeDef) => LLM;
     /**
      * Set a variable of type Secret in the llm environment
      * @param value The Secret value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withSecret: (value: Secret) => LLM;
     /**
      * Set a variable of type Service in the llm environment
      * @param value The Service value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withService: (value: Service) => LLM;
     /**
      * Set a variable of type Socket in the llm environment
      * @param value The Socket value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withSocket: (value: Socket) => LLM;
     /**
      * Set a variable of type SourceMap in the llm environment
      * @param value The SourceMap value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withSourceMap: (value: SourceMap) => LLM;
+    /**
+     * Add a system prompt to the LLM's environment
+     * @param prompt The system prompt to send
+     */
+    withSystemPrompt: (prompt: string) => LLM;
     /**
      * Set a variable of type Terminal in the llm environment
      * @param value The Terminal value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withTerminal: (value: Terminal) => LLM;
     /**
      * Set a variable of type TypeDef in the llm environment
      * @param value The TypeDef value to assign to the variable
-     * @deprecated use set<TargetType> instead
      */
     withTypeDef: (value: TypeDef) => LLM;
     /**
@@ -3718,6 +3695,23 @@ export declare class LLM extends BaseClient {
      */
     with: (arg: (param: LLM) => LLM) => LLM;
 }
+export declare class LLMTokenUsage extends BaseClient {
+    private readonly _id?;
+    private readonly _inputTokens?;
+    private readonly _outputTokens?;
+    private readonly _totalTokens?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: LLMTokenUsageID, _inputTokens?: number, _outputTokens?: number, _totalTokens?: number);
+    /**
+     * A unique identifier for this LLMTokenUsage.
+     */
+    id: () => Promise<LLMTokenUsageID>;
+    inputTokens: () => Promise<number>;
+    outputTokens: () => Promise<number>;
+    totalTokens: () => Promise<number>;
+}
 export declare class LLMVariable extends BaseClient {
     private readonly _id?;
     private readonly _hash?;
@@ -3942,7 +3936,7 @@ export declare class ModuleSource extends BaseClient {
      */
     cloneRef: () => Promise<string>;
     /**
-     * The resolved commit of the git repo this source points to. Only valid for git sources.
+     * The resolved commit of the git repo this source points to.
      */
     commit: () => Promise<string>;
     /**
@@ -3979,7 +3973,7 @@ export declare class ModuleSource extends BaseClient {
      */
     generatedContextDirectory: () => Directory;
     /**
-     * The URL to access the web view of the repository (e.g., GitHub, GitLab, Bitbucket). Only valid for git sources.
+     * The URL to access the web view of the repository (e.g., GitHub, GitLab, Bitbucket).
      */
     htmlRepoURL: () => Promise<string>;
     /**
@@ -4031,7 +4025,7 @@ export declare class ModuleSource extends BaseClient {
      */
     sync: () => Promise<ModuleSource>;
     /**
-     * The specified version of the git repo this source points to. Only valid for git sources.
+     * The specified version of the git repo this source points to.
      */
     version: () => Promise<string>;
     /**
@@ -4181,11 +4175,6 @@ export declare class Client extends BaseClient {
      * Get the Raw GraphQL client.
      */
     getGQLClient(): import("graphql-request").GraphQLClient;
-    /**
-     * Retrieves a container builtin to the engine.
-     * @param digest Digest of the image manifest
-     */
-    builtinContainer: (digest: string) => Container;
     /**
      * Constructs a cache volume for a given cache key.
      * @param key A string identifier to target this cache volume (e.g., "modules-cache").
@@ -4372,6 +4361,10 @@ export declare class Client extends BaseClient {
      * Load a LLM from its ID.
      */
     loadLLMFromID: (id: LLMID) => LLM;
+    /**
+     * Load a LLMTokenUsage from its ID.
+     */
+    loadLLMTokenUsageFromID: (id: LLMTokenUsageID) => LLMTokenUsage;
     /**
      * Load a LLMVariable from its ID.
      */