@daytona/sdk 0.163.0-alpha.1 → 0.163.0

package/src/errors/DaytonaError.js

@@ -4,48 +4,255 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DaytonaTimeoutError = exports.DaytonaRateLimitError = exports.DaytonaNotFoundError = exports.DaytonaError = void 0;
+exports.DaytonaConnectionError = exports.DaytonaTimeoutError = exports.DaytonaValidationError = exports.DaytonaConflictError = exports.DaytonaAuthorizationError = exports.DaytonaAuthenticationError = exports.DaytonaRateLimitError = exports.DaytonaNotFoundError = exports.DaytonaError = void 0;
+exports.errorClassFromStatusCode = errorClassFromStatusCode;
+exports.createDaytonaError = createDaytonaError;
+exports.createAxiosDaytonaError = createAxiosDaytonaError;
 /**
  * Base error for Daytona SDK.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await daytona.get('missing-sandbox')
+ * } catch (error) {
+ *   if (error instanceof DaytonaError) {
+ *     console.log(error.statusCode)
+ *     console.log(error.errorCode)
+ *     console.log(error.message)
+ *   }
+ * }
+ * ```
  */
 class DaytonaError extends Error {
     /** HTTP status code if available */
     statusCode;
+    /** Machine-readable error code if available */
+    errorCode;
     /** Response headers if available */
     headers;
-    constructor(message, statusCode, headers) {
+    constructor(message, statusCode, headers, errorCode) {
         super(message);
-        this.name = 'DaytonaError';
+        this.name = new.target.name;
         this.statusCode = statusCode;
         this.headers = headers;
+        this.errorCode = errorCode;
     }
 }
 exports.DaytonaError = DaytonaError;
+/**
+ * Error thrown when a resource is not found (HTTP 404).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await sandbox.fs.downloadFile('/workspace/missing.txt')
+ * } catch (error) {
+ *   if (error instanceof DaytonaNotFoundError) {
+ *     console.log(error.statusCode)
+ *   }
+ * }
+ * ```
+ */
 class DaytonaNotFoundError extends DaytonaError {
-    constructor(message, statusCode, headers) {
-        super(message, statusCode, headers);
-        this.name = 'DaytonaNotFoundError';
-    }
 }
 exports.DaytonaNotFoundError = DaytonaNotFoundError;
 /**
  * Error thrown when rate limit is exceeded.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await daytona.list()
+ * } catch (error) {
+ *   if (error instanceof DaytonaRateLimitError) {
+ *     console.log(error.errorCode)
+ *   }
+ * }
+ * ```
  */
 class DaytonaRateLimitError extends DaytonaError {
-    constructor(message, statusCode, headers) {
-        super(message, statusCode, headers);
-        this.name = 'DaytonaRateLimitError';
-    }
 }
 exports.DaytonaRateLimitError = DaytonaRateLimitError;
+/**
+ * Error thrown when authentication fails (HTTP 401).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await daytona.list()
+ * } catch (error) {
+ *   if (error instanceof DaytonaAuthenticationError) {
+ *     console.log(error.statusCode)
+ *   }
+ * }
+ * ```
+ */
+class DaytonaAuthenticationError extends DaytonaError {
+}
+exports.DaytonaAuthenticationError = DaytonaAuthenticationError;
+/**
+ * Error thrown when the request is forbidden (HTTP 403).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await daytona.get('sandbox-without-access')
+ * } catch (error) {
+ *   if (error instanceof DaytonaAuthorizationError) {
+ *     console.log(error.message)
+ *   }
+ * }
+ * ```
+ */
+class DaytonaAuthorizationError extends DaytonaError {
+}
+exports.DaytonaAuthorizationError = DaytonaAuthorizationError;
+/**
+ * Error thrown when a resource conflict occurs (HTTP 409).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await daytona.create({ name: 'existing-sandbox' })
+ * } catch (error) {
+ *   if (error instanceof DaytonaConflictError) {
+ *     console.log(error.errorCode)
+ *   }
+ * }
+ * ```
+ */
+class DaytonaConflictError extends DaytonaError {
+}
+exports.DaytonaConflictError = DaytonaConflictError;
+/**
+ * Error thrown when input validation fails (HTTP 400 or client-side validation).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   Image.debianSlim('3.8' as never)
+ * } catch (error) {
+ *   if (error instanceof DaytonaValidationError) {
+ *     console.log(error.message)
+ *   }
+ * }
+ * ```
+ */
+class DaytonaValidationError extends DaytonaError {
+}
+exports.DaytonaValidationError = DaytonaValidationError;
 /**
  * Error thrown when a timeout occurs.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await sandbox.waitUntilStarted(1)
+ * } catch (error) {
+ *   if (error instanceof DaytonaTimeoutError) {
+ *     console.log(error.message)
+ *   }
+ * }
+ * ```
  */
 class DaytonaTimeoutError extends DaytonaError {
-    constructor(message, statusCode, headers) {
-        super(message, statusCode, headers);
-        this.name = 'DaytonaTimeoutError';
-    }
 }
 exports.DaytonaTimeoutError = DaytonaTimeoutError;
+/**
+ * Error thrown when a network connection fails.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await ptyHandle.waitForConnection()
+ * } catch (error) {
+ *   if (error instanceof DaytonaConnectionError) {
+ *     console.log(error.message)
+ *   }
+ * }
+ * ```
+ */
+class DaytonaConnectionError extends DaytonaError {
+}
+exports.DaytonaConnectionError = DaytonaConnectionError;
+const STATUS_CODE_TO_ERROR = {
+    400: DaytonaValidationError,
+    401: DaytonaAuthenticationError,
+    403: DaytonaAuthorizationError,
+    404: DaytonaNotFoundError,
+    409: DaytonaConflictError,
+    429: DaytonaRateLimitError,
+};
+/**
+ * Maps an HTTP status code to the corresponding Daytona error class.
+ */
+function errorClassFromStatusCode(statusCode) {
+    if (statusCode === undefined) {
+        return DaytonaError;
+    }
+    return STATUS_CODE_TO_ERROR[statusCode] || DaytonaError;
+}
+/**
+ * Creates the appropriate Daytona error subclass from structured error metadata.
+ */
+function createDaytonaError(message, statusCode, headers, errorCode) {
+    const ErrorClass = errorClassFromStatusCode(statusCode);
+    return new ErrorClass(message, statusCode, headers, errorCode);
+}
+function isAxiosTimeoutError(error) {
+    return error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT' || error.message.includes('timeout of');
+}
+function getAxiosResponseDataObject(error) {
+    if (!error.response?.data || typeof error.response.data !== 'object') {
+        return undefined;
+    }
+    return error.response.data;
+}
+function extractAxiosErrorCode(responseData) {
+    if (typeof responseData?.code === 'string') {
+        return responseData.code;
+    }
+    if (typeof responseData?.error_code === 'string') {
+        return responseData.error_code;
+    }
+    if (typeof responseData?.error === 'string') {
+        return responseData.error;
+    }
+    return undefined;
+}
+function extractAxiosErrorMessage(error) {
+    if (isAxiosTimeoutError(error)) {
+        return 'Operation timed out';
+    }
+    const responseData = getAxiosResponseDataObject(error);
+    const responseMessage = responseData?.message || error.response?.data;
+    const message = responseMessage || error.message || String(error);
+    if (typeof message === 'object') {
+        try {
+            return JSON.stringify(message);
+        }
+        catch {
+            return String(message);
+        }
+    }
+    return String(message);
+}
+/**
+ * Creates the appropriate Daytona error subclass from an Axios error.
+ */
+function createAxiosDaytonaError(error) {
+    const message = extractAxiosErrorMessage(error);
+    const statusCode = error.response?.status;
+    const headers = error.response?.headers;
+    const responseData = getAxiosResponseDataObject(error);
+    const errorCode = extractAxiosErrorCode(responseData);
+    if (isAxiosTimeoutError(error)) {
+        return new DaytonaTimeoutError(message, statusCode, headers, errorCode);
+    }
+    if (!error.response && (error.request || error.code)) {
+        return new DaytonaConnectionError(message, statusCode, headers, errorCode);
+    }
+    return createDaytonaError(message, statusCode, headers, errorCode);
+}
 //# sourceMappingURL=DaytonaError.js.map

package/src/errors/DaytonaError.js.map

@@ -1 +1 @@
-{"version":3,"file":"DaytonaError.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/errors/DaytonaError.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAUH;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,oCAAoC;IAC7B,UAAU,CAAS;IAC1B,oCAAoC;IAC7B,OAAO,CAAkB;IAEhC,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAyB;QACzE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAZD,oCAYC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAyB;QACzE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AALD,oDAKC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAyB;QACzE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AALD,sDAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAyB;QACzE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AALD,kDAKC"}
+{"version":3,"file":"DaytonaError.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/errors/DaytonaError.ts"],"names":[],"mappings":"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"}

