dataiku-sdk 3.3.0 → 3.4.0

package/README.md

@@ -267,7 +267,7 @@ DSS_TOKENIZER_MODULE=/absolute/path/to/oh-my-pi/packages/natives/native/index.js
 
 When configured, the native module also accelerates ordinary OpenAI token measurements after parity checks against the pinned JavaScript model. The JS fingerprint and independent cross-model reference checks remain authoritative; reserved special-token validation is preserved. Without this variable, measurements use JavaScript and only the native cross-model case is skipped. A configured missing/incompatible module fails instead of silently falling back. The cross-model gate permits 10% growth over recorded text baselines. Claude counts use ctok reconstructions, not an official tokenizer; counts exclude provider framing. No native dependency is added to the CLI.
 
-For a known resource, `dss agent contract --fields commands.actions.dataset` lists action names in **64 tokens**, versus **1,575** for the global index. For known writes, fetch the full action entry directly once: `dataset.create` costs **1,059 tokens**, versus **1,415** for compact discovery followed by the required full entry. Use compact `usage,description,flags,examples` projections for reads when those fields suffice. This is selective disclosure, not lossless compression. Scoped discovery builds only selected resource metadata; action-name indexes avoid constructing payload schemas, while full registry exports and recovery hints retain their existing content.
+For a known resource, `dss agent contract --fields commands.actions.dataset` lists action names in **64 tokens**, versus **1,575** for the global index. For known writes, fetch the full action entry directly once: `dataset.create` costs **1,059 tokens**, versus **1,415** for compact discovery followed by the required full entry. Use compact `usage,description,flags,examples` projections for reads when those fields suffice. This is selective disclosure, not lossless compression. Scoped discovery constructs only requested action entries and materializes schemas only when requested; action-name indexes avoid payload schemas, while full registry exports and recovery hints retain their existing content. Metadata-only paths defer SDK runtime/schema imports.
 
 Boolean flags accept bare flags or explicit `=true`/`=false` values, including aliases. Invalid boolean values fail before dispatch. Direct, batch, and local commands share execution-mode resolution; `--plan --dry-run` returns a plan with `plannedAndDryRun:true` when both modes are supported. Unreadable JSON/text payload files produce `validation_failed` usage errors (exit 1) with the flag, path, and filesystem cause.
 
@@ -275,6 +275,8 @@ For raw streaming downloads, `--request-timeout MS` bounds each pending body rea
 
 The SDK configuration `maxResponseBodyBytes` (default **50 MiB**) also bounds retained non-2xx response bodies. Oversized errors preserve HTTP status, header request IDs, and a UTF-8-safe prefix, with `DataikuError.bodyTruncated: true`; CLI errors expose `details.bodyTruncated: true`. Retry eligibility is unchanged, and error-body reads share the transport attempt deadline.
 
+Eligible transient retries honor `Retry-After` delta-seconds and HTTP dates, waiting at least the greater of server guidance and normal jittered backoff. Invalid or past values use normal backoff. Server waits above the existing 30-second automatic backoff cap decline retry and return the original error rather than retrying early. Total request deadlines remain authoritative; this does not enable retries for otherwise non-retryable requests.
+
 ## Credentials
 
 Use environment variables for ephemeral runs. For disposable agent tests, set `DSS_CONFIG_DIR` to a temporary directory so saved credentials never touch your real profile.

package/dist/build-metadata.json

@@ -1 +1 @@
-{"format":1,"buildRevision":"944ec2a6e0780142399032675854ef6b4ac957a7"}
+{"format":1,"buildRevision":"c2f0acd7beed8f8256bfa72bfaa99794237a0a24"}

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

@@ -1,5 +1,4 @@
 import { readFileSync, } from "node:fs";
-import { ScenarioScriptRunWithCleanupFailureError, } from "../../resources/scenarios.js";
 import { num, readStdinText, stripUtf8Bom, } from "../coerce.js";
 import { enqueueCliWarning, } from "../output.js";
 import { UsageError, } from "../usage.js";
