@supernova-studio/supernova-sdk-beta 2.4.6 → 2.4.9

package/build/types/core/data/SDKDataCoreCached.d.ts

@@ -9,7 +9,7 @@ import { DesignComponentGroup } from "../../model/groups/SDKDesignComponentGroup
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
 import { Source } from "../../model/support/SDKSource";
 import { TokenTheme } from "../../model/themes/SDKTokenTheme";
-import { Token } from "../../model/tokens/SDKToken";
+import { AnyToken } from "../../model/tokens/SDKTokenValue";
 import { DataCore } from "./SDKDataCore";
 export declare class DataCoreCached extends DataCore {
     private tokensCache;
@@ -26,7 +26,7 @@ export declare class DataCoreCached extends DataCore {
     tokens(designSystemId: string, versionId: string, filter?: {
         type?: TokenType;
         brandId?: string;
-    }): Promise<Token[]>;
+    }): Promise<AnyToken[]>;
     tokenGroups(designSystemId: string, versionId: string, filter?: {
         type?: TokenType;
         brandId?: string;

package/build/types/core/data/requests/SDKDataCoreReadRequests.d.ts

@@ -1,5 +1,7 @@
-import { DTOCodeComponent, DTOCodeComponentMarkdownQuery, DTOCodeComponentMarkdownResponse, DTOCodeComponentUsage, DTOCodeHistoryQuery, DTOCodeHistorySnapshot, DTOCodeScanListItem, DTODesignElementsDataDiffResponse, DTODesignSystem, DTODesignSystemContactsResponse, DTODesignSystemListViewItem, DTODesignSystemMemberListResponse, DTODesignSystemVersionStats, DTODocumentationAnalyticsTimeFrame, DTODocumentationLinkPreviewRequest, type DTODocumentationPageContentGetResponse, DTODocumentationPageDependenciesGetResponse, DTOFeatureArtifactListResponse, DTOFeatureIteration, DTOFeatureIterationTagListResponse, DTOFeatureMessageListResponse, DTOFeatureSandboxListResponse, DTOFigmaNode, DTOFigmaNodeV2, DTOForgeChatMessageListResponse, DTOForgeChatThreadListResponse, DTOForgeFeatureRoomResponse, DTOForgeFigmaNodeCreateRequest, DTOForgeProjectArtifact, DTOForgeProjectArtifactContentResponse, DTOForgeProjectArtifactRoomResponse, DTOForgeProjectFeature, DTOForgeProjectMembersListResponse, DTOForgeProjectPublishedFeature, DTOForgeProjectRoomResponse, DTOGetDocumentationPageAnchorsResponse, DTOLoginScreenSettings, DTOPipeline, DTOPortalSettings, DTOProjectContextOverrideResponse, type DTOSandboxTemplateListResponse, DTOSubscriptionResponse, DTOThreadMessageListResponse, DTOTokenCollection, DTOTrailEventListResponse, DTOWorkspaceUntypedDataListResponse } from "@supernova-studio/client";
+import { DTOActivityEventListResponse, DTOBillingCreditsUsageLogExportInput, DTOCodeComponent, DTOCodeComponentMarkdownQuery, DTOCodeComponentMarkdownResponse, DTOCodeComponentUsage, DTOCodeHistoryQuery, DTOCodeHistorySnapshot, DTOCodeScanListItem, DTODesignElementsDataDiffResponse, DTODesignSystem, DTODesignSystemContactsResponse, DTODesignSystemListViewItem, DTODesignSystemMemberListResponse, DTODesignSystemVersionStats, DTODocumentationAnalyticsTimeFrame, DTODocumentationLinkPreviewRequest, type DTODocumentationPageContentGetResponse, DTODocumentationPageDependenciesGetResponse, DTOFeatureArtifactListResponse, DTOFeatureIteration, DTOFeatureIterationTagListResponse, DTOFeatureMessageListResponse, DTOFeatureSandboxListResponse, DTOFigmaNode, DTOFigmaNodeV2, DTOForgeChatMessageListResponse, DTOForgeChatThreadListResponse, DTOForgeFeatureRoomResponse, DTOForgeFigmaNodeCreateRequest, DTOForgeProjectArtifact, DTOForgeProjectArtifactContentResponse, DTOForgeProjectArtifactRoomResponse, DTOForgeProjectFeature, DTOForgeProjectMembersListResponse, DTOForgeProjectPublishedFeature, DTOForgeProjectRoomResponse, DTOGetDocumentationPageAnchorsResponse, DTOLoginScreenSettings, DTOPageHistoryVersionContent, DTOPageHistoryVersionListResponse, DTOPipeline, DTOPortalSettings, DTOProjectContextOverrideResponse, type DTOSandboxTemplateListResponse, DTOSubscriptionResponse, DTOThreadMessageListResponse, DTOTokenCollection, DTOTrailEventListResponse, DTOWorkspaceUntypedDataListResponse, type DTODocumentationMarkdownFetchErrorCode, type DTODocumentationMarkdownFromUrlMode } from "@supernova-studio/client";
 import { DocumentationLegacyGroupModel } from "../../../exports";
+import { ActivityEventListFilter } from "../../../model/activity-events/SDKActivityEvent";
+import type { AgentChatChangedEntitiesResponse, AgentChatListFilter, AgentChatListResponse, AgentChatResponse } from "../../../model/agent-chats/SDKAgentChat";
 import { BootstrapDataRemoteModel } from "../../../model/base/SDKBootstrapData";
 import { BrandRemoteModel } from "../../../model/base/SDKBrand";
 import { DesignSystemVersionCreationJobRemoteModel, DesignSystemVersionRemoteModel } from "../../../model/base/SDKDesignSystemVersion";
@@ -142,9 +144,9 @@ export declare class DataCoreReadRequests {
         sourceId?: string;
         importState?: "Success" | "InProgress" | "Failed";
         rootNode?: {
+            type?: "DOCUMENT" | "CANVAS" | "FRAME" | "COMPONENT" | "COMPONENT_SET";
             id?: string;
             name?: string;
-            type?: "DOCUMENT" | "CANVAS" | "FRAME" | "COMPONENT" | "COMPONENT_SET";
             size?: {
                 width?: number;
                 height?: number;
@@ -169,8 +171,15 @@ export declare class DataCoreReadRequests {
     /** Remote: Get documentation metadata */
     getRemoteRealDocumentationStructure(designSystemId: string, versionId: string): Promise<(DocsEntityPageModel | DocsEntityGroupModel)[]>;
     getRemoteDocumentationContentRaw(designSystemId: string, versionId: string, pageId: string): Promise<DTODocumentationPageContentGetResponse["pageContent"]>;
+    /** Remote: Download markdown content from a URL through the workspace git integration and store it for the version */
+    getRemoteMarkdownFromUrl(designSystemId: string, versionId: string, url: string, mode: DTODocumentationMarkdownFromUrlMode): Promise<{
+        content: string;
+        lastError: DTODocumentationMarkdownFetchErrorCode | null;
+    }>;
     /** Remote: Get id of the room for a specific page */
     getRemoteDocumentationPageRoomId(designSystemId: string, versionId: string, pageId: string): Promise<string>;
+    listRemotePageHistoryVersions(designSystemId: string, versionId: string, pageId: string): Promise<DTOPageHistoryVersionListResponse["pageHistoryVersions"]>;
+    getRemotePageHistoryVersion(designSystemId: string, versionId: string, pageId: string, pageHistoryVersionId: string): Promise<DTOPageHistoryVersionContent>;
     /** Remote: Get id of the room for a specific design system and version. This room contains doc structure */
     getRemoteDocumentationVersionRoomId(designSystemId: string, versionId: string): Promise<string>;
     /** Remote: Get id of the room for a specific workspace. */
@@ -363,6 +372,24 @@ export declare class DataCoreReadRequests {
         designSystemId?: string;
         brandId?: string;
         theme?: {
+            spacing?: {
+                value?: {
+                    unit?: "Pixels" | "Percent" | "Rem" | "Ms" | "Raw" | "Points";
+                    measure?: number;
+                };
+                aliasTo?: string;
+            };
+            radius?: {
+                value?: {
+                    unit?: "Pixels" | "Percent" | "Rem" | "Ms" | "Raw" | "Points";
+                    measure?: number;
+                };
+                aliasTo?: string;
+            };
+            fontFamily?: {
+                value?: string;
+                aliasTo?: string;
+            };
             card?: {
                 value?: {
                     color?: string | {
@@ -378,17 +405,6 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            fontFamily?: {
-                value?: string;
-                aliasTo?: string;
-            };
-            radius?: {
-                value?: {
-                    unit?: "Pixels" | "Percent" | "Rem" | "Ms" | "Raw" | "Points";
-                    measure?: number;
-                };
-                aliasTo?: string;
-            };
             border?: {
                 value?: {
                     color?: string | {
@@ -404,14 +420,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            spacing?: {
-                value?: {
-                    unit?: "Pixels" | "Percent" | "Rem" | "Ms" | "Raw" | "Points";
-                    measure?: number;
-                };
-                aliasTo?: string;
-            };
-            sidebar?: {
+            input?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -636,7 +645,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            input?: {
+            ring?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -651,7 +660,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            ring?: {
+            chart1?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -666,7 +675,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            chart1?: {
+            chart2?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -681,7 +690,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            chart2?: {
+            chart3?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -696,7 +705,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            chart3?: {
+            chart4?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -711,7 +720,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            chart4?: {
+            chart5?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -726,7 +735,7 @@ export declare class DataCoreReadRequests {
                 };
                 aliasTo?: string;
             };
-            chart5?: {
+            sidebar?: {
                 value?: {
                     color?: string | {
                         aliasTo?: string;
@@ -1067,6 +1076,7 @@ export declare class DataCoreReadRequests {
             shadow2xs?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1082,10 +1092,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1094,6 +1102,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1102,6 +1111,7 @@ export declare class DataCoreReadRequests {
             shadowXs?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1117,10 +1127,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1129,6 +1137,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1137,6 +1146,7 @@ export declare class DataCoreReadRequests {
             shadowSm?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1152,10 +1162,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1164,6 +1172,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1172,6 +1181,7 @@ export declare class DataCoreReadRequests {
             shadowMd?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1187,10 +1197,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1199,6 +1207,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1207,6 +1216,7 @@ export declare class DataCoreReadRequests {
             shadowLg?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1222,10 +1232,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1234,6 +1242,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1242,6 +1251,7 @@ export declare class DataCoreReadRequests {
             shadowXl?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1257,10 +1267,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1269,6 +1277,7 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
@@ -1277,6 +1286,7 @@ export declare class DataCoreReadRequests {
             shadow2xl?: {
                 value?: {
                     value?: {
+                        radius?: number;
                         color?: {
                             value?: {
                                 color?: string | {
@@ -1292,10 +1302,8 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
-                        type?: "Drop" | "Inner";
                         x?: number;
                         y?: number;
-                        radius?: number;
                         spread?: number;
                         opacity?: {
                             value?: {
@@ -1304,23 +1312,27 @@ export declare class DataCoreReadRequests {
                             };
                             aliasTo?: string;
                         };
+                        type?: "Drop" | "Inner";
                     };
                     aliasTo?: string;
                 }[];
                 aliasTo?: string;
             };
         };
-        thumbnail?: {
-            id?: string;
-            name?: string;
-            source?: {
-                type?: "UserUpload";
-                userId?: string;
-            } | {
-                type?: "Figma";
-                renderMode?: "Image" | "HTML" | "JSON";
+        scope?: {
+            designSystemId?: string;
+            selections?: {
+                tokens?: import("@supernova-studio/model").DatasetFilterGroup;
+                tokenThemes?: import("@supernova-studio/model").DatasetFilterGroup;
+                figmaComponents?: import("@supernova-studio/model").DatasetFilterGroup;
+                designComponents?: import("@supernova-studio/model").DatasetFilterGroup;
+                assets?: import("@supernova-studio/model").DatasetFilterGroup;
+                documentation?: import("@supernova-studio/model").DatasetFilterGroup;
+                contexts?: import("@supernova-studio/model").DatasetFilterGroup;
+                skills?: import("@supernova-studio/model").DatasetFilterGroup;
+                files?: import("@supernova-studio/model").DatasetFilterGroup;
+                codeComponents?: import("@supernova-studio/model").DatasetFilterGroup;
             };
-            url?: string;
         };
         defaultTokenThemeSetId?: string;
         productContext?: string;
@@ -1338,21 +1350,6 @@ export declare class DataCoreReadRequests {
         }[];
         includedContextIds?: string[];
         includedByContextIds?: string[];
-        scope?: {
-            designSystemId?: string;
-            selections?: {
-                tokens?: import("@supernova-studio/model").DatasetFilterGroup;
-                tokenThemes?: import("@supernova-studio/model").DatasetFilterGroup;
-                figmaComponents?: import("@supernova-studio/model").DatasetFilterGroup;
-                designComponents?: import("@supernova-studio/model").DatasetFilterGroup;
-                assets?: import("@supernova-studio/model").DatasetFilterGroup;
-                documentation?: import("@supernova-studio/model").DatasetFilterGroup;
-                contexts?: import("@supernova-studio/model").DatasetFilterGroup;
-                skills?: import("@supernova-studio/model").DatasetFilterGroup;
-                files?: import("@supernova-studio/model").DatasetFilterGroup;
-                codeComponents?: import("@supernova-studio/model").DatasetFilterGroup;
-            };
-        };
         mcpUrlSlug?: string;
         metadata?: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
             [key: string]: string | number | boolean | /*elided*/ any | /*elided*/ any;
@@ -1386,6 +1383,18 @@ export declare class DataCoreReadRequests {
             type?: "Phosphor" | "Lucide" | "Tabler";
             variant?: string;
         };
+        thumbnail?: {
+            id?: string;
+            name?: string;
+            source?: {
+                type?: "UserUpload";
+                userId?: string;
+            } | {
+                type?: "Figma";
+                renderMode?: "Image" | "HTML" | "JSON";
+            };
+            url?: string;
+        };
         sandboxTemplate?: {
             id?: string;
             version?: string;
@@ -1419,8 +1428,12 @@ export declare class DataCoreReadRequests {
     getRemoteForgeProjectTrailEvents({ projectId, }: {
         projectId: string;
     }): Promise<DTOTrailEventListResponse>;
+    getRemoteActivityEvents(filter: ActivityEventListFilter): Promise<DTOActivityEventListResponse>;
     getRemotePublishedFeature(featureId: string): Promise<DTOForgeProjectPublishedFeature>;
     getRemoteThreads(threadId: string): Promise<DTOThreadMessageListResponse>;
+    getRemoteAgentChats(filter: AgentChatListFilter): Promise<AgentChatListResponse>;
+    getRemoteAgentChatByEveSession(eveSessionId: string): Promise<AgentChatResponse>;
+    getRemoteAgentChatChangedEntities(chatId: string): Promise<AgentChatChangedEntitiesResponse>;
     validateFigmaNodeAccess(input: DTOForgeFigmaNodeCreateRequest): Promise<boolean>;
     getRemoteBuild(workspaceId: string, buildId: string): Promise<ExportBuildModel>;
     getRemoteBuilds(workspaceId: string, versionId: string, docsEnvironment?: DocumentationEnvironment, limit?: number, offset?: number, scheduleId?: string, exporterId?: string, destinations?: Array<"s3" | "webhook" | "github" | "documentation" | "azure" | "gitlab">, createdByUserId?: string, status?: ExportBuildStatus): Promise<Array<ExportBuildModel>>;
@@ -1455,6 +1468,9 @@ export declare class DataCoreReadRequests {
     getWorkspaceCreditsAvailability(workspaceId: string): Promise<{
         canSpendCredits?: boolean;
     }>;
+    getRemoteCreditsUsageLogExport(workspaceId: string, range: DTOBillingCreditsUsageLogExportInput): Promise<{
+        downloadUrl?: string;
+    }>;
     /** Remote: Get MCP stream by ID */
     getRemoteMCPStream(streamId: string): Promise<{
         stream?: {
@@ -1471,6 +1487,17 @@ export declare class DataCoreReadRequests {
             projectDocumentId?: string;
         };
     }>;
+    /** Remote: List MCP consumers, optionally scoped to a context or design system */
+    getRemoteMCPConsumers(workspaceId: string, contextId?: string, designSystemId?: string): Promise<{
+        consumers?: {
+            userId?: string;
+            lastAccessedAt?: Date;
+        }[];
+    }>;
+    /** Remote: Effective MCP consumer count, optionally scoped to a context or design system */
+    getRemoteMCPUsageStats(workspaceId: string, contextId?: string, designSystemId?: string): Promise<{
+        mcpConsumerCount?: number;
+    }>;
     /**
      * Fetches all untyped data for a given workspace.
      * @param workspaceId - The ID of the workspace.