package/src/index.d.ts

@@ -1,17 +1,19 @@
 export { CodeLanguage, Daytona } from './Daytona';
 export type { CreateSandboxBaseParams, CreateSandboxFromImageParams, CreateSandboxFromSnapshotParams, DaytonaConfig, Resources, VolumeMount, } from './Daytona';
 export { FileSystem } from './FileSystem';
+export type { DownloadMetadata, FileDownloadErrorDetails, FileDownloadRequest, FileDownloadResponse, FilePermissionsParams, FileUpload, } from './FileSystem';
 export { Git } from './Git';
 export { LspLanguageId } from './LspServer';
 export { Process } from './Process';
-export { DaytonaError, DaytonaNotFoundError, DaytonaRateLimitError, DaytonaTimeoutError } from './errors/DaytonaError';
+export { DaytonaAuthenticationError, DaytonaAuthorizationError, DaytonaConflictError, DaytonaConnectionError, DaytonaError, DaytonaNotFoundError, DaytonaRateLimitError, DaytonaTimeoutError, DaytonaValidationError, } from './errors/DaytonaError';
 export { Image } from './Image';
 export { Sandbox } from './Sandbox';
+export type { SandboxCodeToolbox } from './Sandbox';
 export type { CreateSnapshotParams } from './Snapshot';
 export { ComputerUse, Mouse, Keyboard, Screenshot, Display } from './ComputerUse';
