dataiku-sdk 0.12.4 → 0.12.5

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

@@ -124,7 +124,7 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.setDefinition(a[0], a[1], definition);
         },
-        usage: "dss code-env set-definition <lang> <name> [--data JSON|--data-file PATH|--stdin] [--dry-run]",
+        usage: "dss code-env set-definition <lang> <name> (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: "Replace a code environment definition previously fetched from DSS.",
         examples: ["dss code-env set-definition PYTHON my_env --data-file code-env.json --dry-run",],
     },
@@ -146,7 +146,7 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.setPackages(a[0], a[1], packages, { installCorePackages, });
         },
-        usage: "dss code-env set-packages <lang> <name> [--packages PKGS|--package PKG|--file PATH] [--install-core-packages true|false] [--dry-run]",
+        usage: "dss code-env set-packages <lang> <name> (--packages PKGS|--package PKG|--file PATH) [--install-core-packages true|false] [--dry-run]",
         description: "Update requested package specs without rebuilding packages.",
         examples: [
             "dss code-env set-packages PYTHON my_env --packages 'tabulate\\nnameparser' --dry-run",

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

@@ -73,7 +73,7 @@ export const dashboardCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss dashboard update <id> [--name NAME|--data JSON|--data-file PATH|--stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss dashboard update <id> (--name NAME|--data JSON|--data-file PATH|--stdin) [--dry-run] [--project-key KEY]",
         description: "Update dashboard settings via merge.",
         examples: ["dss dashboard update DASHBOARD_ID --name 'New name' --dry-run",],
     },

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

@@ -89,7 +89,7 @@ export const datasetCommands = {
             await c.datasets.updateSchema(a[0], columns, pk);
             return { updated: a[0], resource: "dataset", schema: { columns, }, };
         },
-        usage: "dss dataset refresh-schema <name> [--data JSON | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss dataset refresh-schema <name> (--data JSON | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Replace a dataset schema through the DSS schema endpoint.",
         examples: [
             `dss dataset refresh-schema orders --data '{"columns":[{"name":"id","type":"bigint"}]}' --dry-run`,
@@ -278,7 +278,7 @@ export const datasetCommands = {
             await c.datasets.update(a[0], data, pk);
             return { updated: a[0], resource: "dataset", };
         },
-        usage: "dss dataset update <name> [--data '{...}' | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss dataset update <name> (--data '{...}' | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Update dataset settings via JSON merge.",
         examples: [
             'dss dataset update orders --data \'{"tags":["production"]}\' --dry-run',

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

@@ -89,7 +89,7 @@ export const folderCommands = {
             await c.folders.update(folderId, data, pk);
             return { updated: folderId, resource: "folder", };
         },
-        usage: "dss folder update <name-or-id> [--data JSON | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss folder update <name-or-id> (--data JSON | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Update managed folder settings by deep-merging a JSON patch.",
         examples: [
             'dss folder update exports --data \'{"tags":["agent"]}\' --dry-run',

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

@@ -84,7 +84,7 @@ export const insightCommands = {
     },
     update: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss insight update <id> [--name NAME|--params JSON|--data JSON]");
+            requireArgs(a, 1, "dss insight update <id> (--name NAME|--listed true|false|--params JSON|--content TEXT|--file PATH|--content-type MIME|--data JSON|--data-file PATH|--stdin)");
             const data = jsonInput(f);
             const name = f["name"];
             const params = json(f["params"]);
@@ -130,7 +130,7 @@ export const insightCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss insight update <id> [--name NAME] [--listed true|false] [--params JSON] [--content TEXT|--file PATH --content-type MIME] [--data JSON|--data-file PATH|--stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss insight update <id> (--name NAME|--listed true|false|--params JSON|--content TEXT|--file PATH|--content-type MIME|--data JSON|--data-file PATH|--stdin) [--dry-run] [--project-key KEY]",
         description: "Update an insight using GET-before-POST merge semantics.",
         examples: ["dss insight update INSIGHT_ID --name 'Updated' --dry-run",],
     },

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

@@ -172,7 +172,7 @@ export const notebookCommands = {
             }
             return { saved: a[0], resource: "jupyter-notebook", };
         },
-        usage: "dss notebook save-jupyter <name> [--data '{...}' | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss notebook save-jupyter <name> (--data '{...}' | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Save content to a Jupyter notebook, creating it if missing.",
         examples: [
             "dss notebook save-jupyter my_notebook --data-file notebook.json --dry-run",
@@ -207,7 +207,7 @@ export const notebookCommands = {
             }
             return { saved: a[0], resource: "sql-notebook", };
         },
-        usage: "dss notebook save-sql <id> [--data '{...}' | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss notebook save-sql <id> (--data '{...}' | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Save content to a SQL notebook, creating it if missing.",
         examples: ["dss notebook save-sql my_sql_notebook --data-file content.json --dry-run",],
     },

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

@@ -265,7 +265,7 @@ export const recipeCommands = {
     },
     clone: {
         handler: async (c, a, f) => {
-            const usage = "dss recipe clone [source|--from SOURCE] (--name NAME|--to NAME) [--replace-input FROM=TO] [--replace-output FROM=TO] [--replace-payload-text FROM=TO] [--output DATASET] [--copy-output-settings] [--path PATH] [--metastore-table TABLE] [--zone ZONE|--zone-id ID] [--dry-run] [--project-key KEY]";
+            const usage = "dss recipe clone (source|--from SOURCE) (--name NAME|--to NAME) [--replace-input FROM=TO] [--replace-output FROM=TO] [--replace-payload-text FROM=TO] [--output DATASET] [--copy-output-settings] [--path PATH] [--metastore-table TABLE] [--zone ZONE|--zone-id ID] [--dry-run] [--project-key KEY]";
             const fromFlag = typeof f["from"] === "string" ? f["from"].trim() : "";
             const sourceName = a[0] ?? fromFlag;
             if (!sourceName) {
@@ -333,7 +333,7 @@ export const recipeCommands = {
             const moved = await moveCreatedItemsToZone(c, f, [{ objectId: name, objectType: "RECIPE", },], pk);
             return { ...cloned, resource: "recipe", ...moved, };
         },
-        usage: "dss recipe clone [source|--from SOURCE] (--name NAME|--to NAME) [--replace-input FROM=TO] [--replace-output FROM=TO] [--replace-payload-text FROM=TO] [--output DATASET] [--copy-output-settings] [--path PATH] [--metastore-table TABLE] [--zone ZONE|--zone-id ID] [--dry-run] [--project-key KEY]",
+        usage: "dss recipe clone (source|--from SOURCE) (--name NAME|--to NAME) [--replace-input FROM=TO] [--replace-output FROM=TO] [--replace-payload-text FROM=TO] [--output DATASET] [--copy-output-settings] [--path PATH] [--metastore-table TABLE] [--zone ZONE|--zone-id ID] [--dry-run] [--project-key KEY]",
         description: "Clone a recipe graph/settings/payload into a separate experiment recipe.",
         examples: [
             "dss recipe clone compute_orders --name compute_orders_opt --output orders_opt --copy-output-settings --dry-run",
@@ -384,7 +384,7 @@ export const recipeCommands = {
             await c.recipes.update(a[0], data, pk);
             return { updated: a[0], resource: "recipe", };
         },
-        usage: "dss recipe update <name> [--data '{...}' | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss recipe update <name> (--data '{...}' | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Update recipe settings via JSON merge. Recipe definition fields must be nested under a top-level recipe key.",
         examples: [
             "dss recipe update compute_orders --data-file settings.json --dry-run",

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

@@ -180,7 +180,7 @@ export const scenarioCommands = {
                 unchangedPaths: result.unchangedPaths,
             };
         },
-        usage: "dss scenario update <id> [--data '{...}' | --data-file PATH | --stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss scenario update <id> (--data '{...}' | --data-file PATH | --stdin) [--dry-run] [--project-key KEY]",
         description: "Update scenario settings via JSON merge; edit step-based scenario steps at params.steps, not rawParams.params.steps.",
         examples: [
             'dss scenario update my_scenario --data \'{"params":{"steps":[]}}\' --dry-run',

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

@@ -3,7 +3,7 @@ import { mkdir, writeFile, } from "node:fs/promises";
 import { dirname, resolve, } from "node:path";
 import { readStdinText, stripUtf8Bom, } from "../coerce.js";
 import { UsageError, } from "../usage.js";
-const SQL_QUERY_USAGE = "dss sql query [SQL | --sql QUERY | --sql-file PATH | --sql - | --stdin] (--connection CONN | --dataset FULL_NAME) [--database DB] [--output PATH|--output-file PATH] [--preview N] [--request-timeout MS] [--project-key KEY]";
+const SQL_QUERY_USAGE = "dss sql query (SQL | --sql QUERY | --sql-file PATH | --sql - | --stdin) (--connection CONN | --dataset FULL_NAME) [--database DB] [--output PATH|--output-file PATH] [--preview N] [--request-timeout MS] [--project-key KEY]";
 const DEFAULT_SQL_PREVIEW_ROWS = 5;
 /**
  * Parse `--preview N` into a non-negative row count. Rejects non-integers,

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

@@ -39,7 +39,7 @@ export const variableCommands = {
                 projectKey: pk,
             });
         },
-        usage: `dss variable set --standard '{"k":"v"}' --local '{"k":"v"}' [--replace] [--dry-run] [--project-key KEY]`,
+        usage: `dss variable set (--standard '{"k":"v"}'|--local '{"k":"v"}') [--replace] [--dry-run] [--project-key KEY]`,
         description: "Set project variables via JSON merge (or full replace with --replace).",
         examples: [
             'dss variable set --standard \'{"env":"staging"}\' --dry-run',

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

@@ -97,7 +97,7 @@ export const wikiCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss wiki update <id-or-name> [--name NAME] [--content TEXT|--file PATH|--data JSON|--data-file PATH|--stdin] [--dry-run] [--project-key KEY]",
+        usage: "dss wiki update <id-or-name> (--name NAME | --content TEXT|--file PATH|--data JSON|--data-file PATH|--stdin) [--dry-run] [--project-key KEY]",
         description: "Update wiki article metadata/body via merge.",
         examples: ["dss wiki update ARTICLE_ID --content '# Updated' --dry-run",],
     },

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

@@ -22,6 +22,7 @@ export interface CommandExitCodes {
     error: 2;
     transient: 3;
     longRunningFailure?: 4;
+    assertionFailure?: 4;
 }
 export type CommandFlagMetadata = {
     name: string;
@@ -29,6 +30,7 @@ export type CommandFlagMetadata = {
     valueType?: string;
     enumValues?: string[];
     aliases?: string[];
+    allowEmptyValue?: boolean;
 };
 export interface CommandStructuredExample {
     shell: string;
@@ -78,11 +80,12 @@ export interface CommandRegistryEntry {
     cleanupHint?: string;
     agentContractVersion: number;
 }
-export declare const COMMANDS_USAGE = "dss commands run [--json]";
-export declare const AGENT_CONTRACT_USAGE = "dss agent contract";
+export declare const COMMANDS_USAGE = "dss commands run [--fields PATHS] [--json]";
+export declare const AGENT_CONTRACT_COMMAND = "dss agent contract";
+export declare const AGENT_CONTRACT_USAGE = "dss agent contract [--fields PATHS] [--json]";
 export declare const CLEANUP_USAGE = "dss cleanup --file PATH [--dry-run|--apply] [--continue-on-error]";
 export declare function isAllowedCleanupAction(resource: string, action: string): boolean;
-export declare function buildCommandSchemas(resource: string, action: string, flags: CommandFlagMetadata[], positionals: string[], requiredFlags: string[], requiredOneOf: CommandFlagChoice[], payloadSchema: CommandPayloadSchema | undefined, outputShape: CommandOutputShape): CommandAgentSchemas;
+export declare function buildCommandSchemas(resource: string, action: string, flags: CommandFlagMetadata[], requiredFlags: string[], requiredOneOf: CommandFlagChoice[], payloadSchema: CommandPayloadSchema | undefined, outputShape: CommandOutputShape, usage: string): CommandAgentSchemas;
 export declare function inferRequiresProject(resource: string, _action: string, usage: string): boolean;
 export declare function inferInputContract(usage: string): CommandInputContract;
 export declare function supportsCleanupLedger(resource: string, action: string): boolean;
@@ -99,6 +102,12 @@ export declare function commandPlanShape(resource: string, action: string, args:
     wait?: unknown;
 };
 export declare function buildMutationPlan(resource: string, action: string, meta: CommandMeta, args: string[], flags: Record<string, string | boolean>): Record<string, unknown>;
+/**
+ * Batch plans may surface exit 4: any dispatched step can be a long-running
+ * lifecycle command whose remote work fails, or a synchronous assertion
+ * mismatch (`recipe assert-unchanged`). Batch itself stays async "none".
+ */
+export declare const BATCH_PLAN_EXIT_CODES: Record<string, number>;
 export declare const BATCH_USAGE = "dss batch (--data JSON|--data-file PATH|--stdin) [--continue-on-error] [--dry-run]";
 export declare const BATCH_HINT = "Pass a JSON array of argv arrays, e.g. [[\"dataset\",\"list\"],[\"recipe\",\"update\",\"r\",\"--data-file\",\"p.json\"]].";
 export declare const BATCH_EXAMPLE_PAYLOAD: string[][];