dataiku-sdk 0.10.1 → 0.12.0

package/dist/src/client.d.ts

@@ -1,4 +1,5 @@
 import { type Static, type TSchema } from "@sinclair/typebox";
+import { AnalysesResource } from "./resources/analyses.js";
 import { ApiDeployerResource } from "./resources/api-deployer.js";
 import { ApiServicesResource } from "./resources/api-services.js";
 import { ApplicationsResource } from "./resources/applications.js";
@@ -17,10 +18,13 @@ import { InsightsResource } from "./resources/insights.js";
 import { JobsResource } from "./resources/jobs.js";
 import { MeaningsResource } from "./resources/meanings.js";
 import { MetricsResource } from "./resources/metrics.js";
+import { MlTasksResource } from "./resources/ml-tasks.js";
+import { ModelEvaluationStoresResource } from "./resources/model-evaluation-stores.js";
 import { NotebooksResource } from "./resources/notebooks.js";
 import { ProjectLibraryResource } from "./resources/project-library.js";
 import { ProjectsResource } from "./resources/projects.js";
 import { RecipesResource } from "./resources/recipes.js";
+import { SavedModelsResource } from "./resources/saved-models.js";
 import { ScenariosResource } from "./resources/scenarios.js";
 import { SqlResource } from "./resources/sql.js";
 import { StatisticsResource } from "./resources/statistics.js";
