dataiku-sdk 3.2.0 → 3.3.0

package/dist/src/client.js

@@ -13,19 +13,26 @@ import { CodeEnvsResource, } from "./resources/code-envs.js";
 import { ConnectionsResource, } from "./resources/connections.js";
 import { ContinuousActivitiesResource, } from "./resources/continuous-activities.js";
 import { DashboardsResource, } from "./resources/dashboards.js";
+import { DataCollectionsResource, } from "./resources/data-collections.js";
 import { DataQualityResource, } from "./resources/data-quality.js";
 import { DatasetsResource, } from "./resources/datasets.js";
 import { DiscussionsResource, } from "./resources/discussions.js";
 import { FlowZonesResource, } from "./resources/flow-zones.js";
 import { FoldersResource, } from "./resources/folders.js";
 import { FuturesResource, } from "./resources/futures.js";
+import { GroupsResource, } from "./resources/groups.js";
 import { InsightsResource, } from "./resources/insights.js";
 import { JobsResource, } from "./resources/jobs.js";
+import { KnowledgeBanksResource, } from "./resources/knowledge-banks.js";
+import { LlmsResource, } from "./resources/llms.js";
+import { MacrosResource, } from "./resources/macros.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 { PluginsResource, } from "./resources/plugins.js";
+import { ProjectFoldersResource, } from "./resources/project-folders.js";
 import { ProjectGitResource, } from "./resources/project-git.js";
 import { ProjectLibraryResource, } from "./resources/project-library.js";
 import { ProjectsResource, } from "./resources/projects.js";
@@ -35,6 +42,7 @@ import { ScenariosResource, } from "./resources/scenarios.js";
 import { SqlResource, } from "./resources/sql.js";
 import { StatisticsResource, } from "./resources/statistics.js";
 import { StreamingEndpointsResource, } from "./resources/streaming-endpoints.js";
+import { UsersResource, } from "./resources/users.js";
 import { VariablesResource, } from "./resources/variables.js";
 import { WebappsResource, } from "./resources/webapps.js";
 import { WikiResource, } from "./resources/wiki.js";
@@ -173,6 +181,20 @@ function buildFetchTlsOptions(config) {
     }
     return tls;
 }
+/**
+ * Resolve the total-budget request deadline timestamp for a per-call GET
+ * budget: `Date.now() + timeoutMs`. Undefined when no budget is supplied, in
+ * which case the client-level per-attempt timeout applies unchanged.
+ */
+function resolveGetDeadlineAt(options) {
+    const timeoutMs = options?.timeoutMs;
+    if (timeoutMs === undefined)
+        return undefined;
+    if (!Number.isInteger(timeoutMs) || timeoutMs < 1) {
+        throw new ClientValidationError("timeoutMs must be a positive integer.");
+    }
+    return Date.now() + timeoutMs;
+}
 /**
  * True when the URL embeds userinfo (`https://user:password@host`). Embedded
  * credentials are rejected up front so they can never reach the canonical base
@@ -240,6 +262,14 @@ export class DataikuClient {
     mlTasksResource;
     savedModelsResource;
     modelEvaluationStoresResource;
+    projectFoldersResource;
+    dataCollectionsResource;
+    llmsResource;
+    knowledgeBanksResource;
+    macrosResource;
+    pluginsResource;
+    usersResource;
+    groupsResource;
     get projects() {
         return (this.projectsResource ??= new ProjectsResource(this));
     }
@@ -348,6 +378,30 @@ export class DataikuClient {
     get modelEvaluationStores() {
         return (this.modelEvaluationStoresResource ??= new ModelEvaluationStoresResource(this));
     }
+    get projectFolders() {
+        return (this.projectFoldersResource ??= new ProjectFoldersResource(this));
+    }
+    get dataCollections() {
+        return (this.dataCollectionsResource ??= new DataCollectionsResource(this));
+    }
+    get llms() {
+        return (this.llmsResource ??= new LlmsResource(this));
+    }
+    get knowledgeBanks() {
+        return (this.knowledgeBanksResource ??= new KnowledgeBanksResource(this));
+    }
+    get macros() {
+        return (this.macrosResource ??= new MacrosResource(this));
+    }
+    get plugins() {
+        return (this.pluginsResource ??= new PluginsResource(this));
+    }
+    get users() {
+        return (this.usersResource ??= new UsersResource(this));
+    }
+    get groups() {
+        return (this.groupsResource ??= new GroupsResource(this));
+    }
     constructor(config) {
         const envUrl = process.env["DATAIKU_URL"]?.trim();
         const envApiKey = process.env["DATAIKU_API_KEY"]?.trim();
@@ -399,12 +453,10 @@ export class DataikuClient {
         throw new Error("projectKey is required — pass it as a parameter or set projectKey in DataikuClientConfig");
     }
     /* ---- public: HTTP verbs ---- */