-export type { BarChart, BarData, BoxAndWhiskerChart, BoxAndWhiskerData, Chart, Chart2D, ChartElement, CompositeChart, LineChart, PieChart, PieData, PointChart, PointData, ScatterChart, } from './types/Charts';
-export { ChartType } from './types/Charts';
 export type { ExecutionError, ExecutionResult, OutputMessage, RunCodeOptions } from './types/CodeInterpreter';
+export { ChartType } from './types/Charts';
+export type { BarChart, BoxAndWhiskerChart, Chart, CompositeChart, LineChart, PieChart, ScatterChart, } from './types/Charts';
 export { SandboxState } from '@daytona/api-client';
 export type { FileInfo, GitStatus, ListBranchResponse, Match, ReplaceResult, SearchFilesResponse, } from '@daytona/toolbox-api-client';
 export type { ScreenshotRegion, ScreenshotOptions } from './ComputerUse';

package/src/index.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SandboxState = exports.ChartType = exports.Display = exports.Screenshot = exports.Keyboard = exports.Mouse = exports.ComputerUse = exports.Sandbox = exports.Image = exports.DaytonaTimeoutError = exports.DaytonaRateLimitError = exports.DaytonaNotFoundError = exports.DaytonaError = exports.Process = exports.LspLanguageId = exports.Git = exports.FileSystem = exports.Daytona = exports.CodeLanguage = void 0;
+exports.SandboxState = exports.ChartType = exports.Display = exports.Screenshot = exports.Keyboard = exports.Mouse = exports.ComputerUse = exports.Sandbox = exports.Image = exports.DaytonaValidationError = exports.DaytonaTimeoutError = exports.DaytonaRateLimitError = exports.DaytonaNotFoundError = exports.DaytonaError = exports.DaytonaConnectionError = exports.DaytonaConflictError = exports.DaytonaAuthorizationError = exports.DaytonaAuthenticationError = exports.Process = exports.LspLanguageId = exports.Git = exports.FileSystem = exports.Daytona = exports.CodeLanguage = void 0;
 const tslib_1 = require("tslib");
 var Daytona_1 = require("./Daytona");
 Object.defineProperty(exports, "CodeLanguage", { enumerable: true, get: function () { return Daytona_1.CodeLanguage; } });
