dataiku-sdk 3.8.0 → 4.0.0

package/README.md

@@ -16,7 +16,7 @@ Malformed user/group listings and scenario run histories fail explicitly instead
 
 ## Platform support
 
-The published `dss` CLI requires Bun >= 1.4.2 and supports Linux, macOS, and Windows. CI runs Bun 1.4.2 on all three operating systems. The runtime dependency is pure JavaScript, so the same package also runs on every Bun-supported x64 and ARM64 system.
+The published `dss` CLI requires Bun >= 1.4.3 and supports Linux, macOS, and Windows. CI runs Bun 1.4.3 on all three operating systems. The runtime dependency is pure JavaScript, so the same package also runs on every Bun-supported x64 and ARM64 system.
 
 Run directly with Bun:
 
@@ -29,7 +29,7 @@ Or install the npm binary:
 ```text
 npm install --global dataiku-sdk
 ```
-The installed `dss` bin bootstraps Bun with automatic `.env` preloading disabled, so Bun >= 1.4.2 must be on `PATH`; the CLI's own `.env` handling stays authoritative. `bunx --bun` forces Bun's Node-compatibility mode, which provides the same no-preload guarantee across operating systems.
+The installed `dss` bin bootstraps Bun with automatic `.env` preloading disabled, so Bun >= 1.4.3 must be on `PATH`; the CLI's own `.env` handling stays authoritative. `bunx --bun` forces Bun's Node-compatibility mode, which provides the same no-preload guarantee across operating systems.
 
 Bun is the only supported runtime and the package manager. Examples below assume an installed `dss` binary. From a checkout, use `bun --no-env-file src/cli.ts ...` or the packaged launcher `bun --no-env-file ./bin/dss.js ...`. From another working directory, pass the checkout's absolute `bin/dss.js` path to Bun.
 `--no-env-file` disables Bun's automatic preloading only; the CLI still applies its documented `.env` handling unless `DATAIKU_DISABLE_ENV=1` is set.
@@ -181,7 +181,7 @@ then update `tests/live-coverage.ts` when the
 registry changes; catalogue drift fails the offline gate. Plan/dry-run calls do not count
 as executed live coverage.
 
-Regular `bun run check` and `bun run lint` include the live runner and fixtures.
+Regular `bun run verify` and `bun run lint` include the live runner and fixtures.
 Lint includes project-owned rules in `tools/oxlint/index.ts`: accumulator-copy, widen-then-assert, and chained-assertion errors, alongside the native accumulating-spread check.
 For focused verification:
 
@@ -520,8 +520,10 @@ UI-click smoke test. The CLI does not guess private endpoints for those operatio
 
 `project map` returns one agent-oriented JSON view of the Flow: normalized nodes and edges,
 joined zone metadata, cycle-safe topological layers, weakly connected components, diagnostics, and