-    async get(path) {
-        const res = await this.fetchWithRetry(`${this.baseUrl}${path}`, {
-            method: "GET",
-            headers: this.getHeaders(),
-        });
-        return this.parseJsonResponse(res);
+    async get(path, options) {
+        const deadlineAt = resolveGetDeadlineAt(options);
+        const res = await this.fetchWithRetry(`${this.baseUrl}${path}`, { method: "GET", headers: this.getHeaders(), }, undefined, deadlineAt);
+        return this.parseJsonResponse(res, deadlineAt);
     }
     /**
      * GET returning the parsed JSON body plus selected response metadata
@@ -496,6 +548,32 @@ export class DataikuClient {
             throw this.buildResponseTooLargeError(res, this.maxResponseBodyBytes);
         return text;
     }
+    /** Send raw file contents through the shared authenticated transport. */
+    async postRawBody(path, body) {
+        const payload = typeof body === "string"
+            ? body
+            : body.buffer instanceof ArrayBuffer
+                ? new Uint8Array(body.buffer, body.byteOffset, body.byteLength)
+                : new Uint8Array(body);
+        const response = await this.fetchWithRetry(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.getAnyHeaders(),
+            body: payload,
+        });
+        await response.text();
+    }
+    /** Git endpoints require Basic API-key authentication, unlike the bearer API. */
+    async requestGit(method, path, body, deadlineAt) {
+        return this.fetchWithRetry(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Basic ${Buffer.from(`${this.apiKey}:`, "utf8").toString("base64")}`,
+                Accept: "application/json",
+                "Content-Type": "application/json",
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        }, undefined, deadlineAt);
+    }
     async postStream(path, body) {
         const res = await this.fetchWithRetry(`${this.baseUrl}${path}`, {
             method: "POST",
@@ -525,6 +603,54 @@ export class DataikuClient {
             body: JSON.stringify(body),
         });
     }
+    /**
+     * PUT without a request body. A few DSS endpoints (bundle export) reject
+     * an empty JSON object body with 400 validation, and the official Python
+     * client sends no body at all for them.
+     */
+    async putVoidNoBody(path) {
+        await this.fetchWithRetry(`${this.baseUrl}${path}`, {
+            method: "PUT",
+            headers: this.getHeaders(),
+        });
+    }
+    /**
+     * POST a multipart/form-data body built from explicit parts, with optional
+     * query parameters appended to the path, returning the parsed JSON body.
+     *
+     * A part with `value` becomes a form text field; a part with `blob`
+     * (or a `fileName` with no blob) becomes a file part — a `fileName` without
+     * blob yields a zero-byte file part, which some DSS import endpoints
+     * (e.g. saved-model MLflow version import) require for metadata-only parts.
+     * The `Content-Type` header is left to the runtime so the multipart
+     * boundary is set correctly.
+     */
+    async uploadForm(path, parts, query) {
+        const formData = new FormData();
+        for (const part of parts) {
+            if (part.value !== undefined) {
+                formData.append(part.name, part.value);
+                continue;
+            }
+            if ((part.blob ?? null) === null && (part.fileName ?? null) === null) {
+                // Filename-less, zero-length field part — the shape the official
+                // Python client produces with files={"file": (None, None)} and
+                // the one DSS's managed-folder MLflow import requires (a Blob
+                // would always add a `filename=` parameter, even when empty).
+                formData.append(part.name, "");
+                continue;
+            }
+            const blob = part.blob ?? new Blob([]);
+            formData.append(part.name, blob, part.fileName);
+        }
+        const suffix = query && [...query.keys(),].length > 0 ? `?${query.toString()}` : "";
+        const res = await this.fetchWithRetry(`${this.baseUrl}${path}${suffix}`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.apiKey}`, },
+            body: formData,
+        });
+        return this.parseJsonResponse(res);
+    }
     async uploadResponse(path, filePath, fileName) {
         const fileBlob = Bun.file(filePath);
         const formData = new FormData();
@@ -658,8 +784,8 @@ export class DataikuClient {
         }
         return undefined;
     }
