@dagger.io/dagger 0.8.8 → 0.9.1

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

@@ -50,12 +50,6 @@ export type BuildArg = {
      */
     value: string;
 };
-/**
- * A global cache volume identifier.
- */
-export type CacheID = string & {
-    __CacheID: never;
-};
 /**
  * Sharing mode of the cache volume.
  */
@@ -74,6 +68,33 @@ export declare enum CacheSharingMode {
      */
     Shared = "SHARED"
 }
+/**
+ * A global cache volume identifier.
+ */
+export type CacheVolumeID = string & {
+    __CacheVolumeID: never;
+};
+export type ContainerAsTarballOpts = {
+    /**
+     * Identifiers for other platform specific containers.
+     * Used for multi-platform image.
+     */
+    platformVariants?: Container[];
+    /**
+     * Force each layer of the image to use the specified compression algorithm.
+     * If this is unset, then if a layer already has a compressed blob in the engine's
+     * cache, that will be used (this can result in a mix of compression algorithms for
+     * different layers). If this is unset and a layer has no compressed blob in the
+     * engine's cache, then it will be compressed using Gzip.
+     */
+    forcedCompression?: ImageLayerCompression;
+    /**
+     * Use the specified media types for the image's layers. Defaults to OCI, which
+     * is largely compatible with most recent container runtimes, but Docker may be needed
+     * for older runtimes without OCI support.
+     */
+    mediaTypes?: ImageMediaTypes;
+};
 export type ContainerBuildOpts = {
     /**
      * Path to the Dockerfile to use.
@@ -100,16 +121,6 @@ export type ContainerBuildOpts = {
      */
     secrets?: Secret[];
 };
-export type ContainerEndpointOpts = {
-    /**
-     * The exposed port number for the endpoint
-     */
-    port?: number;
-    /**
-     * Return a URL with the given scheme, eg. http for http://
-     */
-    scheme?: string;
-};
 export type ContainerExportOpts = {
     /**
      * Identifiers for other platform specific containers.
@@ -379,13 +390,6 @@ export type DirectoryAsModuleOpts = {
      * directory.
      */
     sourceSubpath?: string;
-    /**
-     * A pre-built runtime container to use instead of building one from the
-     * source code. This is useful for bootstrapping.
-     *
-     * You should ignore this unless you're building a Dagger SDK.
-     */
-    runtime?: Container;
 };
 export type DirectoryDockerBuildOpts = {
     /**
@@ -482,9 +486,6 @@ export type FileExportOpts = {
 export type FileID = string & {
     __FileID: never;
 };
-export type FunctionCallOpts = {
-    input?: FunctionCallInput[];
-};
 export type FunctionWithArgOpts = {
     /**
      * A doc string for the argument, if any
@@ -495,15 +496,11 @@ export type FunctionWithArgOpts = {
      */
     defaultValue?: JSON;
 };
-export type FunctionCallInput = {
-    /**
-     * The name of the argument to the function
-     */
-    name: string;
-    /**
-     * The value of the argument represented as a string of the JSON serialization.
-     */
-    value: JSON;
+/**
+ * A reference to a FunctionArg.
+ */
+export type FunctionArgID = string & {
+    __FunctionArgID: never;
 };
 /**
  * A reference to a Function.
@@ -531,6 +528,34 @@ export type HostDirectoryOpts = {
      */
     include?: string[];
 };
+export type HostServiceOpts = {
+    /**
+     * Upstream host to forward traffic to.
+     */
+    host?: string;
+};
+export type HostTunnelOpts = {
+    /**
+     * Map each service port to the same port on the host, as if the service were
+     * running natively.
+     *
+     * Note: enabling may result in port conflicts.
+     */
+    native?: boolean;
+    /**
+     * Configure explicit port forwarding rules for the tunnel.
+     *
+     * If a port's frontend is unspecified or 0, a random port will be chosen by
+     * the host.
+     *
+     * If no ports are given, all of the service's ports are forwarded. If native
+     * is true, each port maps to the same port on the host. If native is false,
+     * each port maps to a random port chosen by the host.
+     *
+     * If ports are given and native is true, the ports are additive.
+     */
+    ports?: PortForward[];
+};
 /**
  * The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
  */
