@picsart/ai-sdk 6.15.0 → 6.15.1

package/README.md

@@ -153,6 +153,35 @@ const folders = await ai.drive.folders()
 const items = await ai.drive.list()
 ```
 
+Generated Drive assets carry `model` and JSON `aiSDKPayload` automatically. Both
+`generate()` and `submit()` record the original SDK inputs; custom Drive attributes
+cannot replace that provenance. These are requested inputs, not a claim that every
+provider default or rewritten prompt has been recovered. The stored prompt is capped
+at 18,000 characters without changing the prompt sent to generation.
+
+`apis.run()` remains a direct vendor API pass-through. It does not apply the client’s
+Drive configuration or derive SDK metadata, even when a vendor payload explicitly
+requests Drive saving. Vendor-shaped inputs must never be stored as `aiSDKPayload`;
+that attribute is reserved for original SDK-shaped inputs.
+
+For a separate or delayed save, pass the original generation context:
+
+```typescript
+await ai.drive.save({
+  url: generatedUrl,
+  name: 'clip.mp4',
+  resourceType: 'VIDEO',
+  generation: { modelId, params: originalGenerationParams },
+})
+// The existing helper also accepts a full params object instead of just a prompt:
+const saveParams = ai.drive.buildSaveParams(generatedUrl, modelId, modelName, 'video', originalGenerationParams)
+```
+
+Legacy `model`/`prompt`/`textScript` saves are normalized at write time. URL-only
+uploads remain ordinary uploads: without generation context the SDK cannot infer
+model, prompt or settings. Existing Drive files are not backfilled. The backend preserves SDK-supplied metadata; it cannot reconstruct SDK input
+names or catalog model IDs from an arbitrary vendor request.
+
 ## Text Generation (LLMs)
 
 Claude, GPT, and Gemini text models are called with `generateText()`. Single-shot:

package/index.d.ts

@@ -2668,11 +2668,19 @@ interface ListOptions {
     folder?: DriveFolder;
     type?: MediaTypeFilter;
 }
+/** Original generation inputs, portable across clients and delayed Drive saves. */
+interface GenerationProvenance {
+    modelId: string;
+    params: Record<string, unknown>;
+    app?: AppIdentity;
+}
 interface SaveParams {
     url: string;
     name: string;
     resourceType: 'PHOTO' | 'VIDEO' | 'AUDIO';
     attributes?: Record<string, string>;
+    /** Required to retain full provenance when saving a generated URL separately. */
+    generation?: GenerationProvenance;
     previewUrl?: string;
 }
 /** Target folder for backend Drive save. */
@@ -2714,7 +2722,7 @@ interface DriveClient {
     /** Save an asset to Drive. */
     save(params: SaveParams, folder?: DriveFolder): Promise<DriveSaveResult | null>;
     /** Build the save params for a generation result. */
-    buildSaveParams(url: string, modelId: string, modelName: string, mode: string, prompt?: string): SaveParams;
+    buildSaveParams(url: string, modelId: string, modelName: string, mode: string, promptOrParams?: string | Record<string, unknown>): SaveParams;
     /** Set a like/dislike reaction on a file. */
     addReaction(fileUid: string, reaction: UserReaction): Promise<boolean>;
     /** Clear the reaction on a file. */
@@ -2744,12 +2752,7 @@ declare function resolveExtension(mode: string, hints?: FilenameHints): string;
  */
 declare function expectedOutputFormat(model: Pick<ModelDefinition, 'paramConfig' | 'outputExtension'>, params: Record<string, unknown>): string | undefined;
 declare function buildFilename(prompt: string | undefined, mode: string, hints?: FilenameHints): string;
-declare function buildGenerationAttributes(input: {
-    modelId: string;
-    params: Record<string, unknown>;
-    /** TODO(backend-autosave): temporary — remove once the backend stamps appId/appType. */
-    app?: AppIdentity;
-}): DriveAttributes;
+declare function buildGenerationAttributes(input: GenerationProvenance): DriveAttributes;
 declare function parseGeneration(file: DriveFile | Record<string, unknown>): GenerationFile;
 
 /** Result of `ai.apis.run()` — the API result plus optional credit usage. */
@@ -3545,4 +3548,4 @@ declare const getModel: (id: string) => ModelDefinition | undefined;
  */
 declare const findModel: (ref: string) => ModelDefinition | undefined;
 
-export { ALL_MODELS, type AiClient, ApiError, type ApiErrorCode, type ApiErrorInit, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, type CreditUsage, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveDraftInfo, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateResultItemMetadata, type GenerateTextResult, type GenerationContext, type GenerationEvent, GenerationEventType, type GenerationFile, type GenerationMode, type GenerationOptions, type GenerationProgress, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PayloadInputsTransformationOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type SeedanceDraftTask, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TransportPollOptions, type TransportResult, type TypedModelId, type UserReaction, type ValidationResult, type VoiceOption, type WorkflowJobHandle, type WorkflowSubmitRequest, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, expectedOutputFormat, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, resolveExtension, toAvatarOption, toVoiceOption };
+export { ALL_MODELS, type AiClient, ApiError, type ApiErrorCode, type ApiErrorInit, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, type CreditUsage, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveDraftInfo, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateResultItemMetadata, type GenerateTextResult, type GenerationContext, type GenerationEvent, GenerationEventType, type GenerationFile, type GenerationMode, type GenerationOptions, type GenerationProgress, type GenerationProvenance, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PayloadInputsTransformationOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type SeedanceDraftTask, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TransportPollOptions, type TransportResult, type TypedModelId, type UserReaction, type ValidationResult, type VoiceOption, type WorkflowJobHandle, type WorkflowSubmitRequest, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, expectedOutputFormat, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, resolveExtension, toAvatarOption, toVoiceOption };

package/index.js

@@ -11997,6 +11997,23 @@ function buildGenerationAttributes(input) {
   }
   return attrs;
 }
+function attributesForSave(params2) {
+  const attributes = { ...params2.attributes };
+  if (params2.generation) {
+    return { ...attributes, ...buildGenerationAttributes(params2.generation) };
+  }
+  if (asString(attributes.model)) {
+    const legacy = adaptLegacyGeneration(attributes);
+    const canonical = parseJsonAttr(attributes.aiSDKPayload);
+    const payload = canonical && typeof canonical.prompt === "string" ? canonical : legacy.aiSDKPayload ?? {};
+    return {
+      ...legacy.appId ? { appId: legacy.appId, appType: legacy.appType } : {},
+      ...attributes,
+      ...buildGenerationAttributes({ modelId: attributes.model, params: payload })
+    };
+  }
+  return attributes;
+}
 function toMediaItem(file) {
   const url = normalizeUrl(file.sourceUrl);
   if (!url || String(file.name || "").startsWith("__")) return null;
@@ -12332,7 +12349,7 @@ function createDriveClient(f, apiUrl, rootFolderName) {
           width: 1024,
           height: 1024
         },
-        attributes: Object.entries(params2.attributes ?? {}).map(([property, value]) => ({
+        attributes: Object.entries(attributesForSave(params2)).map(([property, value]) => ({
           property,
           value
         }))
@@ -12360,15 +12377,17 @@ function createDriveClient(f, apiUrl, rootFolderName) {
       }
     },
     /** Build standard save params from a generation result. */
-    buildSaveParams(url, modelId, modelName, mode, prompt) {
+    buildSaveParams(url, modelId, modelName, mode, promptOrParams) {
+      const params2 = typeof promptOrParams === "string" ? { prompt: promptOrParams } : promptOrParams ?? {};
+      const prompt = String(params2.prompt ?? "");
       return {
         url,
         name: buildFilename(prompt, mode, { url }),
         resourceType: inferResourceType(mode),
         attributes: {
           tool: "ai-sdk",
-          model: modelId,
-          prompt: prompt || "",
+          ...buildGenerationAttributes({ modelId, params: params2 }),
+          prompt,
           service: modelName
         }
       };
@@ -12676,8 +12695,8 @@ function createClient(config) {
     return {
       // Named before the job runs, so the requested/declared format is the best hint.
       name: explicit?.name ?? buildFilename(params2.prompt, model.mode, { format: expectedOutputFormat(model, params2) }),
-      // SDK-assembled attributes are the baseline; explicit attributes win per-key.
-      attributes: { ...attributes, ...explicit?.attributes ?? {} },
+      // Generation provenance is authoritative; custom attributes cannot replace it.
+      attributes: { ...explicit?.attributes ?? {}, ...attributes },
       folder: explicit?.folder ?? (folderPath ? { path: folderPath } : void 0)
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "6.15.0",
+  "version": "6.15.1",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",