-    async parseJsonResponse(res) {
-        const { text, truncated, } = await this.readBoundedBodyText(res, this.maxResponseBodyBytes);
+    async parseJsonResponse(res, deadlineAt) {
+        const { text, truncated, } = await this.readBoundedBodyText(res, this.maxResponseBodyBytes, deadlineAt);
         if (truncated)
             throw this.buildResponseTooLargeError(res, this.maxResponseBodyBytes);
         // SAFETY: Empty 2xx responses from DSS are surfaced to callers as undefined
@@ -677,7 +803,7 @@ export class DataikuClient {
     }
     /* ---- private: bounded response body reading ---- */
     /**
-     * Read at most `maxBytes` of a 2xx response body as UTF-8 text.
+     * Read at most `maxBytes` of a response body as UTF-8 text.
      *
      * The body is consumed with the request deadline still active (measured
      * from the first read): a stalled body throws a DataikuError instead of
@@ -686,10 +812,15 @@ export class DataikuClient {
      * text is trimmed to a UTF-8 character boundary so it never decodes beyond
      * the byte cap.
      */
-    async readBoundedBodyText(res, maxBytes) {
+    async readBoundedBodyText(res, maxBytes, deadlineAt) {
         const limit = Math.max(0, Math.floor(maxBytes));
         if (!res.body)
             return { text: "", truncated: false, };
+        // Total-budget mode: the read shares the call's absolute deadline, so
+        // the budget already spent on attempts/backoff is not re-credited here.
+        const bodyTimeoutMs = deadlineAt === undefined
+            ? this.requestTimeoutMs
+            : Math.min(this.requestTimeoutMs, Math.max(1, deadlineAt - Date.now()));
         const reader = res.body.getReader();
         const decoder = new TextDecoder();
         const parts = [];
@@ -724,10 +855,10 @@ export class DataikuClient {
         const startedAt = Date.now();
         try {
             while (bytesRead < limit) {
-                const remainingMs = this.requestTimeoutMs - (Date.now() - startedAt);
+                const remainingMs = bodyTimeoutMs - (Date.now() - startedAt);
                 if (remainingMs <= 0)
-                    throw buildBodyReadTimeoutError(this.requestTimeoutMs);
-                const { done, value, } = await readChunkWithDeadline(reader, remainingMs, this.requestTimeoutMs);
+                    throw buildBodyReadTimeoutError(bodyTimeoutMs);
+                const { done, value, } = await readChunkWithDeadline(reader, remainingMs, bodyTimeoutMs);
                 if (done)
                     break;
                 const room = limit - bytesRead;
@@ -742,10 +873,10 @@ export class DataikuClient {
             }
             if (!truncated && bytesRead >= limit) {
                 // Buffer filled exactly on a chunk boundary; peek whether more data remains.
-                const remainingMs = this.requestTimeoutMs - (Date.now() - startedAt);
+                const remainingMs = bodyTimeoutMs - (Date.now() - startedAt);
                 if (remainingMs <= 0)
-                    throw buildBodyReadTimeoutError(this.requestTimeoutMs);
-                const { done, } = await readChunkWithDeadline(reader, remainingMs, this.requestTimeoutMs);
+                    throw buildBodyReadTimeoutError(bodyTimeoutMs);
+                const { done, } = await readChunkWithDeadline(reader, remainingMs, bodyTimeoutMs);
                 if (!done)
                     truncated = true;
             }
@@ -838,7 +969,7 @@ export class DataikuClient {
         return new DataikuError(res.status, RESPONSE_TOO_LARGE_STATUS_TEXT, `Response body exceeded the ${limit}-byte limit; the body was cancelled after ${limit} bytes.`, undefined, this.requestIdFromHeaders(res.headers));
     }
     /* ---- private: retry loop ---- */
-    async fetchWithRetry(url, init, retryMaxAttempts) {
+    async fetchWithRetry(url, init, retryMaxAttempts, deadlineAt) {
         const method = (init.method ?? "GET").toUpperCase();
         const retryEnabled = shouldRetryMethod(method) || retryMaxAttempts !== undefined;
         const maxAttempts = retryMaxAttempts === undefined
@@ -850,11 +981,21 @@ export class DataikuClient {
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             let timedOut = false;
             const startedAt = Date.now();
+            // An overall deadline may shorten, but never extend, the attempt cap.
+            const remainingMs = deadlineAt === undefined
+                ? undefined
+                : deadlineAt - startedAt;
+            if (remainingMs !== undefined && remainingMs <= 0) {
+                throw new DataikuError(0, "Request Timeout", `Request deadline exceeded after ${attempt - 1} attempt(s) and ${delaysMs.length} backoff delay(s).`, buildRetryMetadata(method, retryEnabled, maxAttempts, attempt, delaysMs, true));
+            }
+            const attemptTimeoutMs = remainingMs === undefined
+                ? this.requestTimeoutMs
+                : Math.min(remainingMs, this.requestTimeoutMs);
             const controller = new AbortController();
             const timeout = setTimeout(() => {
                 timedOut = true;
                 controller.abort();
-            }, this.requestTimeoutMs);
+            }, attemptTimeoutMs);
             this.logTrace({ phase: "request", method, url, attempt, maxAttempts, });
             try {
                 const requestInit = {
@@ -875,30 +1016,45 @@ export class DataikuClient {
                     elapsedMs: Date.now() - startedAt,
                 });
                 if (!res.ok) {
-                    const text = await res.text();
+                    const { text, truncated, } = await this.readBoundedBodyText(res, this.maxResponseBodyBytes, startedAt + attemptTimeoutMs);
                     const canRetry = retryEnabled && attempt < maxAttempts && isTransientError(res.status, text);
                     if (canRetry) {
                         const delayMs = computeBackoffDelayMs(attempt);
-                        delaysMs.push(delayMs);
-                        await sleep(delayMs);
-                        continue;
+                        // Do not start a retry whose backoff cannot fit in the budget.
+                        if (deadlineAt === undefined || Date.now() + delayMs <= deadlineAt) {
+                            delaysMs.push(delayMs);
+                            await sleep(delayMs);
+                            continue;
+                        }
+                        await sleep(Math.max(0, deadlineAt - Date.now()));
+                        throw new DataikuError(0, "Request Timeout", `Request deadline exceeded before backoff retry ${attempt + 1}.`, buildRetryMetadata(method, retryEnabled, maxAttempts, attempt, delaysMs, true));
                     }
-                    throw new DataikuError(res.status, res.statusText, text, buildRetryMetadata(method, retryEnabled, maxAttempts, attempt, delaysMs, false), this.requestIdFromHeaders(res.headers));
+                    throw new DataikuError(res.status, res.statusText, text, buildRetryMetadata(method, retryEnabled, maxAttempts, attempt, delaysMs, false), this.requestIdFromHeaders(res.headers), truncated ? { bodyTruncated: true, } : undefined);
                 }
                 return res;
             }
             catch (error) {
-                if (error instanceof DataikuError)
-                    throw error;
+                if (error instanceof DataikuError) {
+                    // A bounded error-body read is still part of this transport attempt.
+                    // Preserve the same retry/deadline policy as a fetch body abort.
+                    if (error.status !== 0 || error.statusText !== "Request Timeout" || error.retry !== undefined) {
+                        throw error;
+                    }
+                    timedOut = true;
+                }
                 const canRetry = retryEnabled && attempt < maxAttempts;
                 if (canRetry) {
                     const delayMs = computeBackoffDelayMs(attempt);
-                    delaysMs.push(delayMs);
-                    await sleep(delayMs);
-                    continue;
+                    if (deadlineAt === undefined || Date.now() + delayMs <= deadlineAt) {
+                        delaysMs.push(delayMs);
+                        await sleep(delayMs);
+                        continue;
+                    }
+                    await sleep(Math.max(0, deadlineAt - Date.now()));
+                    throw new DataikuError(0, "Request Timeout", `Request deadline exceeded before backoff retry ${attempt + 1}.`, buildRetryMetadata(method, retryEnabled, maxAttempts, attempt, delaysMs, true));
                 }
                 const detail = timedOut
-                    ? `Request timed out after ${this.requestTimeoutMs}ms`
+                    ? `Request timed out after ${attemptTimeoutMs}ms`
                     : error instanceof Error
                         ? error.message
                         : "Unknown transport error";

package/dist/src/errors.d.ts

@@ -18,6 +18,8 @@ export interface DataikuRetryMetadata {
 export interface DataikuErrorTrustedMetadata {
     target?: string;
     elapsedMs?: number;
+    /** Set by the transport when the retained response body is only a bounded prefix. */
+    bodyTruncated?: boolean;
 }
 export declare function canonicalStatusText(status: number): string;
 export declare class ClientValidationError extends Error {
@@ -44,6 +46,7 @@ export declare class DataikuError extends Error {
     requestId?: string;
     readonly trustedTarget?: string;
     readonly trustedElapsedMs?: number;
+    readonly bodyTruncated?: boolean;
     constructor(status: number, statusText: string, body: string, retry?: DataikuRetryMetadata, requestId?: string, trustedMetadata?: DataikuErrorTrustedMetadata);
     get safeMessage(): string;
     private static extractSummary;

package/dist/src/errors.js

@@ -339,6 +339,7 @@ export class DataikuError extends Error {
     requestId;
     trustedTarget;
     trustedElapsedMs;
+    bodyTruncated;
     constructor(status, statusText, body, retry, requestId, trustedMetadata) {
         const details = DataikuError.buildDetails(status, body, retry);
         super(details.message);
@@ -353,6 +354,7 @@ export class DataikuError extends Error {
         this.requestId = requestId;
         this.trustedTarget = trustedMetadata?.target;
         this.trustedElapsedMs = trustedMetadata?.elapsedMs;
+        this.bodyTruncated = trustedMetadata?.bodyTruncated === true ? true : undefined;
     }
     get safeMessage() {
         const retrySummary = DataikuError.formatRetryMetadata(this.retry);

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, } from "./client.js";
+export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, type DataikuGetOptions, type UploadFormPart, } from "./client.js";
 export { type CredentialValidationOptions, type CredentialValidationResult, validateCredentials, } from "./auth.js";
 export { type DssCredentials, getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
 export { ClientValidationError, DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
@@ -8,38 +8,47 @@ export { ApiServicesResource, } from "./resources/api-services.js";
 export { ApplicationsResource, } from "./resources/applications.js";
 export { BundlesResource, ProjectDeployerResource, } from "./resources/bundles.js";
 export { CodeEnvsResource, } from "./resources/code-envs.js";
-export { type ConnectionSchemaListOptions, ConnectionsResource, type ConnectionTableListOptions, } from "./resources/connections.js";
+export { type ConnectionAdminInput, type ConnectionSchemaListOptions, ConnectionsResource, type ConnectionTableListOptions, } from "./resources/connections.js";
 export { ContinuousActivitiesResource, } from "./resources/continuous-activities.js";
 export { DashboardsResource, } from "./resources/dashboards.js";
+export { type DataCollectionCreateRequest, type DataCollectionObject, type DataCollectionObjectReferenceType, type DataCollectionPermission, type DataCollectionSettings, DataCollectionsResource, type DataCollectionSummary, } from "./resources/data-collections.js";
 export { DataQualityResource, } from "./resources/data-quality.js";
-export { type DatasetBuildValidationResult, type DatasetCloneOptions, type DatasetCloneResult, type DatasetSchemaColumnInput, DatasetsResource, type UploadDatasetFileOptions, type UploadDatasetFileResult, type UploadedFileMetadata, } from "./resources/datasets.js";
+export { type DatasetBuildValidationResult, type DatasetCloneOptions, type DatasetCloneResult, type DatasetManagedCreateOptions, type DatasetManagedCreateResult, type DatasetSchemaColumnInput, DatasetsResource, type UploadDatasetFileOptions, type UploadDatasetFileResult, type UploadedFileMetadata, } from "./resources/datasets.js";
 export { DiscussionsResource, } from "./resources/discussions.js";
 export { type FlowZoneItemInput, FlowZonesResource, } from "./resources/flow-zones.js";
 export { FoldersResource, } from "./resources/folders.js";
 export { FuturesResource, } from "./resources/futures.js";
+export { type DssGroup, type GroupCreateRequest, GroupsResource, } from "./resources/groups.js";
 export { InsightsResource, } from "./resources/insights.js";
-export { computeNextPollDelayMs, type JobBuildAndWaitOptions, type JobBuildOptions, type JobBuildTarget, type JobBuildTargetType, type JobLogFilter, type JobLogProgress, type JobLogSummary, type JobLogUnavailableReason, JobsResource, type JobWaitOutcome, parseJobLogProgress, } from "./resources/jobs.js";
+export { type JobBuildAndWaitOptions, type JobBuildOptions, type JobBuildTarget, type JobBuildTargetType, type JobLogFilter, type JobLogProgress, type JobLogSummary, type JobLogUnavailableReason, JobsResource, type JobWaitOutcome, parseJobLogProgress, } from "./resources/jobs.js";
+export * from "./resources/knowledge-banks.js";
+export * from "./resources/llms.js";
+export { type MacroResultOptions, type MacroRunFailure, type MacroRunHandle, type MacroRunOptions, type MacroRunWaitedResult, MacrosResource, type MacroWaitOptions, } from "./resources/macros.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 { type PluginCodeEnvCreateOptions, type PluginContentItem, type PluginCreateDevOptions, type PluginFileDetails, type PluginGitInstallOptions, type PluginGitRemote, type PluginMissingType, type PluginProjectScopeOptions, type PluginSettings, PluginsResource, type PluginSummary, type PluginUsage, type PluginUsageReport, } from "./resources/plugins.js";
+export { type ProjectFolder, type ProjectFolderPermission, type ProjectFolderSettings, ProjectFoldersResource, } from "./resources/project-folders.js";
 export * from "./resources/project-git.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { type FlowMapResult, type ProjectImportProcessResult, type ProjectImportResult, type ProjectImportSettings, type ProjectImportUploadResult, 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 { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, type ScenarioActiveUpdateResult, type ScenarioFieldChange, type ScenarioFieldMismatch, type ScenarioLightStatus, type ScenarioRunDetails, type ScenarioRunLog, type ScenarioRunStepReport, type ScenarioRunSummary, 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";
 export { StreamingEndpointsResource, } from "./resources/streaming-endpoints.js";
+export { type DssUser, type ExternalUserEntry, type ProvisionRequest, type UserActivity, type UserCreateRequest, UsersResource, } from "./resources/users.js";
 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, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, 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, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { computeNextPollDelayMs, } from "./utils/polling.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, 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, MacroDefinitionSchema, MacroRunStartSchema, MacroStateSchema, MacroSummaryArraySchema, MacroSummarySchema, MacroWaitResultSchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectTagsSchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, 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, CodeEnvGetLogOptions, CodeEnvLogResult, CodeEnvLogSummary, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdateImagesOptions, CodeEnvUpdatePackagesOptions, CodeEnvUsage, CodeEnvVersionForProject, 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, ProjectGitActionResult, ProjectGitDiffResult, ProjectGitFutureResponse, ProjectGitFutureState, ProjectGitLibraries, ProjectGitLibrary, ProjectGitLogResult, ProjectGitRemote, ProjectGitStatus, ProjectGitTag, ProjectGitTags, 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 type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvGetLogOptions, CodeEnvLogResult, CodeEnvLogSummary, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdateImagesOptions, CodeEnvUpdatePackagesOptions, CodeEnvUsage, CodeEnvVersionForProject, 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, MacroDefinition, MacroRunStart, MacroState, MacroSummary, MacroSummaryArray, MacroWaitResult, NotebookSession, ProjectDetails, ProjectGitActionResult, ProjectGitDiffResult, ProjectGitFutureResponse, ProjectGitFutureState, ProjectGitLibraries, ProjectGitLibrary, ProjectGitLogResult, ProjectGitRemote, ProjectGitStatus, ProjectGitTag, ProjectGitTags, ProjectMetadata, ProjectSummary, ProjectTags, 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 AnalyzedFlowMap, type AnalyzedFlowNode, analyzeFlowMap, type FlowMapComponent, type FlowMapDiagnostic, type FlowMapRendering, type FlowMapZone, type FlowRenderFormat, flowTopologyFingerprint, renderFlowMap, } from "./utils/flow-analysis.js";
 export { type NormalizedFlowEdge, type NormalizedFlowMap, type NormalizedFlowNode, normalizeFlowGraph, } from "./utils/flow-map.js";

package/dist/src/index.js

@@ -15,19 +15,26 @@ export { CodeEnvsResource, } from "./resources/code-envs.js";
 export { ConnectionsResource, } from "./resources/connections.js";
 export { ContinuousActivitiesResource, } from "./resources/continuous-activities.js";
 export { DashboardsResource, } from "./resources/dashboards.js";
+export { DataCollectionsResource, } from "./resources/data-collections.js";
 export { DataQualityResource, } from "./resources/data-quality.js";
 export { DatasetsResource, } from "./resources/datasets.js";
 export { DiscussionsResource, } from "./resources/discussions.js";
 export { FlowZonesResource, } from "./resources/flow-zones.js";
 export { FoldersResource, } from "./resources/folders.js";
 export { FuturesResource, } from "./resources/futures.js";
+export { GroupsResource, } from "./resources/groups.js";
 export { InsightsResource, } from "./resources/insights.js";
-export { computeNextPollDelayMs, JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
+export { JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
+export * from "./resources/knowledge-banks.js";
+export * from "./resources/llms.js";
+export { MacrosResource, } from "./resources/macros.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 { PluginsResource, } from "./resources/plugins.js";
+export { ProjectFoldersResource, } from "./resources/project-folders.js";
 export * from "./resources/project-git.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { ProjectsResource, } from "./resources/projects.js";
@@ -37,12 +44,14 @@ export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, Scenar
 export { SqlResource, } from "./resources/sql.js";
 export { StatisticsResource, } from "./resources/statistics.js";
 export { StreamingEndpointsResource, } from "./resources/streaming-endpoints.js";
+export { UsersResource, } from "./resources/users.js";
 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 { computeNextPollDelayMs, } from "./utils/polling.js";
 // Schemas (TypeBox schema objects for runtime validation)
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, 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, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, 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, MacroDefinitionSchema, MacroRunStartSchema, MacroStateSchema, MacroSummaryArraySchema, MacroSummarySchema, MacroWaitResultSchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectTagsSchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
 // Utilities
 export { deepMerge, } from "./utils/deep-merge.js";
 export { analyzeFlowMap, flowTopologyFingerprint, renderFlowMap, } from "./utils/flow-analysis.js";

package/dist/src/resources/analyses.js

@@ -1,11 +1,4 @@
-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;
-}
+import { BaseResource, requireNonEmpty, } from "./base.js";
 export class AnalysesResource extends BaseResource {
     /** List visual analyses in a project. */
     async list(projectKey) {

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

@@ -28,7 +28,7 @@ export interface DeleteAppInstanceOptions {
 export type AppManifestReferenceKind = "scenario" | "folder" | "variable";
 /**
  * Source-verifiable app-manifest reference locations. Validation is scoped to
- * homepage tiles so identically named keys in arbitrary custom-form `config`
+ * homepage tiles so identically named keys in arbitrary custom tile `config`
  * objects are never treated as references.
  */
 export declare const APP_MANIFEST_REFERENCE_KEYS: Record<AppManifestReferenceKind, string[]>;
@@ -207,11 +207,13 @@ export declare class ApplicationsResource extends BaseResource {
     setManifestVersion(update: AppManifestVersionUpdate, projectKey?: string): Promise<AppManifestVersionWriteResult>;
     /**
      * Validate source-verifiable references in app homepage tiles:
-     * SCENARIO_RUN scenario IDs, DOWNLOAD_FILE managed-folder IDs, and runtime
-     * form parameter names (which DSS maps to project variables). Arbitrary
-     * custom-form `config` objects remain opaque. The manifest is never mutated.
-     * Missing/malformed references are returned deterministically; a reference
-     * kind with no applicable tiles does not trigger its project API.
+     * SCENARIO_RUN scenario IDs, DOWNLOAD_MANAGED_FOLDER_FILE managed-folder IDs,
+     * and PROJECT_VARIABLES_EDIT parameter names (which DSS maps to project
+     * variables). Tile types outside that set, including custom tiles and their
+     * `config` objects, remain opaque and are never parsed for references. The
+     * manifest is never mutated. Missing/malformed references are returned
+     * deterministically; a reference kind with no applicable tiles does not
+     * trigger its project API.
      */
     validateAppManifest(manifest: unknown, projectKey?: string): Promise<AppManifestValidationResult>;
     /**