@@ -559,13 +584,6 @@ export declare enum ImageMediaTypes {
 export type JSON = string & {
     __JSON: never;
 };
-export type ModuleServeOpts = {
-    environment?: ModuleEnvironmentVariable[];
-};
-export type ModuleEnvironmentVariable = {
-    name: string;
-    value?: string;
-};
 /**
  * A reference to a Module.
  */
@@ -603,6 +621,20 @@ export type PipelineLabel = {
 export type Platform = string & {
     __Platform: never;
 };
+export type PortForward = {
+    /**
+     * Destination port for traffic.
+     */
+    backend: number;
+    /**
+     * Port to expose to clients. If unspecified, a default will be chosen.
+     */
+    frontend?: number;
+    /**
+     * Protocol to use for traffic.
+     */
+    protocol?: NetworkProtocol;
+};
 export type ClientContainerOpts = {
     id?: ContainerID;
     platform?: Platform;
@@ -610,27 +642,32 @@ export type ClientContainerOpts = {
 export type ClientDirectoryOpts = {
     id?: DirectoryID;
 };
-export type ClientGeneratedCodeOpts = {
-    id?: GeneratedCodeID;
-};
 export type ClientGitOpts = {
     /**
      * Set to true to keep .git directory.
      */
     keepGitDir?: boolean;
+    /**
+     * Set SSH known hosts
+     */
+    sshKnownHosts?: string;
+    /**
+     * Set SSH auth socket
+     */
+    sshAuthSocket?: Socket;
     /**
      * A service which must be started before the repo is fetched.
      */
-    experimentalServiceHost?: Container;
+    experimentalServiceHost?: Service;
 };
 export type ClientHttpOpts = {
     /**
      * A service which must be started before the URL is fetched.
      */
-    experimentalServiceHost?: Container;
+    experimentalServiceHost?: Service;
 };
-export type ClientModuleOpts = {
-    id?: ModuleID;
+export type ClientModuleConfigOpts = {
+    subpath?: string;
 };
 export type ClientPipelineOpts = {
     /**
@@ -645,15 +682,28 @@ export type ClientPipelineOpts = {
 export type ClientSocketOpts = {
     id?: SocketID;
 };
-export type ClientTypeDefOpts = {
-    id?: TypeDefID;
-};
 /**
  * A unique identifier for a secret.
  */
 export type SecretID = string & {
     __SecretID: never;
 };
+export type ServiceEndpointOpts = {
+    /**
+     * The exposed port number for the endpoint
+     */
+    port?: number;
+    /**
+     * Return a URL with the given scheme, eg. http for http://
+     */
+    scheme?: string;
+};
+/**
+ * A unique service identifier.
+ */
+export type ServiceID = string & {
+    __ServiceID: never;
+};
 /**
  * A content-addressed socket identifier.
  */
@@ -738,18 +788,16 @@ export declare class CacheVolume extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    }, _id?: CacheID);
-    id(): Promise<CacheID>;
+    }, _id?: CacheVolumeID);
+    id(): Promise<CacheVolumeID>;
 }
 /**
  * An OCI-compatible container, also known as a docker container.
  */
 export declare class Container extends BaseClient {
     private readonly _id?;
-    private readonly _endpoint?;
     private readonly _envVariable?;
     private readonly _export?;
-    private readonly _hostname?;
     private readonly _imageRef?;
     private readonly _label?;
     private readonly _platform?;
@@ -767,11 +815,31 @@ export declare class Container extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    }, _id?: ContainerID, _endpoint?: string, _envVariable?: string, _export?: boolean, _hostname?: string, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _shellEndpoint?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
+    }, _id?: ContainerID, _envVariable?: string, _export?: boolean, _imageRef?: string, _label?: string, _platform?: Platform, _publish?: string, _shellEndpoint?: string, _stderr?: string, _stdout?: string, _sync?: ContainerID, _user?: string, _workdir?: string);
     /**
      * A unique identifier for this container.
      */
     id(): Promise<ContainerID>;