@@ -107,6 +111,10 @@ export declare class DataikuClient {
     private workspacesResource?;
     private metricsResource?;
     private meaningsResource?;
+    private analysesResource?;
+    private mlTasksResource?;
+    private savedModelsResource?;
+    private modelEvaluationStoresResource?;
     get projects(): ProjectsResource;
     get datasets(): DatasetsResource;
     get dashboards(): DashboardsResource;
@@ -138,7 +146,11 @@ export declare class DataikuClient {
     get workspaces(): WorkspacesResource;
     get metrics(): MetricsResource;
     get meanings(): MeaningsResource;
-    constructor(config: DataikuClientConfig);
+    get analyses(): AnalysesResource;
+    get mlTasks(): MlTasksResource;
+    get savedModels(): SavedModelsResource;
+    get modelEvaluationStores(): ModelEvaluationStoresResource;
+    constructor(config?: DataikuClientConfig);
     getRequestTimeoutMs(): number;
     resolveProjectKey(paramValue?: string): string;
     get<T = unknown>(path: string): Promise<T>;

package/dist/src/client.js

@@ -3,6 +3,7 @@ import { getCACertificates, } from "node:tls";
 import { Value, } from "@sinclair/typebox/value";
 import { safeParseSchema, } from "./schemas.js";
 import { classifyDataikuError, DataikuError, } from "./errors.js";
+import { AnalysesResource, } from "./resources/analyses.js";
 import { ApiDeployerResource, } from "./resources/api-deployer.js";
 import { ApiServicesResource, } from "./resources/api-services.js";
 import { ApplicationsResource, } from "./resources/applications.js";
@@ -21,10 +22,13 @@ import { InsightsResource, } from "./resources/insights.js";
 import { JobsResource, } from "./resources/jobs.js";
 import { MeaningsResource, } from "./resources/meanings.js";
 import { MetricsResource, } from "./resources/metrics.js";
+import { MlTasksResource, } from "./resources/ml-tasks.js";
+import { ModelEvaluationStoresResource, } from "./resources/model-evaluation-stores.js";
 import { NotebooksResource, } from "./resources/notebooks.js";
 import { ProjectLibraryResource, } from "./resources/project-library.js";
 import { ProjectsResource, } from "./resources/projects.js";
 import { RecipesResource, } from "./resources/recipes.js";
+import { SavedModelsResource, } from "./resources/saved-models.js";
 import { ScenariosResource, } from "./resources/scenarios.js";
 import { SqlResource, } from "./resources/sql.js";
 import { StatisticsResource, } from "./resources/statistics.js";
@@ -176,6 +180,10 @@ export class DataikuClient {
     workspacesResource;
     metricsResource;
     meaningsResource;
+    analysesResource;
+    mlTasksResource;
+    savedModelsResource;
+    modelEvaluationStoresResource;
     get projects() {
         return (this.projectsResource ??= new ProjectsResource(this));
     }
@@ -269,23 +277,36 @@ export class DataikuClient {
     get meanings() {
         return (this.meaningsResource ??= new MeaningsResource(this));
     }
+    get analyses() {
+        return (this.analysesResource ??= new AnalysesResource(this));
+    }
+    get mlTasks() {
+        return (this.mlTasksResource ??= new MlTasksResource(this));
+    }
+    get savedModels() {
+        return (this.savedModelsResource ??= new SavedModelsResource(this));
+    }
+    get modelEvaluationStores() {
+        return (this.modelEvaluationStoresResource ??= new ModelEvaluationStoresResource(this));
+    }
     constructor(config) {
-        const url = config.url?.trim();
-        if (!url)
-            throw new Error("DataikuClientConfig.url is required and must not be empty");
-        const apiKey = config.apiKey?.trim();
-        if (!apiKey)
-            throw new Error("DataikuClientConfig.apiKey is required and must not be empty");
+        const envUrl = process.env["DATAIKU_URL"]?.trim();
+        const envApiKey = process.env["DATAIKU_API_KEY"]?.trim();
+        const url = config?.url?.trim() || envUrl;
+        const apiKey = config?.apiKey?.trim() || envApiKey;
+        if (!url || !apiKey) {
+            throw new Error("Dataiku URL and API key are required: pass {url, apiKey} or set DATAIKU_URL/DATAIKU_API_KEY");
+        }
         this.baseUrl = url.replace(/\/+$/, "");
         this.apiKey = apiKey;
-        this.defaultProjectKey = config.projectKey?.trim() || undefined;
-        this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-        const rawMax = config.retryMaxAttempts ?? DEFAULT_RETRY_MAX_ATTEMPTS;
+        this.defaultProjectKey = config?.projectKey?.trim() || undefined;
+        this.requestTimeoutMs = config?.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        const rawMax = config?.retryMaxAttempts ?? DEFAULT_RETRY_MAX_ATTEMPTS;
         this.retryMaxAttempts = Math.min(Math.max(1, rawMax), MAX_RETRY_ATTEMPTS_CAP);
-        this.verbose = config.verbose === true;
-        this.tlsOptions = buildFetchTlsOptions(config);
-        this.onTrace = config.onTrace ?? defaultTrace;
-        this.onValidationWarning = config.onValidationWarning ?? defaultValidationWarning;
+        this.verbose = config?.verbose === true;
+        this.tlsOptions = config ? buildFetchTlsOptions(config) : undefined;
+        this.onTrace = config?.onTrace ?? defaultTrace;
+        this.onValidationWarning = config?.onValidationWarning ?? defaultValidationWarning;
     }
     getRequestTimeoutMs() {
         return this.requestTimeoutMs;

package/dist/src/errors.d.ts

@@ -15,6 +15,12 @@ export interface DataikuRetryMetadata {
     delaysMs: number[];
     timedOut: boolean;
 }
+export declare class ClientValidationError extends Error {
+    readonly code: StableErrorCode;
+    readonly hint?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code?: StableErrorCode, hint?: string, details?: Record<string, unknown>);
+}
 export declare function classifyDataikuError(status: number, body: string): DataikuErrorTaxonomy;
 export declare class DataikuError extends Error {
     status: number;

package/dist/src/errors.js

@@ -12,8 +12,71 @@ export function dataikuErrorCode(category) {
             return "internal_error";
     }
 }
+export class ClientValidationError extends Error {
+    code;
+    hint;
+    details;
+    constructor(message, code = "validation_failed", hint, details) {
+        super(message);
+        this.name = "ClientValidationError";
+        this.code = code;
+        this.hint = hint;
+        this.details = details;
+    }
+}
 const TLS_CERTIFICATE_HINT = "TLS certificate verification failed. Trust the DSS/corporate CA with --ca-cert PATH or NODE_EXTRA_CA_CERTS; use --insecure only for temporary troubleshooting.";
 const BUSINESS_APPS_API_UNAVAILABLE_HINT = "Business Apps API is not available on this DSS instance. Use classic app commands or check DSS version/feature availability.";
+const MAX_ERROR_SUMMARY_LENGTH = 200;
+function isHtmlResponseBody(body) {
+    const lowerTrimmed = body.trimStart().slice(0, 500).toLowerCase();
+    return lowerTrimmed.startsWith("<")
+        || lowerTrimmed.includes("<!doctype html")
+        || lowerTrimmed.includes("<html")
+        || lowerTrimmed.includes("<body")
+        || lowerTrimmed.includes("<title");
+}
+function stripServerFilesystemPaths(text) {
+    return text
+        .replace(/\b[A-Za-z]:\\[^\s"'`<>),\]}]+/g, "[server path]")
+        .replace(/(^|[\s("'`[{])\/(?=[^\s"'`<>),\]}]*\/)(?!(?:public|dip|api|backend|auth|login|projects?|datasets?|recipes?|scenarios?|folders?)(?:\/|$))[^\s"'`<>),\]}]+/g, "$1[server path]");
+}
+function decodeHtmlEntities(text) {
+    return text
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/gi, "'");
+}
+function firstHtmlTextLine(body) {
+    const text = decodeHtmlEntities(body
+        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, "\n"));
+    return text
+        .split(/\r?\n/g)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+}
+function conciseErrorSummary(text) {
+    const sanitized = stripServerFilesystemPaths(text);
+    return sanitized.length > MAX_ERROR_SUMMARY_LENGTH
+        ? `${sanitized.slice(0, MAX_ERROR_SUMMARY_LENGTH)}…`
+        : sanitized;
+}
+function summarizeHtmlErrorBody(body) {
+    const textLine = firstHtmlTextLine(body);
+    if (!textLine)
+        return "HTML error page from DSS";
+    return `HTML error page from DSS: ${conciseErrorSummary(textLine)}`;
+}
+function summarizeErrorText(text) {
+    if (isHtmlResponseBody(text))
+        return summarizeHtmlErrorBody(text);
+    return conciseErrorSummary(text);
+}
 function isCertificateTrustFailure(lowerBody) {
     return lowerBody.includes("unable to verify the first certificate")
         || lowerBody.includes("unable to get local issuer certificate")
@@ -69,6 +132,15 @@ export function classifyDataikuError(status, body) {
             retryHint: "SQL recipes require SQL/Athena-backed input datasets. Use a SQL-compatible input, associate the S3 dataset with Athena, or create a Python recipe for file/S3 inputs.",
         };
     }
+    const isLicenseDenied = status >= 400
+        && lowerBody.includes("license does not allow");
+    if (isLicenseDenied) {
+        return {
+            category: "forbidden",
+            retryable: false,
+            retryHint: "DSS license or enabled features do not allow this operation. Contact a DSS administrator; do not retry unchanged.",
+        };
+    }
     const isMissingDatasetRootPath = status === 500
         && lowerBody.includes("root path of the dataset")
         && lowerBody.includes("does not exist");
@@ -79,10 +151,36 @@ export function classifyDataikuError(status, body) {
             retryHint: "Dataset files are missing on storage. Build/materialize the dataset or upstream recipes before preview/download.",
         };
     }
+    const isReadDirectoryAsFile = status >= 500
+        && lowerBody.includes("cannot read directory as file");
+    if (isReadDirectoryAsFile) {
+        return {
+            category: "validation",
+            retryable: false,
+            retryHint: "The path refers to a directory, not a file. List its contents instead of reading it as a file; do not retry unchanged.",
+        };
+    }
+    const apostropheNormalizedBody = lowerBody.replace(/\\u0027|\u2019/g, "'");
+    const isServerObjectMissingContraction = status >= 500
+        && apostropheNormalizedBody.includes("doesn't exist");
+    if (isServerObjectMissingContraction) {
+        return {
+            category: "not_found",
+            retryable: false,
+            retryHint: "Requested object was not found. Verify the identifier before retrying.",
+        };
+    }
+    const hasServerMissingObjectToken = lowerBody.includes("package")
+        || lowerBody.includes("directory");
+    const hasServerMissingObjectLanguage = lowerBody.includes("does not exist")
+        || lowerBody.includes("not found");
+    const isServerFilesystemNotFoundLike = status >= 500
+        && (lowerBody.includes("not a file")
+            || (hasServerMissingObjectToken && hasServerMissingObjectLanguage));
     const isServerNotFoundLike = status >= 500
         && (lowerBody.includes("not found") || lowerBody.includes("does not exist"))
         && ["dataset", "recipe", "scenario", "project", "folder",].some((token) => lowerBody.includes(token));
-    if (isServerNotFoundLike) {
+    if (isServerFilesystemNotFoundLike || isServerNotFoundLike) {
         return {
             category: "not_found",
             retryable: false,
@@ -133,7 +231,7 @@ export function classifyDataikuError(status, body) {
                 retryHint: BUSINESS_APPS_API_UNAVAILABLE_HINT,
             };
         }
-        const isHtmlGatewayResponse = lowerBody.includes("<!doctype html>");
+        const isHtmlGatewayResponse = isHtmlResponseBody(body);
         return {
             category: "not_found",
             retryable: false,
@@ -195,14 +293,14 @@ export class DataikuError extends Error {
         try {
             const parsed = JSON.parse(body);
             if (parsed.message)
-                return String(parsed.message);
+                return summarizeErrorText(String(parsed.message));
         }
         catch {
             // not JSON — use raw body
         }
         if (!body)
             return "(empty response body)";
-        return body.length > 200 ? `${body.slice(0, 200)}…` : body;
+        return summarizeErrorText(body);
     }
     static formatRetryMetadata(retry) {
         if (!retry)

package/dist/src/index.d.ts

@@ -1,7 +1,8 @@
 export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, } from "./client.js";
 export { type CredentialValidationOptions, type CredentialValidationResult, validateCredentials, } from "./auth.js";
 export { type DssCredentials, getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
-export { DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
+export { ClientValidationError, DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
+export * from "./resources/analyses.js";
 export { ApiDeployerResource, } from "./resources/api-deployer.js";
 export { ApiServicesResource, } from "./resources/api-services.js";
 export { ApplicationsResource, } from "./resources/applications.js";
@@ -20,10 +21,13 @@ export { InsightsResource, } from "./resources/insights.js";
 export { computeNextPollDelayMs, type JobBuildAndWaitOptions, type JobBuildOptions, type JobBuildTarget, type JobBuildTargetType, type JobLogFilter, type JobLogProgress, type JobLogSummary, JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
 export { MeaningsResource, } from "./resources/meanings.js";
 export { MetricsResource, } from "./resources/metrics.js";
+export * from "./resources/ml-tasks.js";
+export * from "./resources/model-evaluation-stores.js";
 export { NotebooksResource, } from "./resources/notebooks.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { type FlowMapResult, ProjectsResource, } from "./resources/projects.js";
 export { type RecipeCloneOptions, type RecipeCloneResult, type RecipeGraphReference, type RecipeGraphValidationResult, type RecipeRunOptions, type RecipeRunOutput, type RecipeRunResult, RecipesResource, } from "./resources/recipes.js";
+export * from "./resources/saved-models.js";
 export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, type ScenarioFieldChange, type ScenarioFieldMismatch, type ScenarioScriptRunResult, ScenariosResource, type ScenarioUpdateNormalization, type ScenarioUpdatePreview, scenarioUpdatePreview, type ScenarioUpdateResult, } from "./resources/scenarios.js";
 export { SqlResource, } from "./resources/sql.js";
 export { StatisticsResource, } from "./resources/statistics.js";
@@ -32,9 +36,9 @@ export { VariablesResource, } from "./resources/variables.js";
 export { WebappsResource, } from "./resources/webapps.js";
 export { WikiResource, } from "./resources/wiki.js";
 export { WorkspacesResource, } from "./resources/workspaces.js";
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
 export type { SafeParseResult, } from "./schemas.js";
-export type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdatePackagesOptions, CodeEnvUsage, CodeEnvWaitOptions, ConnectionSummary, DashboardDetails, DashboardSummary, DataQualityComputeResult, DataQualityProjectStatus, DataQualityRule, DataQualityRuleResult, DataQualityRules, DataQualityStatus, DataQualityStatusByPartition, DataQualityTimeline, DataQualityTimelineEntry, DatasetCreateOptions, DatasetDetails, DatasetSchema, DatasetSummary, FlowMapOptions, FlowZone, FlowZoneCreateOptions, FlowZoneItem, FlowZoneObjectType, FlowZonePosition, FlowZoneUpdateOptions, FolderCreateOptions, FolderDetails, FolderItem, FolderSummary, FutureState, FutureWaitResult, InsightDetails, InsightSummary, JobSummary, JobWaitResult, JupyterCell, JupyterNotebookContent, JupyterNotebookSummary, NotebookSession, ProjectDetails, ProjectMetadata, ProjectSummary, ProjectVariables, RecipeCreateOptions, RecipeCreateResult, RecipeDetails, RecipeSummary, ScenarioDetails, ScenarioStatus, ScenarioSummary, ScenarioWaitResult, SqlNotebookCell, SqlNotebookContent, SqlNotebookSummary, SqlQueryResponse, SqlQueryResult, SqlQuerySchema, WikiArticleData, WikiArticleMetadata, WikiSettings, WikiTaxonomyNode, } from "./schemas.js";
+export type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdatePackagesOptions, CodeEnvUsage, CodeEnvWaitOptions, ConnectionSummary, DashboardDetails, DashboardSummary, DataQualityComputeResult, DataQualityProjectStatus, DataQualityRule, DataQualityRuleResult, DataQualityRules, DataQualityStatus, DataQualityStatusByPartition, DataQualityTimeline, DataQualityTimelineEntry, DatasetCreateOptions, DatasetDetails, DatasetSchema, DatasetSummary, FlowMapOptions, FlowZone, FlowZoneCreateOptions, FlowZoneItem, FlowZoneObjectType, FlowZonePosition, FlowZoneUpdateOptions, FolderCreateOptions, FolderDetails, FolderItem, FolderSummary, FutureState, FutureWaitResult, InsightDetails, InsightSummary, JobSummary, JobWaitResult, JupyterCell, JupyterNotebookContent, JupyterNotebookSummary, NotebookSession, ProjectDetails, ProjectMetadata, ProjectSummary, ProjectVariables, RecipeCreateOptions, RecipeCreateResult, RecipeDetails, RecipeSummary, ScenarioDetails, ScenarioStatus, ScenarioStepRun, ScenarioSummary, ScenarioWaitResult, SqlNotebookCell, SqlNotebookContent, SqlNotebookSummary, SqlQueryResponse, SqlQueryResult, SqlQuerySchema, WikiArticleData, WikiArticleMetadata, WikiSettings, WikiTaxonomyNode, } from "./schemas.js";
 export { deepMerge, } from "./utils/deep-merge.js";
 export { type NormalizedFlowEdge, type NormalizedFlowMap, type NormalizedFlowNode, normalizeFlowGraph, } from "./utils/flow-map.js";
 export { sanitizeFileName, } from "./utils/sanitize.js";

package/dist/src/index.js

@@ -4,8 +4,9 @@ export { DataikuClient, } from "./client.js";
 export { validateCredentials, } from "./auth.js";
 export { getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
 // Errors
-export { DataikuError, } from "./errors.js";
+export { ClientValidationError, DataikuError, } from "./errors.js";
 // Resources (for advanced use / extension)
+export * from "./resources/analyses.js";
 export { ApiDeployerResource, } from "./resources/api-deployer.js";
 export { ApiServicesResource, } from "./resources/api-services.js";
 export { ApplicationsResource, } from "./resources/applications.js";
@@ -24,10 +25,13 @@ export { InsightsResource, } from "./resources/insights.js";
 export { computeNextPollDelayMs, JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
 export { MeaningsResource, } from "./resources/meanings.js";
 export { MetricsResource, } from "./resources/metrics.js";
+export * from "./resources/ml-tasks.js";
+export * from "./resources/model-evaluation-stores.js";
 export { NotebooksResource, } from "./resources/notebooks.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { ProjectsResource, } from "./resources/projects.js";
 export { RecipesResource, } from "./resources/recipes.js";
+export * from "./resources/saved-models.js";
 export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, ScenariosResource, scenarioUpdatePreview, } from "./resources/scenarios.js";
 export { SqlResource, } from "./resources/sql.js";
 export { StatisticsResource, } from "./resources/statistics.js";
@@ -37,7 +41,7 @@ export { WebappsResource, } from "./resources/webapps.js";
 export { WikiResource, } from "./resources/wiki.js";
 export { WorkspacesResource, } from "./resources/workspaces.js";
 // Schemas (TypeBox schema objects for runtime validation)
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
 // Utilities
 export { deepMerge, } from "./utils/deep-merge.js";
 export { normalizeFlowGraph, } from "./utils/flow-map.js";

package/dist/src/resources/analyses.d.ts

@@ -0,0 +1,34 @@
+import { BaseResource } from "./base.js";
+export interface AnalysisListItem extends Record<string, unknown> {
+    id?: string;
+    analysisId?: string;
+    name?: string;
+    inputDataset?: string;
+}
+export interface AnalysisDefinition extends Record<string, unknown> {
+    id?: string;
+    analysisId?: string;
+    name?: string;
+    projectKey?: string;
+    inputDataset?: string;
+    script?: Record<string, unknown>;
+}
+export interface AnalysisCreateOptions {
+    inputDataset: string;
+    projectKey?: string;
+}
+export interface AnalysisCreateResult extends Record<string, unknown> {
+    id?: string;
+    analysisId?: string;
+}
+export declare class AnalysesResource extends BaseResource {
+    /** List visual analyses in a project. */
+    list(projectKey?: string): Promise<AnalysisListItem[]>;
+    /** Get the definition of a visual analysis. */
+    get(analysisId: string, projectKey?: string): Promise<AnalysisDefinition>;
+    /** Create a visual analysis for an input dataset. */
+    create(opts: AnalysisCreateOptions): Promise<AnalysisCreateResult>;
+    /** Delete a visual analysis. */
+    delete(analysisId: string, projectKey?: string): Promise<void>;
+    private analysisPath;
+}

package/dist/src/resources/analyses.js

@@ -0,0 +1,31 @@
+import { UsageError, } from "../cli/usage.js";
+import { BaseResource, } from "./base.js";
+function requireNonEmpty(value, name) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new UsageError(`${name} must be a non-empty string.`, "validation_failed");
+    }
+    return value;
+}
+export class AnalysesResource extends BaseResource {
+    /** List visual analyses in a project. */
+    async list(projectKey) {
+        return this.client.get(`/public/api/projects/${this.enc(projectKey)}/lab/`);
+    }
+    /** Get the definition of a visual analysis. */
+    async get(analysisId, projectKey) {
+        return this.client.get(`${this.analysisPath(analysisId, projectKey)}/`);
+    }
+    /** Create a visual analysis for an input dataset. */
+    async create(opts) {
+        const inputDataset = requireNonEmpty(opts.inputDataset, "inputDataset");
+        return this.client.post(`/public/api/projects/${this.enc(opts.projectKey)}/lab/`, { inputDataset, });
+    }
+    /** Delete a visual analysis. */
+    async delete(analysisId, projectKey) {
+        await this.client.del(`${this.analysisPath(analysisId, projectKey)}/`);
+    }
+    analysisPath(analysisId, projectKey) {
+        const id = encodeURIComponent(requireNonEmpty(analysisId, "analysisId"));
+        return `/public/api/projects/${this.enc(projectKey)}/lab/${id}`;
+    }
+}

package/dist/src/resources/api-services.d.ts

@@ -19,6 +19,8 @@ export declare class ApiServicesResource extends BaseResource {
     getSettings(serviceId: string, projectKey?: string): Promise<Record<string, unknown>>;
     /** Save API service settings. */
     saveSettings(serviceId: string, body: Record<string, unknown>, projectKey?: string): Promise<ApiServiceActionResult>;
+    /** Add a standard prediction endpoint backed by a saved model. */
+    addPredictionEndpoint(serviceId: string, endpointId: string, savedModelId: string, projectKey?: string): Promise<ApiServiceActionResult>;
     /** List deployable packages for an API service. */
     listPackages(serviceId: string, projectKey?: string): Promise<ApiServicePackageListItem[]>;
     /** Get an API service package summary. */

package/dist/src/resources/api-services.js

@@ -16,6 +16,16 @@ export class ApiServicesResource extends BaseResource {
     async saveSettings(serviceId, body, projectKey) {
         return this.client.put(`${this.servicePath(serviceId, projectKey)}/settings`, body);
     }
+    /** Add a standard prediction endpoint backed by a saved model. */
+    async addPredictionEndpoint(serviceId, endpointId, savedModelId, projectKey) {
+        const settings = await this.getSettings(serviceId, projectKey);
+        const endpoints = Array.isArray(settings.endpoints) ? settings.endpoints : [];
+        settings.endpoints = [
+            ...endpoints,
+            { id: endpointId, type: "STD_PREDICTION", modelRef: savedModelId, },
+        ];
+        return this.saveSettings(serviceId, settings, projectKey);
+    }
     /** List deployable packages for an API service. */
     async listPackages(serviceId, projectKey) {
         return this.client.get(`${this.servicePath(serviceId, projectKey)}/packages`);

package/dist/src/resources/applications.d.ts

@@ -31,7 +31,7 @@ export declare class ApplicationsResource extends BaseResource {
     createInstance(appId: string, body: Record<string, unknown>): Promise<AppInstanceRef>;
     /** Get the manifest for an app instance project. */
     getInstanceManifest(projectKey?: string): Promise<Record<string, unknown>>;
-    /** Save the manifest for an app instance project. */
+    /** Save the manifest for a Dataiku App template project (rejects classic app-instance projects). */
     saveInstanceManifest(manifest: Record<string, unknown>, projectKey?: string): Promise<void>;
     /** Delete an app instance project. */
     deleteInstance(projectKey?: string): Promise<void>;

package/dist/src/resources/applications.js

@@ -1,3 +1,4 @@
+import { ClientValidationError, DataikuError, } from "../errors.js";
 import { BaseResource, } from "./base.js";
 export class ApplicationsResource extends BaseResource {
     /** List all Dataiku Apps. */
@@ -20,12 +21,37 @@ export class ApplicationsResource extends BaseResource {
     async getInstanceManifest(projectKey) {
         return this.client.get(`/public/api/projects/${this.enc(projectKey)}/app-manifest`);
     }
-    /** Save the manifest for an app instance project. */
+    /** Save the manifest for a Dataiku App template project (rejects classic app-instance projects). */
     async saveInstanceManifest(manifest, projectKey) {
+        const currentManifest = await this.getInstanceManifest(projectKey);
+        if (currentManifest.projectAppType === "APP_INSTANCE") {
+            throw new ClientValidationError("Classic Dataiku App instance manifests cannot be saved through the app-manifest endpoint; only Dataiku App template project manifests can be updated.", "validation_failed", "Save against the Dataiku App template project instead; existing classic app-instance manifests are read-only through this endpoint.", { projectAppType: "APP_INSTANCE", projectKey: this.resolveProjectKey(projectKey), });
+        }
         await this.client.putVoid(`/public/api/projects/${this.enc(projectKey)}/app-manifest`, manifest);
     }
     /** Delete an app instance project. */
     async deleteInstance(projectKey) {
+        let manifest;
+        try {
+            manifest = await this.getInstanceManifest(projectKey);
+        }
+        catch (error) {
+            // DSS answers the app-manifest probe with 400 "neither an app template nor an app
+            // instance" for ordinary projects; treat only that as "not an app instance". Rethrow
+            // everything else (404 not-found, transient, permission) so real failures are not masked.
+            if (error instanceof DataikuError && error.status === 400) {
+                manifest = undefined;
+            }
+            else {
+                throw error;
+            }
+        }
+        if (manifest?.projectAppType !== "APP_INSTANCE") {
+            throw new ClientValidationError("Only classic Dataiku App instance projects can be deleted through app delete-instance.", "validation_failed", "Use `dss app delete-instance` only for projects whose app manifest has projectAppType=APP_INSTANCE; use `dss project delete` for ordinary projects.", {
+                projectAppType: manifest?.projectAppType ?? null,
+                projectKey: this.resolveProjectKey(projectKey),
+            });
+        }
         await this.client.del(`/public/api/projects/${this.enc(projectKey)}`);
     }
     /** List all Business Apps. */

package/dist/src/resources/continuous-activities.js

@@ -14,6 +14,7 @@ export class ContinuousActivitiesResource extends BaseResource {
     }
     /** Stop a continuous recipe activity. */
     async stop(recipeId, projectKey) {
+        await this.getStatus(recipeId, projectKey);
         await this.client.postText(`${this.activityPath(recipeId, projectKey)}/stop`);
     }
     activityPath(recipeId, projectKey) {

package/dist/src/resources/data-quality.js

@@ -1,3 +1,4 @@
+import { DataikuError, } from "../errors.js";
 import { DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineSchema, } from "../schemas.js";
 import { deepMerge, } from "../utils/deep-merge.js";
 import { BaseResource, } from "./base.js";
@@ -49,13 +50,14 @@ export class DataQualityResource extends BaseResource {
     async getRule(datasetName, ruleId, projectKey) {
         const rules = await this.listRules(datasetName, projectKey);
         const rule = rules.find((candidate) => candidate.id === ruleId);
-        if (!rule)
-            throw new Error(`Data quality rule not found: ${ruleId}`);
+        if (!rule) {
+            throw new DataikuError(404, "Not Found", JSON.stringify({ message: `Data quality rule not found: ${ruleId}`, }));
+        }
         return rule;
     }
     async status(datasetName, projectKey) {
         const pk = this.resolveProjectKey(projectKey);
-        const raw = await this.client.get(`${datasetPath(pk, datasetName)}/status`);
+        const raw = await this.client.get(`${datasetPath(pk, datasetName)}/status-by-partition`);
         return this.client.safeParse(DataQualityStatusSchema, raw, "dataQuality.status");
     }
     async statusByPartition(datasetName, opts = {}) {

package/dist/src/resources/datasets.d.ts

@@ -8,6 +8,9 @@ export interface DatasetBuildValidationResult {
     path: string | null;
     formatType: string | null;
     warnings: string[];
+    validationScope: "configuration";
+    materializationChecked: false;
+    note: string;
 }
 export interface DatasetSchemaColumnInput {
     name: string;

package/dist/src/resources/datasets.js

@@ -1,5 +1,5 @@
-import { createWriteStream, } from "node:fs";
-import { resolve, } from "node:path";
+import * as fs from "node:fs";
+import * as nodePath from "node:path";
 import { Readable, Transform, } from "node:stream";
 import { pipeline, } from "node:stream/promises";
 import { createGzip, } from "node:zlib";
@@ -297,6 +297,7 @@ function buildDatasetCreateBody(opts) {
 }
 const DATASET_CLONE_PARAM_KEYS = [
     "connection",
+    "uploadConnection",
     "path",
     "table",
     "schema",
@@ -418,8 +419,8 @@ export class DatasetsResource extends BaseResource {
         const res = await this.client.stream(`/public/api/projects/${this.enc(opts?.projectKey)}/datasets/${dsEnc}/data/?format=tsv-excel-header&limit=${limit + 1}`);
         const safeDatasetName = sanitizeFileName(datasetName, "dataset");
         const filePath = opts?.outputPath?.endsWith(".gz") || opts?.outputPath?.endsWith(".csv")
-            ? resolve(opts.outputPath)
-            : resolve(opts?.outputPath ?? process.cwd(), `${safeDatasetName}.csv.gz`);
+            ? nodePath.resolve(opts.outputPath)
+            : nodePath.resolve(opts?.outputPath ?? process.cwd(), `${safeDatasetName}.csv.gz`);
         const onHeader = opts?.validateColumns
             ? (headerRow) => {
                 const warnings = validateStreamColumns(headerRow, opts.validateColumns);
@@ -432,7 +433,8 @@ export class DatasetsResource extends BaseResource {
         const stats = { rows: 0, truncated: false, };
         const nodeStream = Readable.fromWeb(res.body);
         const csvTransform = tsvToCsvTransform(limit, stats, onHeader);
-        const fileOut = createWriteStream(filePath);
+        fs.mkdirSync(nodePath.dirname(filePath), { recursive: true, });
+        const fileOut = fs.createWriteStream(filePath);
         if (shouldGzip) {
             const gzip = createGzip();
             await pipeline(nodeStream, csvTransform, gzip, fileOut);
@@ -530,6 +532,9 @@ export class DatasetsResource extends BaseResource {
             path,
             formatType,
             warnings,
+            validationScope: "configuration",
+            materializationChecked: false,
+            note: "Validates build configuration only; it does not verify storage file existence or materialized data.",
         };
     }
     /** Clone dataset settings, preserving connection/storage, format, and schema fields. */

package/dist/src/resources/flow-zones.d.ts

@@ -20,6 +20,6 @@ export declare class FlowZonesResource extends BaseResource {
     moveItems(zoneId: string, items: FlowZoneItemInput[], projectKey?: string): Promise<FlowZone>;
     /** Move a single item into a flow zone. */
     moveItem(zoneId: string, item: FlowZoneItemInput, projectKey?: string): Promise<FlowZone>;
-    /** Get the graph for a single flow zone. */
-    graph(zoneId: string, projectKey?: string): Promise<unknown>;
+    /** Get the full flow graph, or the graph for a single non-default flow zone. */
+    graph(zoneId?: string, projectKey?: string): Promise<unknown>;
 }