@dagger.io/dagger 0.17.1 → 0.18.0

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

@@ -14,6 +14,12 @@ declare class BaseClient {
      */
     constructor(_ctx?: Context);
 }
+/**
+ * The `BindingID` scalar type represents an identifier for an object of type Binding.
+ */
+export type BindingID = string & {
+    __BindingID: never;
+};
 export type BuildArg = {
     /**
      * The build argument name.
@@ -615,6 +621,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.
@@ -714,6 +730,12 @@ export type EnumTypeDefID = string & {
 export type EnumValueTypeDefID = string & {
     __EnumValueTypeDefID: never;
 };
+/**
+ * The `EnvID` scalar type represents an identifier for an object of type Env.
+ */
+export type EnvID = string & {
+    __EnvID: never;
+};
 /**
  * The `EnvVariableID` scalar type represents an identifier for an object of type EnvVariable.
  */
@@ -918,10 +940,10 @@ export type LLMID = string & {
     __LLMID: never;
 };
 /**
- * The `LLMVariableID` scalar type represents an identifier for an object of type LLMVariable.
+ * The `LLMTokenUsageID` scalar type represents an identifier for an object of type LLMTokenUsage.
  */
-export type LLMVariableID = string & {
-    __LLMVariableID: never;
+export type LLMTokenUsageID = string & {
+    __LLMTokenUsageID: never;
 };
 /**
  * The `LabelID` scalar type represents an identifier for an object of type Label.
@@ -1289,6 +1311,88 @@ export type __TypeEnumValuesOpts = {
 export type __TypeFieldsOpts = {
     includeDeprecated?: boolean;
 };
+export declare class Binding extends BaseClient {
+    private readonly _id?;
+    private readonly _digest?;
+    private readonly _name?;
+    private readonly _typeName?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: BindingID, _digest?: string, _name?: string, _typeName?: string);
+    /**
+     * A unique identifier for this Binding.
+     */
+    id: () => Promise<BindingID>;
+    /**
+     * Retrieve the binding value, as type CacheVolume
+     */
+    asCacheVolume: () => CacheVolume;
+    /**
+     * Retrieve the binding value, as type Container
+     */
+    asContainer: () => Container;
+    /**
+     * Retrieve the binding value, as type Directory
+     */
+    asDirectory: () => Directory;
+    /**
+     * Retrieve the binding value, as type Env
+     */
+    asEnv: () => Env;
+    /**
+     * Retrieve the binding value, as type File
+     */
+    asFile: () => File;
+    /**
+     * Retrieve the binding value, as type GitRef
+     */
+    asGitRef: () => GitRef;
+    /**
+     * Retrieve the binding value, as type GitRepository
+     */
+    asGitRepository: () => GitRepository;
+    /**
+     * Retrieve the binding value, as type LLM
+     */
+    asLLM: () => LLM;
+    /**
+     * Retrieve the binding value, as type Module
+     */
+    asModule: () => Module_;
+    /**
+     * Retrieve the binding value, as type ModuleConfigClient
+     */
+    asModuleConfigClient: () => ModuleConfigClient;
+    /**
+     * Retrieve the binding value, as type ModuleSource
+     */
+    asModuleSource: () => ModuleSource;
+    /**
+     * Retrieve the binding value, as type Secret
+     */
+    asSecret: () => Secret;
+    /**
+     * Retrieve the binding value, as type Service
+     */
+    asService: () => Service;
+    /**
+     * Retrieve the binding value, as type Socket
+     */
+    asSocket: () => Socket;
+    /**
+     * The digest of the binding value
+     */
+    digest: () => Promise<string>;
+    /**
+     * The binding name
+     */
+    name: () => Promise<string>;
+    /**
+     * The binding type
+     */
+    typeName: () => Promise<string>;
+}
 /**
  * A directory whose contents persist across runs.
  */
@@ -2014,6 +2118,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").
@@ -2292,6 +2402,227 @@ export declare class EnumValueTypeDef extends BaseClient {
      */
     sourceMap: () => SourceMap;
 }
+export declare class Env extends BaseClient {
+    private readonly _id?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(ctx?: Context, _id?: EnvID);
+    /**
+     * A unique identifier for this Env.
+     */
+    id: () => Promise<EnvID>;
+    /**
+     * retrieve an input value by name
+     */
+    input: (name: string) => Binding;
+    /**
+     * return all input values for the environment
+     */
+    inputs: () => Promise<Binding[]>;
+    /**
+     * retrieve an output value by name
+     */
+    output: (name: string) => Binding;
+    /**
+     * return all output values for the environment
+     */
+    outputs: () => Promise<Binding[]>;
+    /**
+     * Create or update a binding of type CacheVolume in the environment
+     * @param name The name of the binding
+     * @param value The CacheVolume value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withCacheVolumeInput: (name: string, value: CacheVolume, description: string) => Env;
+    /**
+     * Declare a desired CacheVolume 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
+     */
+    withCacheVolumeOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Container in the environment
+     * @param name The name of the binding
+     * @param value The Container value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withContainerInput: (name: string, value: Container, description: string) => Env;
+    /**
+     * Declare a desired Container 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
+     */
+    withContainerOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Directory in the environment
+     * @param name The name of the binding
+     * @param value The Directory value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withDirectoryInput: (name: string, value: Directory, description: string) => Env;
+    /**
+     * Declare a desired Directory 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
+     */
+    withDirectoryOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Env in the environment
+     * @param name The name of the binding
+     * @param value The Env value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withEnvInput: (name: string, value: Env, description: string) => Env;
+    /**
+     * Declare a desired Env 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
+     */
+    withEnvOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type File in the environment
+     * @param name The name of the binding
+     * @param value The File value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withFileInput: (name: string, value: File, description: string) => Env;
+    /**
+     * Declare a desired File 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
+     */
+    withFileOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type GitRef in the environment
+     * @param name The name of the binding
+     * @param value The GitRef value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withGitRefInput: (name: string, value: GitRef, description: string) => Env;
+    /**
+     * Declare a desired GitRef 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
+     */
+    withGitRefOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type GitRepository in the environment
+     * @param name The name of the binding
+     * @param value The GitRepository value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withGitRepositoryInput: (name: string, value: GitRepository, description: string) => Env;
+    /**
+     * Declare a desired GitRepository 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
+     */
+    withGitRepositoryOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type LLM in the environment
+     * @param name The name of the binding
+     * @param value The LLM value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withLLMInput: (name: string, value: LLM, description: string) => Env;
+    /**
+     * Declare a desired LLM 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
+     */
+    withLLMOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type ModuleConfigClient in the environment
+     * @param name The name of the binding
+     * @param value The ModuleConfigClient value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withModuleConfigClientInput: (name: string, value: ModuleConfigClient, description: string) => Env;
+    /**
+     * Declare a desired ModuleConfigClient 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
+     */
+    withModuleConfigClientOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Module in the environment
+     * @param name The name of the binding
+     * @param value The Module value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withModuleInput: (name: string, value: Module_, description: string) => Env;
+    /**
+     * Declare a desired Module 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
+     */
+    withModuleOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type ModuleSource in the environment
+     * @param name The name of the binding
+     * @param value The ModuleSource value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withModuleSourceInput: (name: string, value: ModuleSource, description: string) => Env;
+    /**
+     * Declare a desired ModuleSource 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
+     */
+    withModuleSourceOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Secret in the environment
+     * @param name The name of the binding
+     * @param value The Secret value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withSecretInput: (name: string, value: Secret, description: string) => Env;
+    /**
+     * Declare a desired Secret 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
+     */
+    withSecretOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Service in the environment
+     * @param name The name of the binding
+     * @param value The Service value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withServiceInput: (name: string, value: Service, description: string) => Env;
+    /**
+     * Declare a desired Service 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
+     */
+    withServiceOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update a binding of type Socket in the environment
+     * @param name The name of the binding
+     * @param value The Socket value to assign to the binding
+     * @param description The purpose of the input
+     */
+    withSocketInput: (name: string, value: Socket, description: string) => Env;
+    /**
+     * Declare a desired Socket 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
+     */
+    withSocketOutput: (name: string, description: string) => Env;
+    /**
+     * Create or update an input value of type string
+     * @param name The name of the binding
+     * @param value The string value to assign to the binding
+     */
+    withStringInput: (name: string, value: string, description: string) => Env;
+    /**
+     * Call the provided function with current Env.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with: (arg: (param: Env) => Env) => Env;
+}
 /**
  * An environment variable name and value.
  */
@@ -2901,8 +3232,6 @@ 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?;
     private readonly _model?;
@@ -2912,253 +3241,23 @@ export declare class LLM extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: LLMID, _currentType?: string, _getString?: string, _historyJSON?: string, _lastReply?: string, _model?: string, _provider?: string, _sync?: LLMID, _tools?: string);
+    constructor(ctx?: Context, _id?: LLMID, _historyJSON?: string, _lastReply?: string, _model?: string, _provider?: string, _sync?: LLMID, _tools?: string);
     /**
      * A unique identifier for this LLM.
      */
     id: () => Promise<LLMID>;
     /**
-     * Retrieve a the current value in the LLM environment, of type CacheVolume
-     */
-    cacheVolume: () => CacheVolume;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Container
+     * create a branch in the LLM's history
      */
-    container: () => Container;
-    /**
-     * Retrieve a the current value in the LLM environment, of type CurrentModule
-     */
-    currentModule: () => CurrentModule;
+    attempt: (number_: number) => LLM;
     /**
      * returns the type of the current state
      */
-    currentType: () => Promise<string>;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Directory
-     */
-    directory: () => Directory;
-    /**
-     * Retrieve a the current value in the LLM environment, of type EnumTypeDef
-     */
-    enumTypeDef: () => EnumTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type EnumValueTypeDef
-     */
-    enumValueTypeDef: () => EnumValueTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Error
-     */
-    error: () => Error;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ErrorValue
-     */
-    errorValue: () => ErrorValue;
-    /**
-     * Retrieve a the current value in the LLM environment, of type FieldTypeDef
-     */
-    fieldTypeDef: () => FieldTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type File
-     */
-    file: () => File;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Function
-     */
-    function_: () => Function_;
-    /**
-     * Retrieve a the current value in the LLM environment, of type FunctionArg
-     */
-    functionArg: () => FunctionArg;
-    /**
-     * Retrieve a the current value in the LLM environment, of type FunctionCall
-     */
-    functionCall: () => FunctionCall;
-    /**
-     * Retrieve a the current value in the LLM environment, of type FunctionCallArgValue
-     */
-    functionCallArgValue: () => FunctionCallArgValue;
-    /**
-     * Retrieve a the current value in the LLM environment, of type GeneratedCode
-     */
-    generatedCode: () => GeneratedCode;
-    /**
-     * Retrieve a variable in the llm environment, of type CacheVolume
-     * @param name The name of the variable
-     */
-    getCacheVolume: (name: string) => CacheVolume;
-    /**
-     * Retrieve a variable in the llm environment, of type Container
-     * @param name The name of the variable
-     */
-    getContainer: (name: string) => Container;
-    /**
-     * Retrieve a variable in the llm environment, of type CurrentModule
-     * @param name The name of the variable
-     */
-    getCurrentModule: (name: string) => CurrentModule;
-    /**
-     * Retrieve a variable in the llm environment, of type Directory
-     * @param name The name of the variable
-     */
-    getDirectory: (name: string) => Directory;
-    /**
-     * Retrieve a variable in the llm environment, of type EnumTypeDef
-     * @param name The name of the variable
-     */
-    getEnumTypeDef: (name: string) => EnumTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type EnumValueTypeDef
-     * @param name The name of the variable
-     */
-    getEnumValueTypeDef: (name: string) => EnumValueTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type Error
-     * @param name The name of the variable
-     */
-    getError: (name: string) => Error;
-    /**
-     * Retrieve a variable in the llm environment, of type ErrorValue
-     * @param name The name of the variable
-     */
-    getErrorValue: (name: string) => ErrorValue;
-    /**
-     * Retrieve a variable in the llm environment, of type FieldTypeDef
-     * @param name The name of the variable
-     */
-    getFieldTypeDef: (name: string) => FieldTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type File
-     * @param name The name of the variable
-     */
-    getFile: (name: string) => File;
-    /**
-     * Retrieve a variable in the llm environment, of type Function
-     * @param name The name of the variable
-     */
-    getFunction: (name: string) => Function_;
-    /**
-     * Retrieve a variable in the llm environment, of type FunctionArg
-     * @param name The name of the variable
-     */
-    getFunctionArg: (name: string) => FunctionArg;
-    /**
-     * Retrieve a variable in the llm environment, of type FunctionCall
-     * @param name The name of the variable
-     */
-    getFunctionCall: (name: string) => FunctionCall;
-    /**
-     * Retrieve a variable in the llm environment, of type FunctionCallArgValue
-     * @param name The name of the variable
-     */
-    getFunctionCallArgValue: (name: string) => FunctionCallArgValue;
-    /**
-     * Retrieve a variable in the llm environment, of type GeneratedCode
-     * @param name The name of the variable
-     */
-    getGeneratedCode: (name: string) => GeneratedCode;
-    /**
-     * Retrieve a variable in the llm environment, of type GitRef
-     * @param name The name of the variable
-     */
-    getGitRef: (name: string) => GitRef;
-    /**
-     * Retrieve a variable in the llm environment, of type GitRepository
-     * @param name The name of the variable
-     */
-    getGitRepository: (name: string) => GitRepository;
-    /**
-     * Retrieve a variable in the llm environment, of type InputTypeDef
-     * @param name The name of the variable
-     */
-    getInputTypeDef: (name: string) => InputTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type InterfaceTypeDef
-     * @param name The name of the variable
-     */
-    getInterfaceTypeDef: (name: string) => InterfaceTypeDef;
+    bindResult: (name: string) => Binding;
     /**
-     * Retrieve a variable in the llm environment, of type LLM
-     * @param name The name of the variable
+     * return the LLM's current environment
      */
-    getLLM: (name: string) => LLM;
-    /**
-     * Retrieve a variable in the llm environment, of type ListTypeDef
-     * @param name The name of the variable
-     */
-    getListTypeDef: (name: string) => ListTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type Module
-     * @param name The name of the variable
-     */
-    getModule: (name: string) => Module_;
-    /**
-     * Retrieve a variable in the llm environment, of type ModuleConfigClient
-     * @param name The name of the variable
-     */
-    getModuleConfigClient: (name: string) => ModuleConfigClient;
-    /**
-     * Retrieve a variable in the llm environment, of type ModuleSource
-     * @param name The name of the variable
-     */
-    getModuleSource: (name: string) => ModuleSource;
-    /**
-     * Retrieve a variable in the llm environment, of type ObjectTypeDef
-     * @param name The name of the variable
-     */
-    getObjectTypeDef: (name: string) => ObjectTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type SDKConfig
-     * @param name The name of the variable
-     */
-    getSDKConfig: (name: string) => SDKConfig;
-    /**
-     * Retrieve a variable in the llm environment, of type ScalarTypeDef
-     * @param name The name of the variable
-     */
-    getScalarTypeDef: (name: string) => ScalarTypeDef;
-    /**
-     * Retrieve a variable in the llm environment, of type Secret
-     * @param name The name of the variable
-     */
-    getSecret: (name: string) => Secret;
-    /**
-     * Retrieve a variable in the llm environment, of type Service
-     * @param name The name of the variable
-     */
-    getService: (name: string) => Service;
-    /**
-     * Retrieve a variable in the llm environment, of type Socket
-     * @param name The name of the variable
-     */
-    getSocket: (name: string) => Socket;
-    /**
-     * Retrieve a variable in the llm environment, of type SourceMap
-     * @param name The name of the variable
-     */
-    getSourceMap: (name: string) => SourceMap;
-    /**
-     * Get a string variable from the LLM's environment
-     * @param name The variable name
-     */
-    getString: (name: string) => Promise<string>;
-    /**
-     * Retrieve a variable in the llm environment, of type Terminal
-     * @param name The name of the variable
-     */
-    getTerminal: (name: string) => Terminal;
-    /**
-     * Retrieve a variable in the llm environment, of type TypeDef
-     * @param name The name of the variable
-     */
-    getTypeDef: (name: string) => TypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type GitRef
-     */
-    gitRef: () => GitRef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type GitRepository
-     */
-    gitRepository: () => GitRepository;
+    env: () => Env;
     /**
      * return the llm message history
      */
@@ -3167,26 +3266,10 @@ export declare class LLM extends BaseClient {
      * return the raw llm message history as json
      */
     historyJSON: () => Promise<string>;
-    /**
-     * Retrieve a the current value in the LLM environment, of type InputTypeDef
-     */
-    inputTypeDef: () => InputTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type InterfaceTypeDef
-     */
-    interfaceTypeDef: () => InterfaceTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type LLM
-     */
-    lLM: () => LLM;
     /**
      * return the last llm reply from the history
      */
     lastReply: () => Promise<string>;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ListTypeDef
-     */
-    listTypeDef: () => ListTypeDef;
     /**
      * synchronize LLM state
      */
@@ -3195,404 +3278,31 @@ export declare class LLM extends BaseClient {
      * return the model used by the llm
      */
     model: () => Promise<string>;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Module
-     */
-    module_: () => Module_;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ModuleConfigClient
-     */
-    moduleConfigClient: () => ModuleConfigClient;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ModuleSource
-     */
-    moduleSource: () => ModuleSource;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ObjectTypeDef
-     */
-    objectTypeDef: () => ObjectTypeDef;
     /**
      * return the provider used by the llm
      */
     provider: () => Promise<string>;
-    /**
-     * Retrieve a the current value in the LLM environment, of type ScalarTypeDef
-     */
-    scalarTypeDef: () => ScalarTypeDef;
-    /**
-     * Retrieve a the current value in the LLM environment, of type SDKConfig
-     */
-    sdkconfig: () => SDKConfig;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Secret
-     */
-    secret: () => Secret;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Service
-     */
-    service: () => Service;
-    /**
-     * Set a variable of type CacheVolume in the llm environment
-     * @param name The name of the variable
-     * @param value The CacheVolume value to assign to the variable
-     */
-    setCacheVolume: (name: string, value: CacheVolume) => LLM;
-    /**
-     * Set a variable of type Container in the llm environment
-     * @param name The name of the variable
-     * @param value The Container value to assign to the variable
-     */
-    setContainer: (name: string, value: Container) => LLM;
-    /**
-     * Set a variable of type CurrentModule in the llm environment
-     * @param name The name of the variable
-     * @param value The CurrentModule value to assign to the variable
-     */
-    setCurrentModule: (name: string, value: CurrentModule) => LLM;
-    /**
-     * Set a variable of type Directory in the llm environment
-     * @param name The name of the variable
-     * @param value The Directory value to assign to the variable
-     */
-    setDirectory: (name: string, value: Directory) => LLM;
-    /**
-     * Set a variable of type EnumTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The EnumTypeDef value to assign to the variable
-     */
-    setEnumTypeDef: (name: string, value: EnumTypeDef) => LLM;
-    /**
-     * Set a variable of type EnumValueTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The EnumValueTypeDef value to assign to the variable
-     */
-    setEnumValueTypeDef: (name: string, value: EnumValueTypeDef) => LLM;
-    /**
-     * Set a variable of type Error in the llm environment
-     * @param name The name of the variable
-     * @param value The Error value to assign to the variable
-     */
-    setError: (name: string, value: Error) => LLM;
-    /**
-     * Set a variable of type ErrorValue in the llm environment
-     * @param name The name of the variable
-     * @param value The ErrorValue value to assign to the variable
-     */
-    setErrorValue: (name: string, value: ErrorValue) => LLM;
-    /**
-     * Set a variable of type FieldTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The FieldTypeDef value to assign to the variable
-     */
-    setFieldTypeDef: (name: string, value: FieldTypeDef) => LLM;
-    /**
-     * Set a variable of type File in the llm environment
-     * @param name The name of the variable
-     * @param value The File value to assign to the variable
-     */
-    setFile: (name: string, value: File) => LLM;
-    /**
-     * Set a variable of type Function in the llm environment
-     * @param name The name of the variable
-     * @param value The Function value to assign to the variable
-     */
-    setFunction: (name: string, value: Function_) => LLM;
-    /**
-     * Set a variable of type FunctionArg in the llm environment
-     * @param name The name of the variable
-     * @param value The FunctionArg value to assign to the variable
-     */
-    setFunctionArg: (name: string, value: FunctionArg) => LLM;
-    /**
-     * Set a variable of type FunctionCall in the llm environment
-     * @param name The name of the variable
-     * @param value The FunctionCall value to assign to the variable
-     */
-    setFunctionCall: (name: string, value: FunctionCall) => LLM;
-    /**
-     * Set a variable of type FunctionCallArgValue in the llm environment
-     * @param name The name of the variable
-     * @param value The FunctionCallArgValue value to assign to the variable
-     */
-    setFunctionCallArgValue: (name: string, value: FunctionCallArgValue) => LLM;
-    /**
-     * Set a variable of type GeneratedCode in the llm environment
-     * @param name The name of the variable
-     * @param value The GeneratedCode value to assign to the variable
-     */
-    setGeneratedCode: (name: string, value: GeneratedCode) => LLM;
-    /**
-     * Set a variable of type GitRef in the llm environment
-     * @param name The name of the variable
-     * @param value The GitRef value to assign to the variable
-     */
-    setGitRef: (name: string, value: GitRef) => LLM;
-    /**
-     * Set a variable of type GitRepository in the llm environment
-     * @param name The name of the variable
-     * @param value The GitRepository value to assign to the variable
-     */
-    setGitRepository: (name: string, value: GitRepository) => LLM;
-    /**
-     * Set a variable of type InputTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The InputTypeDef value to assign to the variable
-     */
-    setInputTypeDef: (name: string, value: InputTypeDef) => LLM;
-    /**
-     * Set a variable of type InterfaceTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The InterfaceTypeDef value to assign to the variable
-     */
-    setInterfaceTypeDef: (name: string, value: InterfaceTypeDef) => LLM;
-    /**
-     * Set a variable of type LLM in the llm environment
-     * @param name The name of the variable
-     * @param value The LLM value to assign to the variable
-     */
-    setLLM: (name: string, value: LLM) => LLM;
-    /**
-     * Set a variable of type ListTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The ListTypeDef value to assign to the variable
-     */
-    setListTypeDef: (name: string, value: ListTypeDef) => LLM;
-    /**
-     * Set a variable of type Module in the llm environment
-     * @param name The name of the variable
-     * @param value The Module value to assign to the variable
-     */
-    setModule: (name: string, value: Module_) => LLM;
-    /**
-     * Set a variable of type ModuleConfigClient in the llm environment
-     * @param name The name of the variable
-     * @param value The ModuleConfigClient value to assign to the variable
-     */
-    setModuleConfigClient: (name: string, value: ModuleConfigClient) => LLM;
-    /**
-     * Set a variable of type ModuleSource in the llm environment
-     * @param name The name of the variable
-     * @param value The ModuleSource value to assign to the variable
-     */
-    setModuleSource: (name: string, value: ModuleSource) => LLM;
-    /**
-     * Set a variable of type ObjectTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The ObjectTypeDef value to assign to the variable
-     */
-    setObjectTypeDef: (name: string, value: ObjectTypeDef) => LLM;
-    /**
-     * Set a variable of type SDKConfig in the llm environment
-     * @param name The name of the variable
-     * @param value The SDKConfig value to assign to the variable
-     */
-    setSDKConfig: (name: string, value: SDKConfig) => LLM;
-    /**
-     * Set a variable of type ScalarTypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The ScalarTypeDef value to assign to the variable
-     */
-    setScalarTypeDef: (name: string, value: ScalarTypeDef) => LLM;
-    /**
-     * Set a variable of type Secret in the llm environment
-     * @param name The name of the variable
-     * @param value The Secret value to assign to the variable
-     */
-    setSecret: (name: string, value: Secret) => LLM;
-    /**
-     * Set a variable of type Service in the llm environment
-     * @param name The name of the variable
-     * @param value The Service value to assign to the variable
-     */
-    setService: (name: string, value: Service) => LLM;
-    /**
-     * Set a variable of type Socket in the llm environment
-     * @param name The name of the variable
-     * @param value The Socket value to assign to the variable
-     */
-    setSocket: (name: string, value: Socket) => LLM;
-    /**
-     * Set a variable of type SourceMap in the llm environment
-     * @param name The name of the variable
-     * @param value The SourceMap value to assign to the variable
-     */
-    setSourceMap: (name: string, value: SourceMap) => LLM;
-    /**
-     * Add a string variable to the LLM's environment
-     * @param name The variable name
-     * @param value The variable value
-     */
-    setString: (name: string, value: string) => LLM;
-    /**
-     * Set a variable of type Terminal in the llm environment
-     * @param name The name of the variable
-     * @param value The Terminal value to assign to the variable
-     */
-    setTerminal: (name: string, value: Terminal) => LLM;
-    /**
-     * Set a variable of type TypeDef in the llm environment
-     * @param name The name of the variable
-     * @param value The TypeDef value to assign to the variable
-     */
-    setTypeDef: (name: string, value: TypeDef) => LLM;
-    /**
-     * Retrieve a the current value in the LLM environment, of type Socket
-     */
-    socket: () => Socket;
-    /**
-     * Retrieve a the current value in the LLM environment, of type SourceMap
-     */
-    sourceMap: () => SourceMap;
     /**
      * synchronize LLM state
      */
     sync: () => Promise<LLM>;
     /**
-     * Retrieve a the current value in the LLM environment, of type Terminal
+     * returns the token usage of the current state
      */
-    terminal: () => Terminal;
+    tokenUsage: () => LLMTokenUsage;
     /**
      * print documentation for available tools
      */
     tools: () => Promise<string>;
     /**
-     * Retrieve a the current value in the LLM environment, of type TypeDef
-     */
-    typeDef: () => TypeDef;
-    /**
-     * list variables in the LLM environment
-     */
-    variables: () => Promise<LLMVariable[]>;
-    /**
-     * Set a variable of type CacheVolume in the llm environment
-     * @param value The CacheVolume value to assign to the variable
-     */
-    withCacheVolume: (value: CacheVolume) => LLM;
-    /**
-     * Set a variable of type Container in the llm environment
-     * @param value The Container value to assign to the variable
-     */
-    withContainer: (value: Container) => LLM;
-    /**
-     * Set a variable of type CurrentModule in the llm environment
-     * @param value The CurrentModule value to assign to the variable
-     */
-    withCurrentModule: (value: CurrentModule) => LLM;
-    /**
-     * Set a variable of type Directory in the llm environment
-     * @param value The Directory value to assign to the variable
-     */
-    withDirectory: (value: Directory) => LLM;
-    /**
-     * Set a variable of type EnumTypeDef in the llm environment
-     * @param value The EnumTypeDef value to assign to the variable
-     */
-    withEnumTypeDef: (value: EnumTypeDef) => LLM;
-    /**
-     * Set a variable of type EnumValueTypeDef in the llm environment
-     * @param value The EnumValueTypeDef value to assign to the variable
-     */
-    withEnumValueTypeDef: (value: EnumValueTypeDef) => LLM;
-    /**
-     * Set a variable of type Error in the llm environment
-     * @param value The Error value to assign to the variable
-     */
-    withError: (value: Error) => LLM;
-    /**
-     * Set a variable of type ErrorValue in the llm environment
-     * @param value The ErrorValue value to assign to the variable
-     */
-    withErrorValue: (value: ErrorValue) => LLM;
-    /**
-     * Set a variable of type FieldTypeDef in the llm environment
-     * @param value The FieldTypeDef value to assign to the variable
-     */
-    withFieldTypeDef: (value: FieldTypeDef) => LLM;
-    /**
-     * Set a variable of type File in the llm environment
-     * @param value The File value to assign to the variable
-     */
-    withFile: (value: File) => LLM;
-    /**
-     * Set a variable of type Function in the llm environment
-     * @param value The Function value to assign to the variable
-     */
-    withFunction: (value: Function_) => LLM;
-    /**
-     * Set a variable of type FunctionArg in the llm environment
-     * @param value The FunctionArg value to assign to the variable
-     */
-    withFunctionArg: (value: FunctionArg) => LLM;
-    /**
-     * Set a variable of type FunctionCall in the llm environment
-     * @param value The FunctionCall value to assign to the variable
+     * allow the LLM to interact with an environment via MCP
      */
-    withFunctionCall: (value: FunctionCall) => LLM;
-    /**
-     * Set a variable of type FunctionCallArgValue in the llm environment
-     * @param value The FunctionCallArgValue value to assign to the variable
-     */
-    withFunctionCallArgValue: (value: FunctionCallArgValue) => LLM;
-    /**
-     * Set a variable of type GeneratedCode in the llm environment
-     * @param value The GeneratedCode value to assign to the variable
-     */
-    withGeneratedCode: (value: GeneratedCode) => LLM;
-    /**
-     * Set a variable of type GitRef in the llm environment
-     * @param value The GitRef value to assign to the variable
-     */
-    withGitRef: (value: GitRef) => LLM;
-    /**
-     * Set a variable of type GitRepository in the llm environment
-     * @param value The GitRepository value to assign to the variable
-     */
-    withGitRepository: (value: GitRepository) => LLM;
-    /**
-     * Set a variable of type InputTypeDef in the llm environment
-     * @param value The InputTypeDef value to assign to the variable
-     */
-    withInputTypeDef: (value: InputTypeDef) => LLM;
-    /**
-     * Set a variable of type InterfaceTypeDef in the llm environment
-     * @param value The InterfaceTypeDef value to assign to the variable
-     */
-    withInterfaceTypeDef: (value: InterfaceTypeDef) => LLM;
-    /**
-     * Set a variable of type LLM in the llm environment
-     * @param value The LLM value to assign to the variable
-     */
-    withLLM: (value: LLM) => LLM;
-    /**
-     * Set a variable of type ListTypeDef in the llm environment
-     * @param value The ListTypeDef value to assign to the variable
-     */
-    withListTypeDef: (value: ListTypeDef) => LLM;
+    withEnv: (env: Env) => LLM;
     /**
      * swap out the llm model
      * @param model The model to use
      */
     withModel: (model: string) => LLM;
-    /**
-     * Set a variable of type Module in the llm environment
-     * @param value The Module value to assign to the variable
-     */
-    withModule: (value: Module_) => LLM;
-    /**
-     * Set a variable of type ModuleConfigClient in the llm environment
-     * @param value The ModuleConfigClient value to assign to the variable
-     */
-    withModuleConfigClient: (value: ModuleConfigClient) => LLM;
-    /**
-     * Set a variable of type ModuleSource in the llm environment
-     * @param value The ModuleSource value to assign to the variable
-     */
-    withModuleSource: (value: ModuleSource) => LLM;
-    /**
-     * Set a variable of type ObjectTypeDef in the llm environment
-     * @param value The ObjectTypeDef value to assign to the variable
-     */
-    withObjectTypeDef: (value: ObjectTypeDef) => LLM;
     /**
      * append a prompt to the llm context
      * @param prompt The prompt to send
@@ -3603,56 +3313,15 @@ export declare class LLM extends BaseClient {
      * @param file The file to read the prompt from
      */
     withPromptFile: (file: File) => LLM;
-    /**
-     * Add a string variable to the LLM's environment
-     * @param name The variable name
-     * @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
+     * Add a system prompt to the LLM's environment
+     * @param prompt The system prompt to send
      */
-    withSDKConfig: (value: SDKConfig) => LLM;
-    /**
-     * Set a variable of type ScalarTypeDef in the llm environment
-     * @param value The ScalarTypeDef value to assign to the variable
-     */
-    withScalarTypeDef: (value: ScalarTypeDef) => LLM;
-    /**
-     * Set a variable of type Secret in the llm environment
-     * @param value The Secret value to assign to the variable
-     */
-    withSecret: (value: Secret) => LLM;
-    /**
-     * Set a variable of type Service in the llm environment
-     * @param value The Service value to assign to the variable
-     */
-    withService: (value: Service) => LLM;
-    /**
-     * Set a variable of type Socket in the llm environment
-     * @param value The Socket value to assign to the variable
-     */
-    withSocket: (value: Socket) => LLM;
-    /**
-     * Set a variable of type SourceMap in the llm environment
-     * @param value The SourceMap value to assign to the variable
-     */
-    withSourceMap: (value: SourceMap) => LLM;
-    /**
-     * Set a variable of type Terminal in the llm environment
-     * @param value The Terminal value to assign to the variable
-     */
-    withTerminal: (value: Terminal) => LLM;
-    /**
-     * Set a variable of type TypeDef in the llm environment
-     * @param value The TypeDef value to assign to the variable
-     */
-    withTypeDef: (value: TypeDef) => LLM;
+    withSystemPrompt: (prompt: string) => LLM;
     /**
      * Call the provided function with current LLM.
      *
@@ -3660,22 +3329,22 @@ export declare class LLM extends BaseClient {
      */
     with: (arg: (param: LLM) => LLM) => LLM;
 }
-export declare class LLMVariable extends BaseClient {
+export declare class LLMTokenUsage extends BaseClient {
     private readonly _id?;
-    private readonly _hash?;
-    private readonly _name?;
-    private readonly _typeName?;
+    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?: LLMVariableID, _hash?: string, _name?: string, _typeName?: string);
+    constructor(ctx?: Context, _id?: LLMTokenUsageID, _inputTokens?: number, _outputTokens?: number, _totalTokens?: number);
     /**
-     * A unique identifier for this LLMVariable.
+     * A unique identifier for this LLMTokenUsage.
      */
-    id: () => Promise<LLMVariableID>;
-    hash: () => Promise<string>;
-    name: () => Promise<string>;
-    typeName: () => Promise<string>;
+    id: () => Promise<LLMTokenUsageID>;
+    inputTokens: () => Promise<number>;
+    outputTokens: () => Promise<number>;
+    totalTokens: () => Promise<number>;
 }
 /**
  * A simple key value object that represents a label.
@@ -4123,11 +3792,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").
@@ -4166,6 +3830,10 @@ export declare class Client extends BaseClient {
      * The Dagger engine container configuration and state
      */
     engine: () => Engine;
+    /**
+     * Initialize a new environment
+     */
+    env: () => Env;
     /**
      * Create a new error.
      * @param message A brief description of the error.
@@ -4210,6 +3878,10 @@ export declare class Client extends BaseClient {
      * @param opts.maxAPICalls Cap the number of API calls for this LLM
      */
     llm: (opts?: ClientLlmOpts) => LLM;
+    /**
+     * Load a Binding from its ID.
+     */
+    loadBindingFromID: (id: BindingID) => Binding;
     /**
      * Load a CacheVolume from its ID.
      */
@@ -4250,6 +3922,10 @@ export declare class Client extends BaseClient {
      * Load a EnumValueTypeDef from its ID.
      */
     loadEnumValueTypeDefFromID: (id: EnumValueTypeDefID) => EnumValueTypeDef;
+    /**
+     * Load a Env from its ID.
+     */
+    loadEnvFromID: (id: EnvID) => Env;
     /**
      * Load a EnvVariable from its ID.
      */
@@ -4315,9 +3991,9 @@ export declare class Client extends BaseClient {
      */
     loadLLMFromID: (id: LLMID) => LLM;
     /**
-     * Load a LLMVariable from its ID.
+     * Load a LLMTokenUsage from its ID.
      */
-    loadLLMVariableFromID: (id: LLMVariableID) => LLMVariable;
+    loadLLMTokenUsageFromID: (id: LLMTokenUsageID) => LLMTokenUsage;
     /**
      * Load a Label from its ID.
      */