+    /**
+     * Turn the container into a Service.
+     *
+     * Be sure to set any exposed ports before this conversion.
+     */
+    asService(): Service;
+    /**
+     * Returns a File representing the container serialized to a tarball.
+     * @param opts.platformVariants Identifiers for other platform specific containers.
+     * Used for multi-platform image.
+     * @param opts.forcedCompression Force each layer of the image to use the specified compression algorithm.
+     * If this is unset, then if a layer already has a compressed blob in the engine's
+     * cache, that will be used (this can result in a mix of compression algorithms for
+     * different layers). If this is unset and a layer has no compressed blob in the
+     * engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the image's layers. Defaults to OCI, which
+     * is largely compatible with most recent container runtimes, but Docker may be needed
+     * for older runtimes without OCI support.
+     */
+    asTarball(opts?: ContainerAsTarballOpts): File;
     /**
      * Initializes this container from a Dockerfile build.
      * @param context Directory context used by the Dockerfile.
@@ -800,18 +868,6 @@ export declare class Container extends BaseClient {
      * @param path The path of the directory to retrieve (e.g., "./src").
      */
     directory(path: string): Directory;
-    /**
-     * Retrieves an endpoint that clients can use to reach this container.
-     *
-     * If no port is specified, the first exposed port is used. If none exist an error is returned.
-     *
-     * If a scheme is specified, a URL is returned. Otherwise, a host:port pair is returned.
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
-     * @param opts.port The exposed port number for the endpoint
-     * @param opts.scheme Return a URL with the given scheme, eg. http for http://
-     */
-    endpoint(opts?: ContainerEndpointOpts): Promise<string>;
     /**
      * Retrieves entrypoint to be prepended to the arguments of all commands.
      */