@@ -78,6 +77,7 @@ function reportCleanupFailure(cleanupFailure) {
     });
 }
 function unwrapCodeRunError(error) {
+    const { ScenarioScriptRunWithCleanupFailureError, } = require("../../resources/scenarios.js");
     if (error instanceof ScenarioScriptRunWithCleanupFailureError) {
         reportCleanupFailure(error.cleanupFailure);
         return error.cause;

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

@@ -1,4 +1,3 @@
-import { buildDatasetCloneSettings, } from "../../resources/datasets.js";
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { compareStrings, stableHash, } from "../../utils/stable-hash.js";
 import { jsonInput, num, schemaColumnsInput, unknownJsonInput, } from "../coerce.js";
@@ -538,6 +537,7 @@ export const datasetCommands = {
                 allowSamePath: f["allow-same-path"] === true,
             };
             const current = await c.datasets.get(a[0], pk);
+            const { buildDatasetCloneSettings, } = await import("../../resources/datasets.js");
             const next = buildDatasetCloneSettings(current, a[1], pk ?? c.resolveProjectKey(pk), opts);
             const zoneId = await resolveFlowZoneIdFromFlags(c, f, pk);
             if (executionMode(f).dryRun) {

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

@@ -1,6 +1,5 @@
 import { mkdir, writeFile, } from "node:fs/promises";
 import { dirname, resolve, } from "node:path";
-import { parseJobLogProgress, } from "../../resources/jobs.js";
 import { jobBuildTargetTypeFromFlags, jobLogFilterFromFlag, maxLogLinesFromFlags, num, plainRecord, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, } from "../output.js";
@@ -158,7 +157,10 @@ async function jobInspectionSummary(client, jobId, flags) {
         logError = error instanceof Error ? error.message : String(error);
     }
     const durationMs = jobDurationMs(details);
-    const progress = log ? parseJobLogProgress(log, durationMs) : undefined;
+    const progress = log
+        ? require("../../resources/jobs.js")
+            .parseJobLogProgress(log, durationMs)
+        : undefined;
     const logLines = log
         ? log.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0)
         : [];

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

@@ -1,4 +1,3 @@
-import { macroResultMaxBytes, } from "../../resources/macros.js";
 import { jsonInput, num, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, } from "../output.js";
@@ -211,7 +210,8 @@ export const macroCommands = {
             }
             return c.macros.result(a[0], a[1], {
                 projectKey: pk,
-                maxBytes: macroResultMaxBytes(maxBytes),
+                maxBytes: require("../../resources/macros.js")
+                    .macroResultMaxBytes(maxBytes),
             });
         },
         usage: "dss macro result <macro_id> <run_id> [--max-bytes N (default 8388608)] [--project-key KEY]",

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

@@ -1,4 +1,4 @@
-import { validateGitReferencePath, } from "../../resources/project-git.js";
+import { validateGitReferencePath, } from "../../utils/git-reference.js";
 import { sanitizeErrorSecrets, sanitizeSecrets, } from "../../utils/secret-sanitize.js";
 import { num, parseBooleanOption, requiredStringFlag, } from "../coerce.js";
 import { CommandResultFailure, } from "../output.js";

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

@@ -1,4 +1,3 @@
-import { scenarioUpdatePreview, } from "../../resources/scenarios.js";
 import { jsonInput, num, parseBooleanOption, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, readIfExists, skipResult, } from "../output.js";
@@ -153,6 +152,7 @@ export const scenarioCommands = {
             const pk = f["project-key"];
             if (executionMode(f).dryRun) {
                 const current = await c.scenarios.get(a[0], { projectKey: pk, });
+                const { scenarioUpdatePreview, } = await import("../../resources/scenarios.js");
                 const preview = scenarioUpdatePreview(current, data);
                 return {
                     dryRun: true,

package/dist/src/cli/contract.js

@@ -3,10 +3,11 @@ import * as path from "node:path";
 import { validateCredentials, } from "../auth.js";
 import { getCredentialsPath, saveCredentials, } from "../config.js";
 import { DataikuError, } from "../errors.js";
+import actionOutputSchemasMetadata from "../generated/action-output-schemas.json" with { type: "json"
+};
 import { APP_MANIFEST_CONCURRENCY_CONTROL, } from "../resources/applications.js";
-import { encodeGitReferencePath, validateGitReferencePath, } from "../resources/project-git.js";
 import { encodeLibraryPath, PROJECT_LIBRARY_CONCURRENCY_CONTROL, validateLibraryDestinationPath, validateLibraryName, validateLibraryPath, } from "../resources/project-library.js";
-import { CodeEnvDetailsSchema, CodeEnvLogSummaryArraySchema, CodeEnvSummaryArraySchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, FlowZoneArraySchema, FlowZoneSchema, JobSummaryArraySchema, JobWaitResultSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, NotebookSessionArraySchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, RecipeSummaryArraySchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlQueryResponseSchema, } from "../schemas.js";
+import { encodeGitReferencePath, validateGitReferencePath, } from "../utils/git-reference.js";
 import { jobBuildTargetTypeFromFlags, json, jsonInput, num, parseBooleanOption, parseJsonObject, recipeInputDatasetsFromFlags, requiredJsonInput, rewritePairsFromFlags, schemaColumnsInput, sha256Hex, stableHash, stringField, textInput, } from "./coerce.js";
 import { parseCodeRunIntegerFlag, resolveCodeInputWithSource, } from "./commands/code.js";
 import { commands, } from "./commands/index.js";
@@ -433,212 +434,18 @@ function structuredExamples(examples, examplePayload) {
         };
     });
 }
-const PROJECT_LIBRARY_ITEM_OUTPUT_SCHEMA = {
-    type: "object",
-    additionalProperties: false,
-    required: ["name",],
-    properties: {
-        name: { type: "string", },
-        path: { type: "string", },
-        size: { type: "integer", minimum: 0, },
-        mimeType: { type: "string", },
-        hasData: { type: "boolean", },
-        lastModified: { type: "number", },
-        children: { type: "array", items: { type: "object", additionalProperties: true, }, },
-    },
-};
-const NOTEBOOK_SAVE_OUTPUT_SCHEMA = {
-    type: "object",
-    additionalProperties: false,
-    required: ["saved", "resource", "created", "hash",],
-    properties: {
-        saved: { type: "string", },
-        resource: { enum: ["jupyter-notebook", "sql-notebook",], },
-        created: { type: "boolean", },
-        hash: { type: "string", pattern: "^[a-f0-9]{64}$", },
-    },
-};
 /**
- * `notebook.save-sql` adds `requested`: on create DSS allocates the persisted
- * id (`saved`), while the requested handle only becomes the display name.
+ * Discovery output schemas: the generated declarative metadata committed at
+ * `src/generated/action-output-schemas.json`. Plain data only, so discovery
+ * (`dss commands run`, `dss agent contract`) never loads the TypeBox graph.
+ * The content matches `typeBoxCommandOutputSchemas()` exactly; parity and
+ * freshness are enforced by tests/cli/discovery-output-schemas.test.ts and
+ * `bun run check`.
  */
-const NOTEBOOK_SAVE_SQL_OUTPUT_SCHEMA = {
-    ...NOTEBOOK_SAVE_OUTPUT_SCHEMA,
-    required: ["saved", "requested", "resource", "created", "hash",],
-    properties: {
-        ...NOTEBOOK_SAVE_OUTPUT_SCHEMA["properties"],
-        requested: { type: "string", },
-    },
-};
-const COMMAND_OUTPUT_SCHEMAS = {
-    "code-env.list": CodeEnvSummaryArraySchema,
-    "code-env.get": CodeEnvDetailsSchema,
-    "code-env.list-logs": CodeEnvLogSummaryArraySchema,
-    "code-env.get-log": {
-        oneOf: [
-            {
-                type: "object",
-                required: ["log", "bytes", "truncated", "tailed", "envLang", "envName", "logName",],
-                properties: {
-                    log: { type: "string", },
-                    bytes: { type: "integer", minimum: 0, },
-                    truncated: { type: "boolean", },
-                    tailed: { type: "boolean", },
-                    envLang: { enum: ["PYTHON", "R",], },
-                    envName: { type: "string", },
-                    logName: { type: "string", },
-                },
-            },
-            {
-                type: "object",
-                required: ["path", "bytes", "truncated", "tailed", "envLang", "envName", "logName",],
-                properties: {
-                    path: { type: "string", },
-                    bytes: { type: "integer", minimum: 0, },
-                    truncated: { type: "boolean", },
-                    tailed: { type: "boolean", },
-                    envLang: { enum: ["PYTHON", "R",], },
-                    envName: { type: "string", },
-                    logName: { type: "string", },
-                },
-            },
-        ],
-    },
-    "code-env.version": CodeEnvVersionForProjectSchema,
-    "code-env.usages": CodeEnvUsageArraySchema,
-    "code.run": {
-        type: "object",
-        additionalProperties: false,
-        required: [
-            "outcome",
-            "success",
-            "runId",
-            "elapsedMs",
-            "pollCount",
-            "output",
-            "logTruncated",
-            "maxLogBytes",
-            "cleanup",
-        ],
-        properties: {
-            outcome: { type: "string", },
-            success: { type: "boolean", },
-            runId: { type: "string", },
-            elapsedMs: { type: "number", minimum: 0, },
-            pollCount: { type: "integer", minimum: 0, },
-            output: { type: "string", },
-            log: { type: "string", },
-            logTruncated: { type: "boolean", },
-            maxLogBytes: { type: "integer", minimum: 0, },
-            timedOut: { const: true, },
-            timeoutMs: { type: "integer", minimum: 0, },
-            cleanup: {
-                type: "object",
-                additionalProperties: false,
-                required: ["status",],
-                properties: {
-                    status: { enum: ["deleted", "kept", "failed",], },
-                    error: { type: "string", },
-                },
-            },
-        },
-    },
-    "notebook.list-jupyter": JupyterNotebookSummaryArraySchema,
-    "notebook.get-jupyter": JupyterNotebookContentSchema,
-    "notebook.sessions-jupyter": NotebookSessionArraySchema,
-    "notebook.list-sql": SqlNotebookSummaryArraySchema,
-    "notebook.get-sql": SqlNotebookContentSchema,
-    "notebook.history-sql": SqlNotebookHistorySchema,
-    "notebook.save-jupyter": NOTEBOOK_SAVE_OUTPUT_SCHEMA,
-    "notebook.save-sql": NOTEBOOK_SAVE_SQL_OUTPUT_SCHEMA,
-    "project-library.list": { type: "array", items: PROJECT_LIBRARY_ITEM_OUTPUT_SCHEMA, },
-    "project-library.get-bytes": {
-        type: "object",
-        additionalProperties: false,
-        required: ["path", "bytes", "sha256",],
-        properties: {
-            path: { type: "string", },
-            bytes: { type: "integer", minimum: 0, },
-            sha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
-        },
-    },
-    "project-library.put": {
-        type: "object",
-        additionalProperties: false,
-        required: ["updated", "bytes", "sha256",],
-        properties: {
-            updated: { type: "string", },
-            bytes: { type: "integer", minimum: 0, },
-            sha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
-            beforeSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
-        },
-    },
-    "project-library.diff": {
-        type: "object",
-        additionalProperties: false,
-        required: [
-            "path",
-            "unchanged",
-            "added",
-            "removed",
-            "diff",
-            "diffTruncated",
-            "localSha256",
-            "localBytes",
-            "maxLines",
-        ],
-        properties: {
-            path: { type: "string", },
-            unchanged: { type: "boolean", },
-            added: { type: "integer", minimum: 0, },
-            removed: { type: "integer", minimum: 0, },
-            diff: { type: "string", },
-            diffTruncated: { type: "boolean", },
-            binary: { type: "boolean", },
-            remoteAbsent: { type: "boolean", },
-            remoteSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
-            remoteBytes: { type: "integer", minimum: 0, },
-            localSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
-            localBytes: { type: "integer", minimum: 0, },
-            maxLines: { type: "integer", minimum: 0, },
-        },
-    },
-    "project.list": ProjectSummaryArraySchema,
-    "project.get": ProjectDetailsSchema,
-    "project.metadata": ProjectMetadataSchema,
-    "dataset.list": DatasetSummaryArraySchema,
-    "dataset.get": DatasetDetailsSchema,
-    "dataset.schema": DatasetSchemaSchema,
-    "recipe.list": RecipeSummaryArraySchema,
-    "job.list": JobSummaryArraySchema,
-    "job.wait": JobWaitResultSchema,
-    "job.monitor": JobWaitResultSchema,
-    "scenario.list": ScenarioSummaryArraySchema,
-    "scenario.get": ScenarioDetailsSchema,
-    "scenario.status": ScenarioStatusSchema,
-    "flow-zone.list": FlowZoneArraySchema,
-    "flow-zone.get": FlowZoneSchema,
-    "sql.query": {
-        anyOf: [
-            SqlQueryResponseSchema,
-            {
-                type: "object",
-                required: ["queryId", "rowCount", "preview",],
-                additionalProperties: true,
-                properties: {
-                    queryId: { type: "string", },
-                    rowCount: { type: "number", },
-                    preview: { type: "array", items: true, },
-                    truncated: { type: "boolean", },
-                    outputPath: { type: "string", },
-                    written: { type: "string", },
-                },
-            },
-        ],
-    },
-};
+const actionOutputSchemas = actionOutputSchemasMetadata
+    .schemas;
 function outputJsonSchema(resource, action, shape) {
-    const precise = COMMAND_OUTPUT_SCHEMAS[registryKey(resource, action)];
+    const precise = actionOutputSchemas[registryKey(resource, action)];
     if (precise)
         return precise;
     if (shape === "array")
@@ -1460,6 +1267,7 @@ function buildRegistryEntry(resource, action, meta) {
     const uniqueRequiredFlags = uniqueStrings(requiredFlags);
     const uniqueOptionalFlags = uniqueStrings(optionalFlags);
     const unsafe = unsafeOutputs(resource, action, producesLocalFile);
+    let schemas;
     return {
         resource,
         action,
@@ -1486,7 +1294,9 @@ function buildRegistryEntry(resource, action, meta) {
         ...(requiredOneOf.length > 0 ? { requiredOneOf, } : {}),
         ...(inputGroups.length > 0 ? { requiredInputGroups: inputGroups, } : {}),
         ...(payloadSchema ? { payloadSchema, } : {}),
-        schemas: buildCommandSchemas(resource, action, flagMetadata, uniqueRequiredFlags, requiredOneOf, payloadSchema, outputShape, meta.usage),
+        get schemas() {
+            return schemas ??= buildCommandSchemas(resource, action, flagMetadata, uniqueRequiredFlags, requiredOneOf, payloadSchema, outputShape, meta.usage);
+        },
         ...(unsafe ? { unsafeOutputs: unsafe, } : {}),
         ...(examplePayload !== undefined ? { examplePayload, } : {}),
         ...(cleanupCommand ? { cleanupCommand, } : {}),
@@ -1591,9 +1401,14 @@ function commandDefinitions(resourceFilter) {
 export function buildCommandRegistry(resourceFilter) {
     const registry = {};
     for (const [resource, actions,] of Object.entries(commandDefinitions(resourceFilter))) {
-        registry[resource] = {};
+        const entries = {};
+        registry[resource] = entries;
         for (const [action, meta,] of Object.entries(actions)) {
-            registry[resource][action] = buildRegistryEntry(resource, action, meta);
+            let entry;
+            Object.defineProperty(entries, action, {
+                enumerable: true,
+                get: () => entry ??= buildRegistryEntry(resource, action, meta),
+            });
         }
     }
     return registry;

package/dist/src/cli/output-schemas.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical discovery output schemas, keyed by `resource.action`.
+ *
+ * TypeBox definitions from `packages/types` plus the inline literal schemas
+ * that exist only on the CLI side (code-env log envelope, code.run outcome,
+ * project-library payloads, notebook saves, sql.query handoff envelope).
+ * `scripts/generate-action-output-schemas.mjs` serializes this map into
+ * `src/generated/action-output-schemas.json`; discovery (src/cli/contract.ts)
+ * reads that generated JSON as plain data, so the TypeBox schema graph never
+ * loads on the discovery path. SDK validation keeps using the TypeBox schema
+ * objects from `packages/types` directly.
+ *
+ * Imported by the generator and the discovery parity test only.
+ */
+/**
+ * Canonical TypeBox-derived output schemas, keyed by `resource.action`. This is
+ * the single source of truth for `src/generated/action-output-schemas.json`,
+ * which discovery reads as plain data so no TypeBox schema graph loads on the
+ * discovery path. Regenerate with
+ * `bun scripts/generate-action-output-schemas.mjs`; `bun run check` fails when
+ * the generated file is stale. SDK validation keeps using the TypeBox schema
+ * objects from `packages/types` directly and never depends on the generated file.
+ */
+export declare function typeBoxCommandOutputSchemas(): Record<string, Record<string, unknown>>;

package/dist/src/cli/output-schemas.js

@@ -0,0 +1,233 @@
+/**
+ * Canonical discovery output schemas, keyed by `resource.action`.
+ *
+ * TypeBox definitions from `packages/types` plus the inline literal schemas
+ * that exist only on the CLI side (code-env log envelope, code.run outcome,
+ * project-library payloads, notebook saves, sql.query handoff envelope).
+ * `scripts/generate-action-output-schemas.mjs` serializes this map into
+ * `src/generated/action-output-schemas.json`; discovery (src/cli/contract.ts)
+ * reads that generated JSON as plain data, so the TypeBox schema graph never
+ * loads on the discovery path. SDK validation keeps using the TypeBox schema
+ * objects from `packages/types` directly.
+ *
+ * Imported by the generator and the discovery parity test only.
+ */
+const PROJECT_LIBRARY_ITEM_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["name",],
+    properties: {
+        name: { type: "string", },
+        path: { type: "string", },
+        size: { type: "integer", minimum: 0, },
+        mimeType: { type: "string", },
+        hasData: { type: "boolean", },
+        lastModified: { type: "number", },
+        children: { type: "array", items: { type: "object", additionalProperties: true, }, },
+    },
+};
+const NOTEBOOK_SAVE_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["saved", "resource", "created", "hash",],
+    properties: {
+        saved: { type: "string", },
+        resource: { enum: ["jupyter-notebook", "sql-notebook",], },
+        created: { type: "boolean", },
+        hash: { type: "string", pattern: "^[a-f0-9]{64}$", },
+    },
+};
+/**
+ * `notebook.save-sql` adds `requested`: on create DSS allocates the persisted
+ * id (`saved`), while the requested handle only becomes the display name.
+ */
+const NOTEBOOK_SAVE_SQL_OUTPUT_SCHEMA = {
+    ...NOTEBOOK_SAVE_OUTPUT_SCHEMA,
+    required: ["saved", "requested", "resource", "created", "hash",],
+    properties: {
+        ...NOTEBOOK_SAVE_OUTPUT_SCHEMA["properties"],
+        requested: { type: "string", },
+    },
+};
+let commandOutputSchemas;
+/**
+ * Canonical TypeBox-derived output schemas, keyed by `resource.action`. This is
+ * the single source of truth for `src/generated/action-output-schemas.json`,
+ * which discovery reads as plain data so no TypeBox schema graph loads on the
+ * discovery path. Regenerate with
+ * `bun scripts/generate-action-output-schemas.mjs`; `bun run check` fails when
+ * the generated file is stale. SDK validation keeps using the TypeBox schema
+ * objects from `packages/types` directly and never depends on the generated file.
+ */
+export function typeBoxCommandOutputSchemas() {
+    if (commandOutputSchemas)
+        return commandOutputSchemas;
+    const { CodeEnvDetailsSchema, CodeEnvLogSummaryArraySchema, CodeEnvSummaryArraySchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, FlowZoneArraySchema, FlowZoneSchema, JobSummaryArraySchema, JobWaitResultSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, NotebookSessionArraySchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, RecipeSummaryArraySchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlQueryResponseSchema, } = require("../schemas.js");
+    return commandOutputSchemas = {
+        "code-env.list": CodeEnvSummaryArraySchema,
+        "code-env.get": CodeEnvDetailsSchema,
+        "code-env.list-logs": CodeEnvLogSummaryArraySchema,
+        "code-env.get-log": {
+            oneOf: [
+                {
+                    type: "object",
+                    required: ["log", "bytes", "truncated", "tailed", "envLang", "envName", "logName",],
+                    properties: {
+                        log: { type: "string", },
+                        bytes: { type: "integer", minimum: 0, },
+                        truncated: { type: "boolean", },
+                        tailed: { type: "boolean", },
+                        envLang: { enum: ["PYTHON", "R",], },
+                        envName: { type: "string", },
+                        logName: { type: "string", },
+                    },
+                },
+                {
+                    type: "object",
+                    required: ["path", "bytes", "truncated", "tailed", "envLang", "envName", "logName",],
+                    properties: {
+                        path: { type: "string", },
+                        bytes: { type: "integer", minimum: 0, },
+                        truncated: { type: "boolean", },
+                        tailed: { type: "boolean", },
+                        envLang: { enum: ["PYTHON", "R",], },
+                        envName: { type: "string", },
+                        logName: { type: "string", },
+                    },
+                },
+            ],
+        },
+        "code-env.version": CodeEnvVersionForProjectSchema,
+        "code-env.usages": CodeEnvUsageArraySchema,
+        "code.run": {
+            type: "object",
+            additionalProperties: false,
+            required: [
+                "outcome",
+                "success",
+                "runId",
+                "elapsedMs",
+                "pollCount",
+                "output",
+                "logTruncated",
+                "maxLogBytes",
+                "cleanup",
+            ],
+            properties: {
+                outcome: { type: "string", },
+                success: { type: "boolean", },
+                runId: { type: "string", },
+                elapsedMs: { type: "number", minimum: 0, },
+                pollCount: { type: "integer", minimum: 0, },
+                output: { type: "string", },
+                log: { type: "string", },
+                logTruncated: { type: "boolean", },
+                maxLogBytes: { type: "integer", minimum: 0, },
+                timedOut: { const: true, },
+                timeoutMs: { type: "integer", minimum: 0, },
+                cleanup: {
+                    type: "object",
+                    additionalProperties: false,
+                    required: ["status",],
+                    properties: {
+                        status: { enum: ["deleted", "kept", "failed",], },
+                        error: { type: "string", },
+                    },
+                },
+            },
+        },
+        "notebook.list-jupyter": JupyterNotebookSummaryArraySchema,
+        "notebook.get-jupyter": JupyterNotebookContentSchema,
+        "notebook.sessions-jupyter": NotebookSessionArraySchema,
+        "notebook.list-sql": SqlNotebookSummaryArraySchema,
+        "notebook.get-sql": SqlNotebookContentSchema,
+        "notebook.history-sql": SqlNotebookHistorySchema,
+        "notebook.save-jupyter": NOTEBOOK_SAVE_OUTPUT_SCHEMA,
+        "notebook.save-sql": NOTEBOOK_SAVE_SQL_OUTPUT_SCHEMA,
+        "project-library.list": { type: "array", items: PROJECT_LIBRARY_ITEM_OUTPUT_SCHEMA, },
+        "project-library.get-bytes": {
+            type: "object",
+            additionalProperties: false,
+            required: ["path", "bytes", "sha256",],
+            properties: {
+                path: { type: "string", },
+                bytes: { type: "integer", minimum: 0, },
+                sha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
+            },
+        },
+        "project-library.put": {
+            type: "object",
+            additionalProperties: false,
+            required: ["updated", "bytes", "sha256",],
+            properties: {
+                updated: { type: "string", },
+                bytes: { type: "integer", minimum: 0, },
+                sha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
+                beforeSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
+            },
+        },
+        "project-library.diff": {
+            type: "object",
+            additionalProperties: false,
+            required: [
+                "path",
+                "unchanged",
+                "added",
+                "removed",
+                "diff",
+                "diffTruncated",
+                "localSha256",
+                "localBytes",
+                "maxLines",
+            ],
+            properties: {
+                path: { type: "string", },
+                unchanged: { type: "boolean", },
+                added: { type: "integer", minimum: 0, },
+                removed: { type: "integer", minimum: 0, },
+                diff: { type: "string", },
+                diffTruncated: { type: "boolean", },
+                binary: { type: "boolean", },
+                remoteAbsent: { type: "boolean", },
+                remoteSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
+                remoteBytes: { type: "integer", minimum: 0, },
+                localSha256: { type: "string", pattern: "^[a-f0-9]{64}$", },
+                localBytes: { type: "integer", minimum: 0, },
+                maxLines: { type: "integer", minimum: 0, },
+            },
+        },
+        "project.list": ProjectSummaryArraySchema,
+        "project.get": ProjectDetailsSchema,
+        "project.metadata": ProjectMetadataSchema,
+        "dataset.list": DatasetSummaryArraySchema,
+        "dataset.get": DatasetDetailsSchema,
+        "dataset.schema": DatasetSchemaSchema,
+        "recipe.list": RecipeSummaryArraySchema,
+        "job.list": JobSummaryArraySchema,
+        "job.wait": JobWaitResultSchema,
+        "job.monitor": JobWaitResultSchema,
+        "scenario.list": ScenarioSummaryArraySchema,
+        "scenario.get": ScenarioDetailsSchema,
+        "scenario.status": ScenarioStatusSchema,
+        "flow-zone.list": FlowZoneArraySchema,
+        "flow-zone.get": FlowZoneSchema,
+        "sql.query": {
+            anyOf: [
+                SqlQueryResponseSchema,
+                {
+                    type: "object",
+                    required: ["queryId", "rowCount", "preview",],
+                    additionalProperties: true,
+                    properties: {
+                        queryId: { type: "string", },
+                        rowCount: { type: "number", },
+                        preview: { type: "array", items: true, },
+                        truncated: { type: "boolean", },
+                        outputPath: { type: "string", },
+                        written: { type: "string", },
+                    },
+                },
+            ],
+        },
+    };
+}