-a stable `topologyFingerprint`. Zone joins add `zoneId`/`zoneName` to each node; the top-level
-`zones` array preserves zone color, position, item count, and visible node IDs.
+a stable `topologyFingerprint`. Output is deduplicated: node `name` appears only when it differs from
+`id`; each node carries `zoneId`/`componentId` (zone names live in `zones[]`, membership is derived
+from those ids, so `zones[]`/`components[]` omit `nodeIds`); `warnings` appears only when non-empty and
+`truncation` only when the map was cut. `zones` preserves zone color, position, and item count.
 
 ```bash
 dss project map --project-key MYPROJ

package/dist/build-metadata.json

@@ -1 +1 @@
-{"format":1,"buildRevision":"6814ed4e3da988eccd85f9f50d79e1da66253b0a"}
+{"format":1,"buildRevision":"ab176cb1de853bfbdc58627b38a131ce1fc1681d"}

package/dist/packages/types/src/index.d.ts

@@ -284,6 +284,10 @@ export declare const JobWaitResultSchema: import("@sinclair/typebox").TObject<{
     pollCount: import("@sinclair/typebox").TNumber;
     success: import("@sinclair/typebox").TBoolean;
     timedOut: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    /** Present on a wait timeout: the wait never cancels the job, so this is `false`. */
+    cancelled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    /** CLI only, on a wait timeout: the command that resumes waiting for the still-running job. */
+    resume: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     progress: import("@sinclair/typebox").TObject<{
         done: import("@sinclair/typebox").TNumber;
         failed: import("@sinclair/typebox").TNumber;

package/dist/packages/types/src/index.js

@@ -308,6 +308,10 @@ export const JobWaitResultSchema = Type.Object({
     pollCount: Type.Number(),
     success: Type.Boolean(),
     timedOut: Type.Optional(Type.Boolean()),
+    /** Present on a wait timeout: the wait never cancels the job, so this is `false`. */
+    cancelled: Type.Optional(Type.Boolean()),
+    /** CLI only, on a wait timeout: the command that resumes waiting for the still-running job. */
+    resume: Type.Optional(Type.String()),
     progress: Type.Object({
         done: Type.Number(),
         failed: Type.Number(),

package/dist/src/cli/coerce.d.ts

@@ -21,6 +21,12 @@ export declare function parseJsonObject(text: string, source: string): Record<st
 export declare function json(v: string | boolean | undefined, source?: string): Record<string, unknown> | undefined;
 export declare function readStdinText(): string;
 export declare function readInputText(path: string, flag: string): string;
+/**
+ * Async UTF-8 read of a user-supplied path (BOM kept, like `readFileSync`).
+ * Stays on node:fs: Bun 1.4.3 `Bun.file(path)` reads of a missing path ended the
+ * process on Windows CI instead of rejecting with ENOENT.
+ */
+export declare function readTextFile(path: string): Promise<string>;
 export declare function seenJsonInputCredentials(): readonly string[];
 export declare function jsonInput(flags: Record<string, string | boolean>): Record<string, unknown> | undefined;
 export declare function unknownJsonInput(flags: Record<string, string | boolean>): unknown;

package/dist/src/cli/coerce.js

@@ -1,4 +1,5 @@
 import { readFileSync, } from "node:fs";
+import { readFile, } from "node:fs/promises";
 import { credentialValues, } from "../utils/secret-sanitize.js";
 import { UsageError, } from "./usage.js";
 function safeValuePreview(value) {
@@ -174,6 +175,14 @@ export function readInputText(path, flag) {
         throw new UsageError(`Could not read ${flag} file: ${path}`, "validation_failed", "Verify that the path names an existing, readable file.", { flag, path, ...(cause ? { cause, } : {}), });
     }
 }
+/**
+ * Async UTF-8 read of a user-supplied path (BOM kept, like `readFileSync`).
+ * Stays on node:fs: Bun 1.4.3 `Bun.file(path)` reads of a missing path ended the
+ * process on Windows CI instead of rejecting with ENOENT.
+ */
+export async function readTextFile(path) {
+    return readFile(path, "utf-8");
+}
 /**
  * Credential values seen in this process's JSON inputs. DSS error text can
  * echo the request payload, so error reports redact these.

package/dist/src/cli/command-syntax.json

@@ -4513,6 +4513,15 @@
             {
                 "arg": "name"
             },
+            {
+                "optional": [
+                    [
+                        {
+                            "flag": "full"
+                        }
+                    ]
+                ]
+            },
             {
                 "optional": [
                     [
@@ -4531,6 +4540,15 @@
             {
                 "arg": "name"
             },
+            {
+                "optional": [
+                    [
+                        {
+                            "flag": "full"
+                        }
+                    ]
+                ]
+            },
             {
                 "optional": [
                     [
@@ -7108,6 +7126,15 @@
             {
                 "arg": "id"
             },
+            {
+                "optional": [
+                    [
+                        {
+                            "flag": "full"
+                        }
+                    ]
+                ]
+            },
             {
                 "optional": [
                     [
@@ -12890,6 +12917,15 @@
             "dss",
             "project",
             "get",
+            {
+                "optional": [
+                    [
+                        {
+                            "flag": "full"
+                        }
+                    ]
+                ]
+            },
             {
                 "optional": [
                     [

package/dist/src/cli/commands/app.js

@@ -754,7 +754,7 @@ export const appCommands = withUsage("app", {
             const usage = commandUsage("app", "permissions-diff");
             requireNoArgs(_a, usage);
             const file = requiredStringFlag(f, "file", usage);
-            const snapshot = readAppPermissionsSnapshot(file);
+            const snapshot = await readAppPermissionsSnapshot(file);
             const projectKey = c.resolveProjectKey(f["project-key"]);
             assertAppPermissionsSnapshotBinding(snapshot, projectKey, c.getBaseUrl());
             const currentProjectIncarnationHash = await requireProjectIncarnationHash(c, projectKey);
@@ -779,7 +779,7 @@ export const appCommands = withUsage("app", {
             const usage = commandUsage("app", "permissions-restore");
             requireNoArgs(_a, usage);
             const file = requiredStringFlag(f, "file", usage);
-            const snapshot = readAppPermissionsSnapshot(file);
+            const snapshot = await readAppPermissionsSnapshot(file);
             const projectKey = c.resolveProjectKey(f["project-key"]);
             assertAppPermissionsSnapshotBinding(snapshot, projectKey, c.getBaseUrl());
             const currentProjectIncarnationHash = await requireProjectIncarnationHash(c, projectKey);

package/dist/src/cli/commands/code-env.js

@@ -1,7 +1,6 @@
-import { readFileSync, writeFileSync, } from "node:fs";
 import { ClientValidationError, } from "../../errors.js";
 import { SHA256_HEX_PATTERN, stableHash, } from "../../utils/stable-hash.js";
-import { json, jsonInput, num, numFlag, parseBooleanOption, } from "../coerce.js";
+import { json, jsonInput, num, numFlag, parseBooleanOption, readTextFile, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { enqueueCliWarning, isNotFoundError, readIfExists, skipResult, } from "../output.js";
 import { commandUsage, withUsage, } from "../syntax.js";
@@ -49,9 +48,9 @@ function splitPackageSpec(raw) {
  * (set-packages replaces specPackageList wholesale); only a call with no
  * package source flag at all is a usage error.
  */
-function codeEnvPackageList(flags) {
+async function codeEnvPackageList(flags) {
     const file = flags["file"];
-    const packages = typeof file === "string" ? splitPackageSpec(readFileSync(file, "utf-8")) : [];
+    const packages = typeof file === "string" ? splitPackageSpec(await readTextFile(file)) : [];
     if (typeof flags["packages"] === "string") {
         packages.push(...splitPackageSpec(flags["packages"]));
     }
@@ -122,7 +121,7 @@ export const codeEnvCommands = withUsage("code-env", {
             });
             const output = f["output"];
             if (typeof output === "string" && output.trim().length > 0) {
-                writeFileSync(output, result.log, "utf-8");
+                await Bun.write(output, result.log);
                 if (result.truncated || result.tailed) {
                     const limits = [
                         result.tailed ? `tail limited to ${maxLines ?? 500} lines` : undefined,
@@ -257,7 +256,7 @@ export const codeEnvCommands = withUsage("code-env", {
             const usage = commandUsage("code-env", "set-packages");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
-            const packages = codeEnvPackageList(f);
+            const packages = await codeEnvPackageList(f);
             const installCorePackages = parseBooleanOption(f["install-core-packages"], "--install-core-packages");
             const expectHash = validateExpectHash(f["expect-hash"]);
             if (executionMode(f).dryRun) {

package/dist/src/cli/commands/code.js

@@ -115,19 +115,33 @@ export const codeCommands = withUsage("code", {
                 maxLogBytes: run.maxLogBytes,
                 cleanup: run.cleanup,
                 ...(run.timedOut === true ? { timedOut: true, timeoutMs: run.timeoutMs, } : {}),
+                ...(run.outputTruncated === true ? { outputTruncated: true, } : {}),
+                ...(run.outputOmittedBytes !== undefined
+                    ? { outputOmittedBytes: run.outputOmittedBytes, }
+                    : {}),
             };
             if (f["full-log"] === true || run.output === undefined) {
                 result.log = run.log;
             }
+            if (run.outputTruncated === true) {
+                enqueueCliWarning({
+                    code: "code_run_output_truncated",
+                    hint: run.outputOmittedBytes !== undefined
+                        ? `Script output exceeded the capture budget; the first ${run.outputOmittedBytes} bytes were dropped and \`output\` holds the last part. Raise --max-log-bytes (the budget is a quarter of it) or print less.`
+                        : "The run log exceeded --max-log-bytes, so the start of the script output was cut and `output` holds the last part. Raise --max-log-bytes or print less.",
+                    ...(run.outputOmittedBytes !== undefined ? { omittedBytes: run.outputOmittedBytes, } : {}),
+                    maxLogBytes: run.maxLogBytes,
+                });
+            }
             if (run.cleanup.status === "failed") {
                 reportCleanupFailure({ scenarioId: run.scenarioId, error: run.cleanup.error ?? "unknown", });
             }
             return result;
         },
