@dagger.io/dagger 0.2.1 → 0.3.1

package/dist/api/client.gen.js

@@ -1,7 +1,3 @@
-/**
- * This file was auto-generated by `cloak clientgen`.
- * Do not make direct changes to the file.
- */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -11,16 +7,25 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+/**
+ * This file was auto-generated by `client-gen`.
+ * Do not make direct changes to the file.
+ */
 import { GraphQLClient } from "graphql-request";
-import { queryBuilder } from "./utils.js";
+import { computeQuery } from "./utils.js";
 class BaseClient {
     /**
      * @hidden
      */
-    constructor({ queryTree, host } = {}) {
+    constructor({ queryTree, host, sessionToken } = {}) {
         this._queryTree = queryTree || [];
         this.clientHost = host || "127.0.0.1:8080";
-        this.client = new GraphQLClient(`http://${host}/query`);
+        this.sessionToken = sessionToken || "";
+        this.client = new GraphQLClient(`http://${host}/query`, {
+            headers: {
+                Authorization: "Basic " + Buffer.from(sessionToken + ":").toString("base64"),
+            },
+        });
     }
     /**
      * @hidden
@@ -30,58 +35,61 @@ class BaseClient {
     }
 }
 /**
- * A directory whose contents persist across runs
+ * A directory whose contents persist across runs.
  */
 export class CacheVolume extends BaseClient {
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 /**
- * An OCI-compatible container, also known as a docker container
+ * An OCI-compatible container, also known as a docker container.
  */
 export class Container extends BaseClient {
     /**
-     * Initialize this container from a Dockerfile build
+     * Initializes this container from a Dockerfile build, using the context, a dockerfile file path and some additional buildArgs.
+     * @param context Directory context used by the Dockerfile.
+     * @param opts.dockerfile Path to the Dockerfile to use.
+  Defaults to './Dockerfile'.
+     * @param opts.buildArgs Additional build arguments.
      */
-    build(context, dockerfile) {
+    build(context, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "build",
-                    args: { context, dockerfile },
+                    args: Object.assign({ context }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Default arguments for future commands
+     * Retrieves default arguments for future commands.
      */
     defaultArgs() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "defaultArgs",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Retrieve a directory at the given path. Mounts are included.
+     * Retrieves a directory at the given path. Mounts are included.
      */
     directory(path) {
         return new Directory({
@@ -93,75 +101,74 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Entrypoint to be prepended to the arguments of all commands
+     * Retrieves entrypoint to be prepended to the arguments of all commands.
      */
     entrypoint() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "entrypoint",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The value of the specified environment variable
+     * Retrieves the value of the specified environment variable.
      */
     envVariable(name) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "envVariable",
                     args: { name },
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * A list of environment variables passed to commands
+     * Retrieves the list of environment variables passed to commands.
      */
     envVariables() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "envVariables",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * This container after executing the specified command inside it
-     *
+     * Retrieves this container after executing the specified command inside it.
+     * @param opts.args Command to run instead of the container's default command.
+     * @param opts.stdin Content to write to the command's standard input before closing.
+     * @param opts.redirectStdout Redirect the command's standard output to a file in the container.
+     * @param opts.redirectStderr Redirect the command's standard error to a file in the container.
+     * @param opts.experimentalPrivilegedNesting Provide dagger access to the executed command.
+  Do not use this option unless you trust the command being executed.
+  The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      * @deprecated Replaced by withExec.
      */
-    exec(args, stdin, redirectStdout, redirectStderr, experimentalPrivilegedNesting) {
+    exec(opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "exec",
-                    args: {
-                        args,
-                        stdin,
-                        redirectStdout,
-                        redirectStderr,
-                        experimentalPrivilegedNesting,
-                    },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -170,34 +177,37 @@ export class Container extends BaseClient {
      */
     exitCode() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "exitCode",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Write the container as an OCI tarball to the destination file path on the host
+     * Writes the container as an OCI tarball to the destination file path on the host for the specified platformVariants.
+     * Return true on success.
+     * @param path Host's destination path.
+  Path can be relative to the engine's workdir or absolute.
+     * @param opts.platformVariants Identifiers for other platform specific containers.
+  Used for multi-platform image.
      */
-    export(path, platformVariants) {
+    export(path, opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
-                    args: { path, platformVariants },
+                    args: Object.assign({ path }, opts),
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Retrieve a file at the given path. Mounts are included.
+     * Retrieves a file at the given path. Mounts are included.
      */
     file(path) {
         return new File({
@@ -209,10 +219,13 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from the base image published at the given address
+     * Initializes this container from the base image published at the given address.
+     * @param address Image's address from its registry.
+  Formatted as {host}/{user}/{repo}:{tag} (e.g. docker.io/dagger/dagger:main).
      */
     from(address) {
         return new Container({
@@ -224,11 +237,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container's root filesystem. Mounts are not included.
-     *
+     * Retrieves this container's root filesystem. Mounts are not included.
      * @deprecated Replaced by rootfs.
      */
     fs() {
@@ -240,71 +253,72 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * A unique identifier for this container
+     * A unique identifier for this container.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * List of paths where a directory is mounted
+     * Retrieves the list of paths where a directory is mounted.
      */
     mounts() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "mounts",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The platform this container executes and publishes as
+     * The platform this container executes and publishes as.
      */
     platform() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "platform",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Publish this container as a new image, returning a fully qualified ref
+     * Publishes this container as a new image to the specified address, for the platformVariants, returning a fully qualified ref.
+     * @param address Registry's address to publish the image to.
+  Formatted as {host}/{user}/{repo}:{tag} (e.g. docker.io/dagger/dagger:main).
+     * @param opts.platformVariants Identifiers for other platform specific containers.
+  Used for multi-platform image.
      */
-    publish(address, platformVariants) {
+    publish(address, opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "publish",
-                    args: { address, platformVariants },
+                    args: Object.assign({ address }, opts),
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * This container's root filesystem. Mounts are not included.
+     * Retrieves this container's root filesystem. Mounts are not included.
      */
     rootfs() {
         return new Directory({
@@ -315,6 +329,7 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -323,13 +338,12 @@ export class Container extends BaseClient {
      */
     stderr() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "stderr",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -339,63 +353,63 @@ export class Container extends BaseClient {
      */
     stdout() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "stdout",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The user to be set for all commands
+     * Retrieves the user to be set for all commands.
      */
     user() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "user",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Configures default arguments for future commands
+     * Configures default arguments for future commands.
      */
-    withDefaultArgs(args) {
+    withDefaultArgs(opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withDefaultArgs",
-                    args: { args },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a directory written at the given path
+     * Retrieves this container plus a directory written at the given path.
      */
-    withDirectory(path, directory, exclude, include) {
+    withDirectory(path, directory, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withDirectory",
-                    args: { path, directory, exclude, include },
+                    args: Object.assign({ path, directory }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different command entrypoint
+     * Retrieves this container but with a different command entrypoint.
      */
     withEntrypoint(args) {
         return new Container({
@@ -407,10 +421,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus the given environment variable
+     * Retrieves this container plus the given environment variable.
      */
     withEnvVariable(name, value) {
         return new Container({
@@ -422,32 +437,34 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container after executing the specified command inside it
+     * Retrieves this container after executing the specified command inside it.
+     * @param args Command to run instead of the container's default command.
+     * @param opts.stdin Content to write to the command's standard input before closing.
+     * @param opts.redirectStdout Redirect the command's standard output to a file in the container.
+     * @param opts.redirectStderr Redirect the command's standard error to a file in the container.
+     * @param opts.experimentalPrivilegedNesting Provide dagger access to the executed command.
+  Do not use this option unless you trust the command being executed.
+  The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      */
-    withExec(args, stdin, redirectStdout, redirectStderr, experimentalPrivilegedNesting) {
+    withExec(args, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withExec",
-                    args: {
-                        args,
-                        stdin,
-                        redirectStdout,
-                        redirectStderr,
-                        experimentalPrivilegedNesting,
-                    },
+                    args: Object.assign({ args }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from this DirectoryID
-     *
+     * Initializes this container from this DirectoryID.
      * @deprecated Replaced by withRootfs.
      */
     withFS(id) {
@@ -460,40 +477,43 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus the contents of the given file copied to the given path
+     * Retrieves this container plus the contents of the given file copied to the given path.
      */
-    withFile(path, source) {
+    withFile(path, source, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withFile",
-                    args: { path, source },
+                    args: Object.assign({ path, source }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a cache volume mounted at the given path
+     * Retrieves this container plus a cache volume mounted at the given path.
      */
-    withMountedCache(path, cache, source) {
+    withMountedCache(path, cache, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withMountedCache",
-                    args: { path, cache, source },
+                    args: Object.assign({ path, cache }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a directory mounted at the given path
+     * Retrieves this container plus a directory mounted at the given path.
      */
     withMountedDirectory(path, source) {
         return new Container({
@@ -505,10 +525,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a file mounted at the given path
+     * Retrieves this container plus a file mounted at the given path.
      */
     withMountedFile(path, source) {
         return new Container({
@@ -520,10 +541,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a secret mounted into a file at the given path
+     * Retrieves this container plus a secret mounted into a file at the given path.
      */
     withMountedSecret(path, source) {
         return new Container({
@@ -535,10 +557,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a temporary directory mounted at the given path
+     * Retrieves this container plus a temporary directory mounted at the given path.
      */
     withMountedTemp(path) {
         return new Container({
@@ -550,25 +573,27 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a new file written at the given path
+     * Retrieves this container plus a new file written at the given path.
      */
-    withNewFile(path, contents) {
+    withNewFile(path, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewFile",
-                    args: { path, contents },
+                    args: Object.assign({ path }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from this DirectoryID
+     * Initializes this container from this DirectoryID.
      */
     withRootfs(id) {
         return new Container({
@@ -580,10 +605,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus an env variable containing the given secret
+     * Retrieves this container plus an env variable containing the given secret.
      */
     withSecretVariable(name, secret) {
         return new Container({
@@ -595,10 +621,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a socket forwarded to the given Unix socket path
+     * Retrieves this container plus a socket forwarded to the given Unix socket path.
      */
     withUnixSocket(path, source) {
         return new Container({
@@ -610,10 +637,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different command user
+     * Retrieves this containers with a different command user.
      */
     withUser(name) {
         return new Container({
@@ -625,10 +653,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different working directory
+     * Retrieves this container with a different working directory.
      */
     withWorkdir(path) {
         return new Container({
@@ -640,10 +669,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container minus the given environment variable
+     * Retrieves this container minus the given environment variable.
      */
     withoutEnvVariable(name) {
         return new Container({
@@ -655,10 +685,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container after unmounting everything at the given path.
+     * Retrieves this container after unmounting everything at the given path.
      */
     withoutMount(path) {
         return new Container({
@@ -670,10 +701,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container with a previously added Unix socket removed
+     * Retrieves this container with a previously added Unix socket removed.
      */
     withoutUnixSocket(path) {
         return new Container({
@@ -685,30 +717,30 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The working directory for all commands
+     * Retrieves the working directory for all commands.
      */
     workdir() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "workdir",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 /**
- * A directory
+ * A directory.
  */
 export class Directory extends BaseClient {
     /**
-     * The difference between this directory and an another directory
+     * Gets the difference between this directory and an another directory.
      */
     diff(other) {
         return new Directory({
@@ -720,10 +752,11 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Retrieve a directory at the given path
+     * Retrieves a directory at the given path.
      */
     directory(path) {
         return new Directory({
@@ -735,57 +768,59 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Build a new Docker container from this directory
+     * Builds a new Docker container from this directory.
+     * @param opts.dockerfile Path to the Dockerfile to use.
+  Defaults to './Dockerfile'.
      */
-    dockerBuild(dockerfile, platform) {
+    dockerBuild(opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "dockerBuild",
-                    args: { dockerfile, platform },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Return a list of files and directories at the given path
+     * Returns a list of files and directories at the given path.
      */
-    entries(path) {
+    entries(opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "entries",
-                    args: { path },
+                    args: Object.assign({}, opts),
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Write the contents of the directory to a path on the host
+     * Writes the contents of the directory to a path on the host.
      */
     export(path) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
                     args: { path },
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Retrieve a file at the given path
+     * Retrieves a file at the given path.
      */
     file(path) {
         return new File({
@@ -797,20 +832,20 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The content-addressed identifier of the directory
+     * The content-addressed identifier of the directory.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -827,70 +862,95 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a directory written at the given path
+     * Retrieves this directory plus a directory written at the given path.
+     * @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.*"]).
      */
-    withDirectory(path, directory, exclude, include) {
+    withDirectory(path, directory, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withDirectory",
-                    args: { path, directory, exclude, include },
+                    args: Object.assign({ path, directory }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus the contents of the given file copied to the given path
+     * Retrieves this directory plus the contents of the given file copied to the given path.
      */
-    withFile(path, source) {
+    withFile(path, source, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withFile",
-                    args: { path, source },
+                    args: Object.assign({ path, source }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a new directory created at the given path
+     * Retrieves this directory plus a new directory created at the given path.
      */
-    withNewDirectory(path) {
+    withNewDirectory(path, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewDirectory",
-                    args: { path },
+                    args: Object.assign({ path }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a new file written at the given path
+     * Retrieves this directory plus a new file written at the given path.
      */
-    withNewFile(path, contents) {
+    withNewFile(path, contents, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewFile",
-                    args: { path, contents },
+                    args: Object.assign({ path, contents }, opts),
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
+    /**
+     * Retrieves this directory with all file/dir timestamps set to the given time, in seconds from the Unix epoch.
+     */
+    withTimestamps(timestamp) {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withTimestamps",
+                    args: { timestamp },
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory with the directory at the given path removed
+     * Retrieves this directory with the directory at the given path removed.
      */
     withoutDirectory(path) {
         return new Directory({
@@ -902,10 +962,11 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory with the file at the given path removed
+     * Retrieves this directory with the file at the given path removed.
      */
     withoutFile(path) {
         return new Directory({
@@ -917,94 +978,93 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * EnvVariable is a simple key value object that represents an environment variable.
+ * A simple key value object that represents an environment variable.
  */
 export class EnvVariable extends BaseClient {
     /**
-     * name is the environment variable name.
+     * The environment variable name.
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "name",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * value is the environment variable value
+     * The environment variable value.
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "value",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 /**
- * A file
+ * A file.
  */
 export class File extends BaseClient {
     /**
-     * The contents of the file
+     * Retrieves the contents of the file.
      */
     contents() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "contents",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Write the file to a file path on the host
+     * Writes the file to a file path on the host.
      */
     export(path) {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
                     args: { path },
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The content-addressed identifier of the file
+     * Retrieves the content-addressed identifier of the file.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
+    /**
+     * Retrieves a secret referencing the contents of this file.
+     */
     secret() {
         return new Secret({
             queryTree: [
@@ -1014,65 +1074,81 @@ export class File extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The size of the file, in bytes
+     * Gets the size of the file, in bytes.
      */
     size() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "size",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
+    /**
+     * Retrieves this file with its created/modified timestamps set to the given time, in seconds from the Unix epoch.
+     */
+    withTimestamps(timestamp) {
+        return new File({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withTimestamps",
+                    args: { timestamp },
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
 }
 /**
- * A git ref (tag or branch)
+ * A git ref (tag, branch or commit).
  */
 export class GitRef extends BaseClient {
     /**
-     * The digest of the current value of this ref
+     * The digest of the current value of this ref.
      */
     digest() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "digest",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The filesystem tree at this ref
+     * The filesystem tree at this ref.
      */
-    tree(sshKnownHosts, sshAuthSocket) {
+    tree(opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "tree",
-                    args: { sshKnownHosts, sshAuthSocket },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * A git repository
+ * A git repository.
  */
 export class GitRepository extends BaseClient {
     /**
-     * Details on one branch
+     * Returns details on one branch.
      */
     branch(name) {
         return new GitRef({
@@ -1084,25 +1160,25 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * List of branches on the repository
+     * Lists of branches on the repository.
      */
     branches() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "branches",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * Details on one commit
+     * Returns details on one commit.
      */
     commit(id) {
         return new GitRef({
@@ -1114,10 +1190,11 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Details on one tag
+     * Returns details on one tag.
      */
     tag(name) {
         return new GitRef({
@@ -1129,45 +1206,46 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * List of tags on the repository
+     * Lists of tags on the repository.
      */
     tags() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "tags",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 /**
- * Information about the host execution environment
+ * Information about the host execution environment.
  */
 export class Host extends BaseClient {
     /**
-     * Access a directory on the host
+     * Accesses a directory on the host.
      */
-    directory(path, exclude, include) {
+    directory(path, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "directory",
-                    args: { path, exclude, include },
+                    args: Object.assign({ path }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Access an environment variable on the host
+     * Accesses an environment variable on the host.
      */
     envVariable(name) {
         return new HostVariable({
@@ -1179,10 +1257,11 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Access a Unix socket on the host
+     * Accesses a Unix socket on the host.
      */
     unixSocket(path) {
         return new Socket({
@@ -1194,32 +1273,33 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The current working directory on the host
-     *
+     * Retrieves the current working directory on the host.
      * @deprecated Use directory with path set to '.' instead.
      */
-    workdir(exclude, include) {
+    workdir(opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "workdir",
-                    args: { exclude, include },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * An environment variable on the host environment
+ * An environment variable on the host environment.
  */
 export class HostVariable extends BaseClient {
     /**
-     * A secret referencing the value of this variable
+     * A secret referencing the value of this variable.
      */
     secret() {
         return new Secret({
@@ -1230,20 +1310,20 @@ export class HostVariable extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The value of this variable
+     * The value of this variable.
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "value",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -1257,13 +1337,12 @@ export class Project extends BaseClient {
      */
     extensions() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "extensions",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -1279,6 +1358,7 @@ export class Project extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1286,13 +1366,12 @@ export class Project extends BaseClient {
      */
     install() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "install",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -1301,13 +1380,12 @@ export class Project extends BaseClient {
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "name",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -1316,13 +1394,12 @@ export class Project extends BaseClient {
      */
     schema() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "schema",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
@@ -1331,20 +1408,20 @@ export class Project extends BaseClient {
      */
     sdk() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "sdk",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 export default class Client extends BaseClient {
     /**
-     * Construct a cache volume for a given cache key
+     * Constructs a cache volume for a given cache key.
+     * @param key A string identifier to target this cache volume (e.g. "myapp-cache").
      */
     cacheVolume(key) {
         return new CacheVolume({
@@ -1356,23 +1433,25 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a container from ID.
+     * Loads a container from 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.
      */
-    container(id, platform) {
+    container(opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "container",
-                    args: { id, platform },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1380,33 +1459,33 @@ export default class Client extends BaseClient {
      */
     defaultPlatform() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "defaultPlatform",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
      * Load a directory by ID. No argument produces an empty directory.
      */
-    directory(id) {
+    directory(opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "directory",
-                    args: { id },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a file by ID
+     * Loads a file by ID.
      */
     file(id) {
         return new File({
@@ -1418,25 +1497,27 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Query a git repository
+     * Queries a git repository.
      */
-    git(url, keepGitDir) {
+    git(url, opts) {
         return new GitRepository({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "git",
-                    args: { url, keepGitDir },
+                    args: Object.assign({ url }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Query the host environment
+     * Queries the host environment.
      */
     host() {
         return new Host({
@@ -1447,10 +1528,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * An http remote
+     * Returns a file containing an http remote url content.
      */
     http(url) {
         return new File({
@@ -1462,6 +1544,7 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1477,10 +1560,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a secret from its ID
+     * Loads a secret from its ID.
      */
     secret(id) {
         return new Secret({
@@ -1492,72 +1576,71 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a socket by ID
+     * Loads a socket by its ID.
      */
-    socket(id) {
+    socket(opts) {
         return new Socket({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "socket",
-                    args: { id },
+                    args: Object.assign({}, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * A reference to a secret value, which can be handled more safely than the value itself
+ * A reference to a secret value, which can be handled more safely than the value itself.
  */
 export class Secret extends BaseClient {
     /**
-     * The identifier for this secret
+     * The identifier for this secret.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
     /**
-     * The value of this secret
+     * The value of this secret.
      */
     plaintext() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "plaintext",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }
 }
 export class Socket extends BaseClient {
     /**
-     * The content-addressed identifier of the socket
+     * The content-addressed identifier of the socket.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._queryTree = [
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
                 },
-            ];
-            const response = yield queryBuilder(this._queryTree, this.client);
+            ], this.client);
             return response;
         });
     }