@@ -20,10 +20,15 @@ Object.defineProperty(exports, "Process", { enumerable: true, get: function () {
 // export { LspServer } from './LspServer'
 // export type { LspLanguageId, Position } from './LspServer'
 var DaytonaError_1 = require("./errors/DaytonaError");
+Object.defineProperty(exports, "DaytonaAuthenticationError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaAuthenticationError; } });
+Object.defineProperty(exports, "DaytonaAuthorizationError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaAuthorizationError; } });
+Object.defineProperty(exports, "DaytonaConflictError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaConflictError; } });
+Object.defineProperty(exports, "DaytonaConnectionError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaConnectionError; } });
 Object.defineProperty(exports, "DaytonaError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaError; } });
 Object.defineProperty(exports, "DaytonaNotFoundError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaNotFoundError; } });
 Object.defineProperty(exports, "DaytonaRateLimitError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaRateLimitError; } });
 Object.defineProperty(exports, "DaytonaTimeoutError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaTimeoutError; } });
+Object.defineProperty(exports, "DaytonaValidationError", { enumerable: true, get: function () { return DaytonaError_1.DaytonaValidationError; } });
 var Image_1 = require("./Image");
 Object.defineProperty(exports, "Image", { enumerable: true, get: function () { return Image_1.Image; } });
 var Sandbox_1 = require("./Sandbox");
@@ -34,6 +39,7 @@ Object.defineProperty(exports, "Mouse", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "Keyboard", { enumerable: true, get: function () { return ComputerUse_1.Keyboard; } });
 Object.defineProperty(exports, "Screenshot", { enumerable: true, get: function () { return ComputerUse_1.Screenshot; } });
 Object.defineProperty(exports, "Display", { enumerable: true, get: function () { return ComputerUse_1.Display; } });
+// Chart and artifact types
 var Charts_1 = require("./types/Charts");
 Object.defineProperty(exports, "ChartType", { enumerable: true, get: function () { return Charts_1.ChartType; } });
 var api_client_1 = require("@daytona/api-client");

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/sdk-typescript/src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AAEH,qCAAiD;AAAxC,uGAAA,YAAY,OAAA;AAAE,kGAAA,OAAO,OAAA;AAS9B,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AACnB,6BAA2B;AAAlB,0FAAA,GAAG,OAAA;AACZ,yCAA2C;AAAlC,0GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,0CAA0C;AAC1C,6DAA6D;AAC7D,sDAAsH;AAA7G,4GAAA,YAAY,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAAE,qHAAA,qBAAqB,OAAA;AAAE,mHAAA,mBAAmB,OAAA;AACvF,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AACd,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAEhB,6CAAiF;AAAxE,0GAAA,WAAW,OAAA;AAAE,oGAAA,KAAK,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,sGAAA,OAAO,OAAA;AAiB1D,yCAA0C;AAAjC,mGAAA,SAAS,OAAA;AAGlB,kDAAkD;AAAzC,0GAAA,YAAY,OAAA;AAYrB,oDAAyB;AACzB,sDAA2B;AAC3B,sDAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/sdk-typescript/src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AAEH,qCAAiD;AAAxC,uGAAA,YAAY,OAAA;AAAE,kGAAA,OAAO,OAAA;AAS9B,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AASnB,6BAA2B;AAAlB,0FAAA,GAAG,OAAA;AACZ,yCAA2C;AAAlC,0GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,0CAA0C;AAC1C,6DAA6D;AAC7D,sDAU8B;AAT5B,0HAAA,0BAA0B,OAAA;AAC1B,yHAAA,yBAAyB,OAAA;AACzB,oHAAA,oBAAoB,OAAA;AACpB,sHAAA,sBAAsB,OAAA;AACtB,4GAAA,YAAY,OAAA;AACZ,oHAAA,oBAAoB,OAAA;AACpB,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AACnB,sHAAA,sBAAsB,OAAA;AAExB,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AACd,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAGhB,6CAAiF;AAAxE,0GAAA,WAAW,OAAA;AAAE,oGAAA,KAAK,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,sGAAA,OAAO,OAAA;AAG1D,2BAA2B;AAC3B,yCAA0C;AAAjC,mGAAA,SAAS,OAAA;AAWlB,kDAAkD;AAAzC,0GAAA,YAAY,OAAA;AAYrB,oDAAyB;AACzB,sDAA2B;AAC3B,sDAA2B"}

package/src/types/Charts.d.ts

@@ -1,4 +1,6 @@
-import type { Chart as GeneratedChart, ChartElement as GeneratedChartElement } from '@daytona/toolbox-api-client';
+/**
+ * Chart types
+ */
 export declare enum ChartType {
     LINE = "line",
     SCATTER = "scatter",
@@ -8,30 +10,142 @@ export declare enum ChartType {
     COMPOSITE_CHART = "composite_chart",
     UNKNOWN = "unknown"
 }
-export type Chart = GeneratedChart;
-export type ChartElement = GeneratedChartElement;
-export type Chart2D = Pick<GeneratedChart, 'type' | 'title' | 'png' | 'x_label' | 'y_label' | 'elements'>;
-export type PointChart = Pick<GeneratedChart, 'type' | 'title' | 'png' | 'x_label' | 'y_label' | 'x_ticks' | 'y_ticks' | 'x_tick_labels' | 'y_tick_labels' | 'x_scale' | 'y_scale' | 'elements'>;
+/**
+ * Represents a chart with metadata from matplotlib.
+ */
+export type Chart = {
+    /** The type of chart */
+    type: ChartType;
+    /** The title of the chart */
+    title: string;
+    /** The elements of the chart */
+    elements: any[];
+    /** The PNG representation of the chart encoded in base64 */
+    png?: string;
+};
+/**
+ * Represents a 2D chart with metadata.
+ */
+export type Chart2D = Chart & {
+    /** The label of the x-axis */
+    x_label?: string;
+    /** The label of the y-axis */
+    y_label?: string;
+};
+/**
+ * Represents a point in a 2D chart.
+ */
+export type PointData = {
+    /** The label of the point */
+    label: string;
+    /** The points of the chart */
+    points: [number | string, number | string][];
+};
+/**
+ * Represents a point chart with metadata.
+ */
+export type PointChart = Chart2D & {
+    /** The ticks of the x-axis */
+    x_ticks: (number | string)[];
+    /** The scale of the x-axis */
+    x_scale: string;
+    /** The labels of the x-axis */
+    x_tick_labels: string[];
+    /** The ticks of the y-axis */
+    y_ticks: (number | string)[];
+    /** The scale of the y-axis */
+    y_scale: string;
+    /** The labels of the y-axis */
+    y_tick_labels: string[];
+    /** The points of the chart */
+    elements: PointData[];
+};
+/**
+ * Represents a line chart with metadata.
+ */
 export type LineChart = PointChart & {
-    type: 'line';
+    /** The type of chart */
+    type: ChartType.LINE;
 };
+/**
+ * Represents a scatter chart with metadata.
+ */
 export type ScatterChart = PointChart & {
-    type: 'scatter';
+    /** The type of chart */
+    type: ChartType.SCATTER;
 };
+/**
+ * Represents a bar in a bar chart.
+ */
+export type BarData = {
+    /** The label of the bar */
+    label: string;
+    /** The value of the bar */
+    value: string;
+    /** The group of the bar */
+    group: string;
+};
+/**
+ * Represents a bar chart with metadata.
+ */
 export type BarChart = Chart2D & {
-    type: 'bar';
+    /** The type of chart */
+    type: ChartType.BAR;
+    /** The bars of the chart */
+    elements: BarData[];
+};
+/**
+ * Represents a pie slice in a pie chart.
+ */
+export type PieData = {
+    /** The label of the pie slice */
+    label: string;
+    /** The angle of the pie slice */
+    angle: number;
+    /** The radius of the pie slice */
+    radius: number;
+};
+/**
+ * Represents a pie chart with metadata.
+ */
+export type PieChart = Chart & {
+    /** The type of chart */
+    type: ChartType.PIE;
+    /** The pie slices of the chart */
+    elements: PieData[];
 };
-export type PieChart = Pick<GeneratedChart, 'type' | 'title' | 'png' | 'elements'> & {
-    type: 'pie';
+/**
+ * Represents a box and whisker in a box and whisker chart.
+ */
+export type BoxAndWhiskerData = {
+    /** The label of the box and whisker */
+    label: string;
+    /** The minimum value of the box and whisker */
+    min: number;
+    /** The first quartile of the box and whisker */
+    first_quartile: number;
+    /** The median of the box and whisker */
+    median: number;
+    /** The third quartile of the box and whisker */
+    max: number;
+    outliers: number[];
 };
+/**
+ * Represents a box and whisker chart with metadata.
+ */
 export type BoxAndWhiskerChart = Chart2D & {
-    type: 'box_and_whisker';
+    /** The type of chart */
+    type: ChartType.BOX_AND_WHISKER;
+    /** The box and whiskers of the chart */
+    elements: BoxAndWhiskerData[];
 };
-export type CompositeChart = Pick<GeneratedChart, 'type' | 'title' | 'png' | 'elements'> & {
-    type: 'composite_chart';
+/**
+ * Represents a composite chart with metadata.
+ */
+export type CompositeChart = Chart & {
+    /** The type of chart */
+    type: ChartType.COMPOSITE_CHART;
+    /** The charts of the composite chart */
+    elements: Chart[];
 };
-export type PointData = Pick<GeneratedChartElement, 'label' | 'points'>;
-export type BarData = Pick<GeneratedChartElement, 'group' | 'label' | 'value'>;
-export type PieData = Pick<GeneratedChartElement, 'angle' | 'label' | 'radius'>;
-export type BoxAndWhiskerData = Pick<GeneratedChartElement, 'first_quartile' | 'label' | 'max' | 'median' | 'min' | 'outliers'>;
-export declare function parseChart(chart: GeneratedChart): Chart;
+export declare function parseChart(data: any): Chart;

package/src/types/Charts.js

@@ -6,6 +6,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChartType = void 0;
 exports.parseChart = parseChart;
+/**
+ * Chart types
+ */
 var ChartType;
 (function (ChartType) {
     ChartType["LINE"] = "line";
@@ -16,22 +19,28 @@ var ChartType;
     ChartType["COMPOSITE_CHART"] = "composite_chart";
     ChartType["UNKNOWN"] = "unknown";
 })(ChartType || (exports.ChartType = ChartType = {}));
-function parseChart(chart) {
-    switch (chart.type) {
+function parseChart(data) {
+    switch (data.type) {
         case ChartType.LINE:
-            return chart;
+            return { ...data };
         case ChartType.SCATTER:
-            return chart;
+            return { ...data };
         case ChartType.BAR:
-            return chart;
+            return { ...data };
         case ChartType.PIE:
-            return chart;
+            return { ...data };
         case ChartType.BOX_AND_WHISKER:
-            return chart;
+            return { ...data };
         case ChartType.COMPOSITE_CHART:
-            return chart;
+            // eslint-disable-next-line no-case-declarations
+            const charts = data.elements.map((g) => parseChart(g));
+            delete data.data;
+            return {
+                ...data,
+                data: charts,
+            };
         default:
-            return chart;
+            return { ...data, type: ChartType.UNKNOWN };
     }
 }
 //# sourceMappingURL=Charts.js.map

package/src/types/Charts.js.map

@@ -1 +1 @@
-{"version":3,"file":"Charts.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/types/Charts.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAgDH,gCAiBC;AA7DD,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,gCAAmB,CAAA;IACnB,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IACnC,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAoCD,SAAgB,UAAU,CAAC,KAAqB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,KAAkB,CAAA;QAC3B,KAAK,SAAS,CAAC,OAAO;YACpB,OAAO,KAAqB,CAAA;QAC9B,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,KAAiB,CAAA;QAC1B,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,KAAiB,CAAA;QAC1B,KAAK,SAAS,CAAC,eAAe;YAC5B,OAAO,KAA2B,CAAA;QACpC,KAAK,SAAS,CAAC,eAAe;YAC5B,OAAO,KAAuB,CAAA;QAChC;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"Charts.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/types/Charts.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAsKH,gCAuBC;AA3LD;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,gCAAmB,CAAA;IACnB,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IACnC,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAyJD,SAAgB,UAAU,CAAC,IAAS;IAClC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,EAAE,GAAG,IAAI,EAAe,CAAA;QACjC,KAAK,SAAS,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,IAAI,EAAkB,CAAA;QACpC,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,GAAG,IAAI,EAAc,CAAA;QAChC,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,GAAG,IAAI,EAAc,CAAA;QAChC,KAAK,SAAS,CAAC,eAAe;YAC5B,OAAO,EAAE,GAAG,IAAI,EAAwB,CAAA;QAC1C,KAAK,SAAS,CAAC,eAAe;YAC5B,gDAAgD;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3D,OAAO,IAAI,CAAC,IAAI,CAAA;YAChB,OAAO;gBACL,GAAG,IAAI;gBACP,IAAI,EAAE,MAAM;aACK,CAAA;QACrB;YACE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAW,CAAA;IACxD,CAAC;AACH,CAAC"}

package/src/types/ExecuteResponse.d.ts

@@ -1,4 +1,4 @@
-import type { Chart } from './Charts';
+import { Chart } from './Charts';
 /**
  * Artifacts from the command execution.
  *

package/src/utils/ArtifactParser.d.ts

@@ -0,0 +1,13 @@
+import { ExecutionArtifacts } from '../types/ExecuteResponse';
+/**
+ * Utility class for parsing artifacts from command output
+ */
+export declare class ArtifactParser {
+    /**
+     * Parses artifacts from command output text
+     *
+     * @param output - Raw output from command execution
+     * @returns Parsed artifacts including stdout and charts
+     */
+    static parseArtifacts(output: string): ExecutionArtifacts;
+}

package/src/utils/ArtifactParser.js

@@ -0,0 +1,55 @@
+"use strict";
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArtifactParser = void 0;
+const Charts_1 = require("../types/Charts");
+/**
+ * Utility class for parsing artifacts from command output
+ */
+class ArtifactParser {
+    /**
+     * Parses artifacts from command output text
+     *
+     * @param output - Raw output from command execution
+     * @returns Parsed artifacts including stdout and charts
+     */
+    static parseArtifacts(output) {
+        const charts = [];
+        let stdout = output;
+        // Split output by lines to find artifact markers
+        const lines = output.split('\n');
+        const artifactLines = [];
+        for (const line of lines) {
+            // Look for the artifact marker pattern
+            if (line.startsWith('dtn_artifact_k39fd2:')) {
+                artifactLines.push(line);
+                try {
+                    const artifactJson = line.substring('dtn_artifact_k39fd2:'.length).trim();
+                    const artifactData = JSON.parse(artifactJson);
+                    if (artifactData.type === 'chart' && artifactData.value) {
+                        const chartData = artifactData.value;
+                        charts.push((0, Charts_1.parseChart)(chartData));
+                    }
+                }
+                catch (error) {
+                    // Skip invalid artifacts
+                    console.warn('Failed to parse artifact:', error);
+                }
+            }
+        }
+        // Remove artifact lines from stdout along with their following newlines
+        for (const line of artifactLines) {
+            stdout = stdout.replace(line + '\n', '');
+            stdout = stdout.replace(line, '');
+        }
+        return {
+            stdout,
+            charts: charts.length > 0 ? charts : undefined,
+        };
+    }
+}
+exports.ArtifactParser = ArtifactParser;
+//# sourceMappingURL=ArtifactParser.js.map

package/src/utils/ArtifactParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactParser.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/utils/ArtifactParser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,4CAAmD;AAGnD;;GAEG;AACH,MAAa,cAAc;IACzB;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,MAAc;QACzC,MAAM,MAAM,GAAY,EAAE,CAAA;QAC1B,IAAI,MAAM,GAAG,MAAM,CAAA;QAEnB,iDAAiD;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,aAAa,GAAa,EAAE,CAAA;QAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,uCAAuC;YACvC,IAAI,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBAC5C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAExB,IAAI,CAAC;oBACH,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;oBACzE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;oBAE7C,IAAI,YAAY,CAAC,IAAI,KAAK,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;wBACxD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAA;wBACpC,MAAM,CAAC,IAAI,CAAC,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,CAAA;oBACpC,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,yBAAyB;oBACzB,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAA;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,CAAA;YACxC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACnC,CAAC;QAED,OAAO;YACL,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC/C,CAAA;IACH,CAAC;CACF;AA9CD,wCA8CC"}

package/src/utils/FileTransfer.d.ts

@@ -1,4 +1,4 @@
-import { DownloadMetadata } from '../FileSystem';
+import type { DownloadMetadata } from '../FileSystem';
 /**
  * Safely aborts a stream
  */