-        description: "Run Python through a throwaway custom-python scenario and return captured output plus outcome. --timeout caps waiting; --max-log-bytes caps logs; --full-log returns the capped raw log. Exits 4 unless outcome is SUCCESS.",
+        description: "Run Python through a throwaway custom-python scenario and return captured output plus outcome. --timeout caps waiting; --max-log-bytes caps the log tail read (script output keeps its last quarter; a code_run_output_truncated warning reports cuts); --full-log returns the capped raw log. Exits 4 unless outcome is SUCCESS.",
         examples: [
             "dss code run --file inspect.py",
-            "dss code run --file inspect.py --env py39_pandas",
+            "dss code run --file inspect.py --env py311_pandas",
             "cat snippet.py | dss code run --stdin",
             "dss code run --file inspect.py --full-log",
         ],

package/dist/src/cli/commands/dashboard.js

@@ -1,4 +1,3 @@
-import * as fs from "node:fs";
 import { ClientValidationError, } from "../../errors.js";
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { jsonInput, parseBooleanOption, } from "../coerce.js";
@@ -73,7 +72,7 @@ export const dashboardCommands = withUsage("dashboard", {
             if (!isPdf) {
                 throw new ClientValidationError("DSS dashboard export did not return a PDF.", "validation_failed", "Confirm DSS graphics export is configured and retry the export.");
             }
-            fs.writeFileSync(outputPath, bytes);
+            await Bun.write(outputPath, bytes);
             return {
                 path: outputPath,
                 bytes: bytes.length,

package/dist/src/cli/commands/dataset.js

@@ -143,7 +143,7 @@ export const datasetCommands = withUsage("dataset", {
             requireArgs(a, 1, commandUsage("dataset", "get"));
             return c.datasets.get(a[0], f["project-key"]);
         },
-        description: "Get full settings for a dataset.",
+        description: "Get the settings for a dataset (compact by default: empty values and metrics/version metadata are dropped, structure kept for get-edit-update; --full returns the raw DSS object).",
         examples: ["dss dataset get orders", "dss dataset get orders --project-key MYPROJ",],
     },
     schema: {
@@ -506,7 +506,7 @@ export const datasetCommands = withUsage("dataset", {
             requireArgs(a, 1, commandUsage("dataset", "info"));
             return c.datasets.info(a[0], f["project-key"]);
         },
-        description: "Get the full info object for a dataset (type, parameters, last build information, schema, etc.).",
+        description: "Get dataset info: type, connection, format, schema columns, flow recipes, buildability, data quality, and last modification (compact by default; --full returns the raw DSS info object).",
         examples: ["dss dataset info orders", "dss dataset info orders --project-key MYPROJ",],
     },
     "column-lineage": {

package/dist/src/cli/commands/flow-zone.js

@@ -275,7 +275,7 @@ export const flowZoneCommands = withUsage("flow-zone", {
         handler: async (c, _a, f) => {
             const usage = commandUsage("flow-zone", "organize");
             const pk = f["project-key"];
-            const parsed = readFlowZoneOrganizePlan(f, usage);
+            const parsed = await readFlowZoneOrganizePlan(f, usage);
             const sync = f["sync"] === true;
             const validateObjects = f["validate-objects"] === true;
             const recreateOnMove = f["recreate-on-move"] === true;

package/dist/src/cli/commands/job.js

@@ -1,12 +1,57 @@
-import { mkdir, writeFile, } from "node:fs/promises";
-import { dirname, resolve, } from "node:path";
-import { ClientValidationError, DataikuError, } from "../../errors.js";
+import { resolve, } from "node:path";
+import { ClientValidationError, DataikuError, dataikuErrorCode, } from "../../errors.js";
 import { asRecord, } from "../../utils/records.js";
 import { jobBuildTargetTypeFromFlags, jobLogFilterFromFlag, maxLogLinesFromFlags, num, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
+import { compactValue, } from "../list-output.js";
+import { COMPACT_LIST_FIELDS, } from "../list-shapes.js";
 import { encodedProjectEndpoint, enqueueCliWarning, } from "../output.js";
 import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
+/** Lines `job log` prints to stdout when no `--max-lines` is given. */
+const DEFAULT_STDOUT_LOG_LINES = 100;
+/**
+ * Tail a (filtered) job log for stdout. `0`/`-1` return everything; a
+ * truncated tail enqueues a `log_truncated` warning carrying the shown and
+ * total line counts.
+ */
+function tailJobLogForStdout(log, limit) {
+    if (!log || limit === 0 || limit === -1)
+        return log;
+    const lines = log.split(/\r?\n/);
+    const hasTrailingLineBreak = lines[lines.length - 1] === "";
+    if (hasTrailingLineBreak)
+        lines.pop();
+    const shown = Math.max(1, limit);
+    if (lines.length <= shown)
+        return log;
+    enqueueCliWarning({
+        code: "log_truncated",
+        shown,
+        total: lines.length,
+        hint: "Raise --max-lines (0 = all), add --errors-only, or use --output PATH.",
+    });
+    const tail = lines.slice(-shown).join("\n");
+    return hasTrailingLineBreak ? `${tail}\n` : tail;
+}
+const RESPONSE_TOO_LARGE_STATUS_TEXT = "Response Too Large";
+/** POSIX-shell quoting for a resume command argument. */
+function shellArg(value) {
+    return /^[\w.:@%+=,/-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+}
+/** Command that resumes waiting for a job whose wait timed out. */
+function jobWaitResumeCommand(jobId, projectKey) {
+    return `dss job wait ${shellArg(jobId)}${projectKey ? ` --project-key ${shellArg(projectKey)}` : ""}`;
+}
+/**
+ * A wait that timed out only stopped polling: the job is still running in DSS.
+ * Attach the command that resumes waiting; other results pass through.
+ */
+function withWaitResume(result, projectKey) {
+    if (result.timedOut !== true)
+        return result;
+    return { ...result, resume: jobWaitResumeCommand(result.jobId, projectKey), };
+}
 /**
  * With an empty output schema DSS ends a dataset build DONE after writing no
  * columns and no rows, without an error. Flag that after a successful build so
@@ -94,8 +139,9 @@ function jobSummaryType(job) {
         ?? "unknown";
 }
 function jobSummaryState(job) {
+    const listState = compactValue(job, COMPACT_LIST_FIELDS["job"]["state"]);
     return stringPath(job, ["baseStatus", "state",])
-        ?? stringPath(job, ["state",])
+        ?? (typeof listState === "string" ? listState : undefined)
         ?? "unknown";
 }
 function filteredJobList(jobs, flags) {
@@ -176,7 +222,19 @@ function jobDurationMs(details) {
 }
 async function jobInspectionSummary(client, jobId, flags) {
     const projectKey = flags["project-key"];
-    const details = await client.jobs.get(jobId, projectKey);
+    // A job-detail body over the buffered response cap must not sink the whole
+    // summary: keep the log part and report the details failure structurally.
+    let details = {};
+    let detailsError;
+    try {
+        details = await client.jobs.get(jobId, projectKey);
+    }
+    catch (error) {
+        if (!(error instanceof DataikuError && error.statusText === RESPONSE_TOO_LARGE_STATUS_TEXT)) {
+            throw error;
+        }
+        detailsError = { code: dataikuErrorCode(error.category), message: error.message, };
+    }
     let log;
     let logError;
     try {
@@ -207,6 +265,7 @@ async function jobInspectionSummary(client, jobId, flags) {
         jobId: jobSummaryId(details, jobId),
         state: jobSummaryState(details),
         type: jobSummaryType(details),
+        ...(detailsError ? { detailsError, } : {}),
         ...(durationMs !== undefined ? { durationMs, } : {}),
         ...(outputs !== undefined ? { outputs, } : {}),
         warnings: jobWarningSummary(details, log),
@@ -227,7 +286,7 @@ async function jobInspectionSummary(client, jobId, flags) {
 export const jobCommands = withUsage("job", {
     list: {
         handler: async (c, _a, f) => filteredJobList(await c.jobs.list(f["project-key"]), f),
-        description: "List recent jobs, optionally filtered for automation.",
+        description: "List recent jobs, optionally filtered for automation. In-progress jobs, which DSS lists without a state, show RUNNING; `job get` has the exact phase.",
         examples: ["dss job list --state DONE --latest", "dss job list --contains WLM225S --limit 10",],
     },
     get: {
@@ -235,7 +294,7 @@ export const jobCommands = withUsage("job", {
             requireArgs(a, 1, commandUsage("job", "get"));
             return c.jobs.get(a[0], f["project-key"]);
         },
-        description: "Get job details.",
+        description: "Get job state, outputs, progress, error, and per-activity status (compact by default; --full returns the raw DSS job object). The log tail is never included: use `dss job log ID --errors-only`.",
         examples: ["dss job get JOB_ID",],
     },
     summary: {
@@ -252,23 +311,41 @@ export const jobCommands = withUsage("job", {
             const logFilter = f["errors-only"] === true
                 ? "errors"
                 : jobLogFilterFromFlag(f["log-filter"]);
-            const log = await c.jobs.log(a[0], {
+            const outputFile = f["output"]
+                ?? f["output-file"];
+            const requestedLines = maxLogLinesFromFlags(f);
+            // Stdout is tailed here (not in the SDK) so the total can be reported.
+            const details = await c.jobs.logDetails(a[0], {
                 activity: f["activity"],
                 logId: f["log-id"],
                 logFilter,
-                maxLogLines: maxLogLinesFromFlags(f),
+                maxLogLines: outputFile ? requestedLines : -1,
                 projectKey: f["project-key"],
             });
-            const outputFile = f["output"]
-                ?? f["output-file"];
+            const log = details.text;
+            if (details.truncated) {
+                enqueueCliWarning({
+                    code: "log_truncated",
+                    reason: "byte_cap",
+                    earlyLinesDropped: true,
+                    maxLogBytes: details.maxLogBytes,
+                    hint: "Only the most recent part of the log was retrieved; early lines (and any earlier errors) were dropped. Use `dss job get` for job-level and per-activity errors.",
+                });
+            }
+            if (logFilter === "errors" && log.length === 0) {
+                enqueueCliWarning({
+                    code: "no_error_lines",
+                    scannedLines: details.scannedLines,
+                    hint: `No error lines matched in ${details.scannedLines} scanned log lines. Run \`dss job get ${a[0]}\` for the job-level and per-activity errors, or \`dss job log ${a[0]}\` without --errors-only for the full log.`,
+                });
+            }
             if (!outputFile)
-                return log;
+                return tailJobLogForStdout(log, requestedLines ?? DEFAULT_STDOUT_LOG_LINES);
             const outputPath = resolve(outputFile);
-            await mkdir(dirname(outputPath), { recursive: true, });
-            await writeFile(outputPath, log.endsWith("\n") ? log : `${log}\n`, "utf-8");
+            await Bun.write(outputPath, log.endsWith("\n") ? log : `${log}\n`);
             return outputPath;
         },
-        description: "Get public API job log output; find why a job failed. Use --errors-only (or --log-filter errors) to surface just error/traceback lines, and --output PATH to write the log to a file (stdout returns the path). --log-id is accepted for UI parity but DSS API-key auth cannot select browser-only cat-activity-log files.",
+        description: "Get public API job log output (last 100 lines by default; --max-lines N, 0 = all); find why a job failed. Use --errors-only for error/traceback lines and --output PATH to write it to a file (stdout returns the path). --log-id is accepted for UI parity; API keys cannot read browser-only cat-activity-log files.",
         examples: [
             "dss job log JOB_ID",
             "dss job log JOB_ID --activity main --max-log-lines 200",
@@ -321,7 +398,7 @@ export const jobCommands = withUsage("job", {
                 };
             }
             if (f["wait"] === true) {
-                const result = await c.jobs.buildAndWait(a[0], { ...options, projectKey: pk, });
+                const result = withWaitResume(await c.jobs.buildAndWait(a[0], { ...options, projectKey: pk, }), pk);
                 await warnIfBuiltDatasetHasNoColumns(c, a[0], options.targetType, result.success, pk);
                 return result;
             }
@@ -361,7 +438,7 @@ export const jobCommands = withUsage("job", {
                     method: "POST",
                 };
             }
-            const result = await c.jobs.buildAndWait(a[0], { ...options, projectKey: pk, });
+            const result = withWaitResume(await c.jobs.buildAndWait(a[0], { ...options, projectKey: pk, }), pk);
             await warnIfBuiltDatasetHasNoColumns(c, a[0], options.targetType, result.success, pk);
             return result;
         },
@@ -374,17 +451,19 @@ export const jobCommands = withUsage("job", {
         ],
     },
     wait: {
-        handler: (c, a, f) => {
+        handler: async (c, a, f) => {
             requireArgs(a, 1, commandUsage("job", "wait"));
-            return c.jobs.wait(a[0], {
+            const projectKey = f["project-key"];
+            const result = await c.jobs.wait(a[0], {
                 includeLogs: f["include-logs"] === true,
                 logFilter: jobLogFilterFromFlag(f["log-filter"]),
                 maxLogLines: maxLogLinesFromFlags(f),
                 pollIntervalMs: num(f["poll-interval"], "--poll-interval"),
                 timeoutMs: num(f["timeout"], "--timeout"),
                 summary: f["summary"] === true,
-                projectKey: f["project-key"],
+                projectKey,
             });
+            return withWaitResume(result, projectKey);
         },
         description: "Wait for an existing job to complete.",
         examples: [
@@ -404,7 +483,7 @@ export const jobCommands = withUsage("job", {
                 summary: f["summary"] !== false,
                 projectKey: f["project-key"],
             };
-            const jobs = await Promise.all(a.map((jobId) => c.jobs.wait(jobId, options)));
+            const jobs = await Promise.all(a.map(async (jobId) => withWaitResume(await c.jobs.wait(jobId, options), options.projectKey)));
             return aggregateJobWaitResults(jobs, String(f["until"] ?? "all-done"));
         },
         description: "Monitor one or more existing jobs and summarize progress counters from logs.",
@@ -422,7 +501,7 @@ export const jobCommands = withUsage("job", {
                 summary: true,
                 projectKey: f["project-key"],
             };
-            const jobs = await Promise.all(a.map((jobId) => c.jobs.wait(jobId, options)));
+            const jobs = await Promise.all(a.map(async (jobId) => withWaitResume(await c.jobs.wait(jobId, options), options.projectKey)));
             return aggregateJobWaitResults(jobs, String(f["until"] ?? "all-done"));
         },
         description: "Watch one or more existing jobs with progress extraction enabled.",

package/dist/src/cli/commands/plugin.js

@@ -1,7 +1,7 @@
-import * as fs from "node:fs";
+import { readFile, } from "node:fs/promises";
 import { validatedPluginGitUrl, validatePluginDestinationPath, validatePluginId, validatePluginName, validatePluginPath, } from "../../resources/plugins.js";
 import { writeResponseToFile, } from "../../utils/response-file.js";
-import { num, readStdinText, sha256Hex, } from "../coerce.js";
+import { num, readStdinText, readTextFile, sha256Hex, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { planResult, } from "../output.js";
 import { commandUsage, withUsage, } from "../syntax.js";
@@ -281,7 +281,7 @@ export const pluginCommands = withUsage("plugin", {
             requireArgs(a, 1, SETTINGS_SET_USAGE);
             const pluginId = validatePluginId(a[0]);
             const mode = executionMode(f);
-            const settings = readSettingsInput(f);
+            const settings = await readSettingsInput(f);
             if (mode.dryRun) {
                 return pluginPlan("settings-set", {
                     method: "POST",
@@ -330,7 +330,7 @@ export const pluginCommands = withUsage("plugin", {
         },
         description: "Create the code env of a plugin. Returns the DSS future (jobId); --wait polls it to completion.",
         examples: [
-            "dss plugin code-env-create my-plugin --python-interpreter PYTHON36",
+            "dss plugin code-env-create my-plugin --python-interpreter PYTHON311",
             "dss plugin code-env-create my-plugin --conda --wait --timeout 300000",
         ],
     },
@@ -629,7 +629,7 @@ export const pluginCommands = withUsage("plugin", {
                 });
             }
             const content = typeof f["file"] === "string"
-                ? fs.readFileSync(f["file"])
+                ? await readFile(f["file"])
                 : typeof f["content"] === "string"
                     ? f["content"]
                     : await readStdinText();
@@ -738,10 +738,10 @@ function normalizeCreationMode(value) {
     }
     throw new UsageError("--creation-mode must be one of EMPTY, GIT_CLONE, GIT_EXPORT.", "invalid_enum");
 }
-function readSettingsInput(flags) {
+async function readSettingsInput(flags) {
     let text;
     if (typeof flags["file"] === "string") {
-        text = fs.readFileSync(flags["file"], "utf-8");
+        text = await readTextFile(flags["file"]);
     }
     else if (typeof flags["content"] === "string") {
         text = flags["content"];

package/dist/src/cli/commands/project-library.js

@@ -159,7 +159,7 @@ export const projectLibraryCommands = withUsage("project-library", {
             const content = typeof f["content"] === "string"
                 ? f["content"]
                 : typeof f["file"] === "string"
-                    ? fs.readFileSync(f["file"])
+                    ? await fs.promises.readFile(f["file"])
                     : await readStdinText();
             const result = await c.projectLibrary.addOrUpdateFile(a[0], content, pk, expectSha256 !== undefined ? { expectSha256, } : undefined);
             return {
@@ -184,7 +184,7 @@ export const projectLibraryCommands = withUsage("project-library", {
             const local = typeof f["content"] === "string"
                 ? f["content"]
                 : typeof f["file"] === "string"
-                    ? fs.readFileSync(f["file"])
+                    ? await fs.promises.readFile(f["file"])
                     : await readStdinText();
             return c.projectLibrary.diffFile(a[0], local, pk, maxLines !== undefined ? { maxLines, } : {});
         },