@@ -849,8 +905,6 @@ export declare class Container extends BaseClient {
      *
      * This includes ports already exposed by the image, even if not
      * explicitly added with dagger.
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
      */
     exposedPorts(): Promise<Port[]>;
     /**
@@ -867,12 +921,6 @@ export declare class Container extends BaseClient {
      * Formatted as [host]/[user]/[repo]:[tag] (e.g., "docker.io/dagger/dagger:main").
      */
     from(address: string): Container;
-    /**
-     * Retrieves a hostname which can be used by clients to reach this container.
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
-     */
-    hostname(): Promise<string>;
     /**
      * The unique image reference which can only be retrieved immediately after the 'Container.From' call.
      */
@@ -1019,8 +1067,6 @@ export declare class Container extends BaseClient {
      * Exposed ports serve two purposes:
      *   - For health checks and introspection, when running services
      *   - For setting the EXPOSE OCI field when publishing the container
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
      * @param port Port number to expose
      * @param opts.protocol Transport layer network protocol
      * @param opts.description Optional port description
@@ -1151,12 +1197,10 @@ export declare class Container extends BaseClient {
      * The service will be reachable from the container via the provided hostname alias.
      *
      * The service dependency will also convey to any files or directories produced by the container.
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
      * @param alias A name that can be used to reach the service from the container
      * @param service Identifier of the service container
      */
-    withServiceBinding(alias: string, service: Container): Container;
+    withServiceBinding(alias: string, service: Service): Container;
     /**
      * Retrieves this container plus a socket forwarded to the given Unix socket path.
      * @param path Location of the forwarded Unix socket (e.g., "/tmp/socket").
@@ -1185,8 +1229,6 @@ export declare class Container extends BaseClient {
     withoutEnvVariable(name: string): Container;
     /**
      * Unexpose a previously exposed port.
-     *
-     * Currently experimental; set _EXPERIMENTAL_DAGGER_SERVICES_DNS=0 to disable.
      * @param port Port number to unexpose
      * @param opts.protocol Port protocol to unexpose
      */
@@ -1261,10 +1303,6 @@ export declare class Directory extends BaseClient {
      *
      * If not set, the module source code is loaded from the root of the
      * directory.
-     * @param opts.runtime A pre-built runtime container to use instead of building one from the
-     * source code. This is useful for bootstrapping.
-     *
-     * You should ignore this unless you're building a Dagger SDK.
      */
     asModule(opts?: DirectoryAsModuleOpts): Module_;
     /**
@@ -1305,6 +1343,11 @@ export declare class Directory extends BaseClient {
      * @param path Location of the file to retrieve (e.g., "README.md").
      */
     file(path: string): File;
+    /**
+     * Returns a list of files and directories that matche the given pattern.
+     * @param pattern Pattern to match (e.g., "*.md").
+     */
+    glob(pattern: string): Promise<string[]>;
     /**
      * Creates a named sub-pipeline
      * @param name Pipeline name.
@@ -1488,7 +1531,6 @@ export declare class File extends BaseClient {
  */
 export declare class Function_ extends BaseClient {
     private readonly _id?;
-    private readonly _call?;
     private readonly _description?;
     private readonly _name?;
     /**
@@ -1498,7 +1540,7 @@ export declare class Function_ extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    }, _id?: FunctionID, _call?: JSON, _description?: string, _name?: string);
+    }, _id?: FunctionID, _description?: string, _name?: string);
     /**
      * The ID of the function
      */
@@ -1507,16 +1549,6 @@ export declare class Function_ extends BaseClient {
      * Arguments accepted by this function, if any
      */
     args(): Promise<FunctionArg[]>;
-    /**
-     * Execute this function using dynamic input+output types.
-     *
-     * Typically, it's preferable to invoke a function using a type
-     * safe graphql query rather than using this call field. However,
-     * call is useful for some advanced use cases where dynamically
-     * loading arbitrary modules and invoking functions in them is
-     * required.
-     */
-    call(opts?: FunctionCallOpts): Promise<JSON>;
     /**
      * A doc string for the function, if any
      */
@@ -1555,6 +1587,7 @@ export declare class Function_ extends BaseClient {
  * argument passed at function call time.
  */
 export declare class FunctionArg extends BaseClient {
+    private readonly _id?;
     private readonly _defaultValue?;
     private readonly _description?;
     private readonly _name?;
@@ -1565,7 +1598,11 @@ export declare class FunctionArg extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    }, _defaultValue?: JSON, _description?: string, _name?: string);
+    }, _id?: FunctionArgID, _defaultValue?: JSON, _description?: string, _name?: string);
+    /**
+     * The ID of the argument
+     */
+    id(): Promise<FunctionArgID>;
     /**
      * A default value to use for this argument when not explicitly set by the caller, if any
      */
@@ -1663,10 +1700,6 @@ export declare class GeneratedCode extends BaseClient {
      * List of paths to ignore in version control (i.e. .gitignore)
      */
     vcsIgnoredPaths(): Promise<string[]>;
-    /**
-     * Set the directory containing the generated code
-     */
-    withCode(code: Directory): GeneratedCode;
     /**
      * Set the list of paths to mark generated in version control
      */
@@ -1686,6 +1719,7 @@ export declare class GeneratedCode extends BaseClient {
  * A git ref (tag, branch or commit).
  */
 export declare class GitRef extends BaseClient {
+    private readonly _commit?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
@@ -1693,7 +1727,11 @@ export declare class GitRef extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    });
+    }, _commit?: string);
+    /**
+     * The resolved commit id at this ref.
+     */
+    commit(): Promise<string>;
     /**
      * The filesystem tree at this ref.
      */
@@ -1751,6 +1789,17 @@ export declare class Host extends BaseClient {
      * @param path Location of the file to retrieve (e.g., "README.md").
      */
     file(path: string): File;
+    /**
+     * Creates a service that forwards traffic to a specified address via the host.
+     * @param ports Ports to expose via the service, forwarding through the host network.
+     *
+     * If a port's frontend is unspecified or 0, it defaults to the same as the
+     * backend port.
+     *
+     * An empty set of ports is not valid; an error will be returned.
+     * @param opts.host Upstream host to forward traffic to.
+     */
+    service(ports: PortForward[], opts?: HostServiceOpts): Service;
     /**
      * Sets a secret given a user-defined name and the file path on the host, and returns the secret.
      * The file is limited to a size of 512000 bytes.
@@ -1758,6 +1807,25 @@ export declare class Host extends BaseClient {
      * @param path Location of the file to set as a secret.
      */
     setSecretFile(name: string, path: string): Secret;
+    /**
+     * Creates a tunnel that forwards traffic from the host to a service.
+     * @param service Service to send traffic from the tunnel.
+     * @param opts.native Map each service port to the same port on the host, as if the service were
+     * running natively.
+     *
+     * Note: enabling may result in port conflicts.
+     * @param opts.ports Configure explicit port forwarding rules for the tunnel.
+     *
+     * If a port's frontend is unspecified or 0, a random port will be chosen by
+     * the host.
+     *
+     * If no ports are given, all of the service's ports are forwarded. If native
+     * is true, each port maps to the same port on the host. If native is false,
+     * each port maps to a random port chosen by the host.
+     *
+     * If ports are given and native is true, the ports are additive.
+     */
+    tunnel(service: Service, opts?: HostTunnelOpts): Service;
     /**
      * Accesses a Unix socket on the host.
      * @param path Location of the Unix socket (e.g., "/var/run/docker.sock").
@@ -1809,7 +1877,6 @@ export declare class Module_ extends BaseClient {
     private readonly _description?;
     private readonly _name?;
     private readonly _sdk?;
-    private readonly _sdkRuntime?;
     private readonly _serve?;
     private readonly _sourceDirectorySubPath?;
     /**
@@ -1819,7 +1886,7 @@ export declare class Module_ extends BaseClient {
         queryTree?: QueryTree[];
         host?: string;
         sessionToken?: string;
-    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _sdkRuntime?: string, _serve?: Void, _sourceDirectorySubPath?: string);
+    }, _id?: ModuleID, _description?: string, _name?: string, _sdk?: string, _serve?: Void, _sourceDirectorySubPath?: string);
     /**
      * The ID of the module
      */
@@ -1849,19 +1916,15 @@ export declare class Module_ extends BaseClient {
      */
     objects(): Promise<TypeDef[]>;
     /**
-     * The SDK used by this module
+     * The SDK used by this module. Either a name of a builtin SDK or a module ref pointing to the SDK's implementation.
      */
     sdk(): Promise<string>;
-    /**
-     * The SDK runtime module image ref.
-     */
-    sdkRuntime(): Promise<string>;
     /**
      * Serve a module's API in the current session.
      *     Note: this can only be called once per session.
      *     In the future, it could return a stream or service to remove the side effect.
      */
-    serve(opts?: ModuleServeOpts): Promise<Void>;
+    serve(): Promise<Void>;
     /**
      * The directory containing the module's source code
      */
@@ -1881,6 +1944,46 @@ export declare class Module_ extends BaseClient {
      */
     with(arg: (param: Module_) => Module_): Module_;
 }
+/**
+ * Static configuration for a module (e.g. parsed contents of dagger.json)
+ */
+export declare class ModuleConfig extends BaseClient {
+    private readonly _name?;
+    private readonly _root?;
+    private readonly _sdk?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        host?: string;
+        sessionToken?: string;
+    }, _name?: string, _root?: string, _sdk?: string);
+    /**
+     * Modules that this module depends on.
+     */
+    dependencies(): Promise<string[]>;
+    /**
+     * Exclude these file globs when loading the module root.
+     */
+    exclude(): Promise<string[]>;
+    /**
+     * Include only these file globs when loading the module root.
+     */
+    include(): Promise<string[]>;
+    /**
+     * The name of the module.
+     */
+    name(): Promise<string>;
+    /**
+     * The root directory of the module's project, which may be above the module source code.
+     */
+    root(): Promise<string>;
+    /**
+     * Either the name of a built-in SDK ('go', 'python', etc.) OR a module reference pointing to the SDK's module implementation.
+     */
+    sdk(): Promise<string>;
+}
 /**
  * A definition of a custom object defined in a Module.
  */
@@ -1962,11 +2065,10 @@ export declare class Client extends BaseClient {
      */
     checkVersionCompatibility(version: string): Promise<boolean>;
     /**
-     * Loads a container from ID.
+     * Creates a scratch container or loads one by ID.
      *
-     * Null ID returns an empty container (scratch).
-     * Optional platform argument initializes new containers to execute and publish as that platform.
-     * Platform defaults to that of the builder's host.
+     * Optional platform argument initializes new containers to execute and publish
+     * as that platform. Platform defaults to that of the builder's host.
      */
     container(opts?: ClientContainerOpts): Container;
     /**
@@ -1984,27 +2086,31 @@ export declare class Client extends BaseClient {
      */
     defaultPlatform(): Promise<Platform>;
     /**
-     * Load a directory by ID. No argument produces an empty directory.
+     * Creates an empty directory or loads one by ID.
      */
     directory(opts?: ClientDirectoryOpts): Directory;
     /**
      * Loads a file by ID.
+     * @deprecated Use loadFileFromID instead.
      */
     file(id: FileID): File;
     /**
-     * Load a function by ID
+     * Create a function.
      */
-    function_(id: FunctionID): Function_;
+    function_(name: string, returnType: TypeDef): Function_;
     /**
-     * Load GeneratedCode by ID, or create a new one if id is unset.
+     * Create a code generation result, given a directory containing the generated
+     * code.
      */
-    generatedCode(opts?: ClientGeneratedCodeOpts): GeneratedCode;
+    generatedCode(code: Directory): GeneratedCode;
     /**
      * Queries a git repository.
      * @param url Url of the git repository.
-     * Can be formatted as https://{host}/{owner}/{repo}, git@{host}/{owner}/{repo}
+     * Can be formatted as https://{host}/{owner}/{repo}, git@{host}:{owner}/{repo}
      * Suffix ".git" is optional.
      * @param opts.keepGitDir Set to true to keep .git directory.
+     * @param opts.sshKnownHosts Set SSH known hosts
+     * @param opts.sshAuthSocket Set SSH auth socket
      * @param opts.experimentalServiceHost A service which must be started before the repo is fetched.
      */
     git(url: string, opts?: ClientGitOpts): GitRepository;
@@ -2019,13 +2125,61 @@ export declare class Client extends BaseClient {
      */
     http(url: string, opts?: ClientHttpOpts): File;
     /**
-     * Load a module by ID, or create a new one if id is unset.
+     * Load a CacheVolume from its ID.
      */
-    module_(opts?: ClientModuleOpts): Module_;
+    loadCacheVolumeFromID(id: CacheVolumeID): CacheVolume;
     /**
-     * Create a new function from the provided definition.
+     * Loads a container from an ID.
      */
-    newFunction(name: string, returnType: TypeDef): Function_;
+    loadContainerFromID(id: ContainerID): Container;
+    /**
+     * Load a Directory from its ID.
+     */
+    loadDirectoryFromID(id: DirectoryID): Directory;
+    /**
+     * Load a File from its ID.
+     */
+    loadFileFromID(id: FileID): File;
+    /**
+     * Load a function argument by ID.
+     */
+    loadFunctionArgFromID(id: FunctionArgID): FunctionArg;
+    /**
+     * Load a function by ID.
+     */
+    loadFunctionFromID(id: FunctionID): Function_;
+    /**
+     * Load a GeneratedCode by ID.
+     */
+    loadGeneratedCodeFromID(id: GeneratedCodeID): GeneratedCode;
+    /**
+     * Load a module by ID.
+     */
+    loadModuleFromID(id: ModuleID): Module_;
+    /**
+     * Load a Secret from its ID.
+     */
+    loadSecretFromID(id: SecretID): Secret;
+    /**
+     * Loads a service from ID.
+     */
+    loadServiceFromID(id: ServiceID): Service;
+    /**
+     * Load a Socket from its ID.
+     */
+    loadSocketFromID(id: SocketID): Socket;
+    /**
+     * Load a TypeDef by ID.
+     */
+    loadTypeDefFromID(id: TypeDefID): TypeDef;
+    /**
+     * Create a new module.
+     */
+    module_(): Module_;
+    /**
+     * Load the static configuration for a module from the given source directory and optional subpath.
+     */
+    moduleConfig(sourceDirectory: Directory, opts?: ClientModuleConfigOpts): ModuleConfig;
     /**
      * Creates a named sub-pipeline.
      * @param name Pipeline name.
@@ -2035,6 +2189,7 @@ export declare class Client extends BaseClient {
     pipeline(name: string, opts?: ClientPipelineOpts): Client;
     /**
      * Loads a secret from its ID.
+     * @deprecated Use loadSecretFromID instead
      */
     secret(id: SecretID): Secret;
     /**
@@ -2046,9 +2201,13 @@ export declare class Client extends BaseClient {
     setSecret(name: string, plaintext: string): Secret;
     /**
      * Loads a socket by its ID.
+     * @deprecated Use loadSocketFromID instead.
      */
     socket(opts?: ClientSocketOpts): Socket;
-    typeDef(opts?: ClientTypeDefOpts): TypeDef;
+    /**
+     * Create a new TypeDef.
+     */
+    typeDef(): TypeDef;
     /**
      * Call the provided function with current Client.
      *
@@ -2079,6 +2238,53 @@ export declare class Secret extends BaseClient {
      */
     plaintext(): Promise<string>;
 }
+export declare class Service extends BaseClient {
+    private readonly _id?;
+    private readonly _endpoint?;
+    private readonly _hostname?;
+    private readonly _start?;
+    private readonly _stop?;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent?: {
+        queryTree?: QueryTree[];
+        host?: string;
+        sessionToken?: string;
+    }, _id?: ServiceID, _endpoint?: string, _hostname?: string, _start?: ServiceID, _stop?: ServiceID);
+    /**
+     * A unique identifier for this service.
+     */
+    id(): Promise<ServiceID>;
+    /**
+     * Retrieves an endpoint that clients can use to reach this container.
+     *
+     * If no port is specified, the first exposed port is used. If none exist an error is returned.
+     *
+     * If a scheme is specified, a URL is returned. Otherwise, a host:port pair is returned.
+     * @param opts.port The exposed port number for the endpoint
+     * @param opts.scheme Return a URL with the given scheme, eg. http for http://
+     */
+    endpoint(opts?: ServiceEndpointOpts): Promise<string>;
+    /**
+     * Retrieves a hostname which can be used by clients to reach this container.
+     */
+    hostname(): Promise<string>;
+    /**
+     * Retrieves the list of ports provided by the service.
+     */
+    ports(): Promise<Port[]>;
+    /**
+     * Start the service and wait for its health checks to succeed.
+     *
+     * Services bound to a Container do not need to be manually started.
+     */
+    start(): Promise<Service>;
+    /**
+     * Stop the service.
+     */
+    stop(): Promise<Service>;
+}
 export declare class Socket extends BaseClient {
     private readonly _id?;
     /**