@stackshift-cloud/sdk 1.3.0 → 1.4.0

package/README.md

@@ -172,6 +172,38 @@ await stackshift.mail.send({
 
 Add the returned SPF, DKIM, and return-path DNS records before verifying. DMARC is recommended by default and may be required if your StackShift environment sets `MAIL_DMARC_REQUIRED=true`. DNS propagation can take time, so a missing or pending status usually means you should wait and verify again.
 
+## Mailboxes
+
+Host real mailboxes on your own domain. The mailbox owner gets an invitation by email and sets their own password.
+
+```ts
+const domain = await stackshift.mail.mailboxDomains.create('acme.com')
+
+console.log(domain.records)
+
+await stackshift.mail.mailboxDomains.verify(domain.id)
+
+const mailbox = await stackshift.mail.mailboxes.create({
+  domainId: domain.id,
+  localPart: 'ada',
+  ownerEmail: 'ada@personal.example',
+  plan: 'basic',
+})
+
+await stackshift.mail.aliases.create({ mailboxId: mailbox.id, localPart: 'sales', sendAs: true })
+
+await stackshift.mail.routes.create({
+  domainId: domain.id,
+  pattern: 'orders-*',
+  targets: [{ kind: 'app', webhookUrl: 'https://app.example.com/inbound' }],
+})
+
+const devices = await stackshift.mail.mailboxes.listDevices(mailbox.id)
+await stackshift.mail.mailboxes.suspend(mailbox.id)
+```
+
+`stackshift.mail.groups` manages team addresses, and `stackshift.mail.mailboxImports` copies mail from Google, Microsoft or any IMAP server.
+
 ## Upload an asset
 
 ```ts
@@ -385,3 +417,21 @@ const workspace = await video.workspace(assetId)
 Mutations carry the supplied revision in `If-Match`. Model preparation and rendering carry an idempotency key; render submission also carries the accepted maximum units. Playback renewal and events authenticate with the session credential, not the account key. Keep these clients on your backend and return grants with `Cache-Control: private, no-store`.
 
 See the [Assets SDK guide](https://docs.stackshift.cloud/assets/sdk-media-workflows) and its linked feature guides for complete language examples, inputs, permissions, review transitions and browser callbacks.
+
+## Support action receivers (unreleased)
+
+The SDK exports `SupportActionManifest` / `SupportActionDescriptor` and installation consent types for `stackshift.support.app/v2`, `validateSupportActionCatalog`, `verifySupportAction`, `receiveSupportAction`, signing/receipt helpers, and `SupportActionSQLiteStore`. V1 app registration remains actionless. Registered writes require an idempotent receiver, reconciliation endpoint and registered read verification operation; installation `action_operations` is explicit consent. No action is automatically registered or granted by this SDK.
+
+`receiveSupportAction(rawBytes, headers, { verification, store, execute, reconcile })` requires the installation action key/secret, exact catalog, installation ID and trusted expected customer external ID. It authenticates before dispatch, validates primitive arguments/success output and signs the exact returned receipt bytes. Keep the original body bytes across retries, use a new delivery UUID per attempt, and never derive the expected customer from unverified input. Reconciliation is a separate handler and never invokes `execute`.
+
+Supply a durable `SupportActionDurableStore`. The SQLite adapter accepts a `node:sqlite` compatible database; its example requires Node >=22.13 and a persistent disk file. Core verification uses Web Crypto and does not require SQLite. The runnable file receiver at `examples/support-actions/receiver.mjs` intentionally returns `demo_not_implemented`; replace its handlers with customer-bound business transactions. Set `ACTION_KEY_ID`, `ACTION_SECRET`, `ACTION_INSTALLATION_ID`, and trusted `EXPECTED_CUSTOMER_EXTERNAL_ID`, then run:
+
+```sh
+npm run build
+node examples/support-actions/receiver.mjs /absolute/path/claims.sqlite headers.json actions.json < body.json
+npm run test:support-actions
+```
+
+Return `response.body` unchanged with `response.headers`. `accepted` means the application durably accepted work; unknown/running claims never redispatch. Resolve uncertain results through the separate reconciliation request or human review. The adapter is a single-host durable example, not a distributed exactly-once guarantee; downstream mutations need their own idempotency or an atomic business/receipt transaction. Claims are not automatically deleted or leased for takeover. There is no asynchronous callback reporting endpoint in this protocol version.
+
+Shared conformance and operational details are in `../support-actions-conformance/README.md`. Eight action tests cover signatures, expiry/binding, raw-byte conflicts, disk restart, uncertain outcomes, in-flight execution, and fenced completion. Live installation/provider qualification remains unrun; this code is unreleased.

package/dist/asset-workflows.d.ts

@@ -179,21 +179,13 @@ export interface AssetWorkflowHTTPCredentialInput {
     value: string;
 }
 export interface AssetAutomationOverview {
-    mcp_endpoint: '/api/v1/assets/mcp';
-    auth_method: 'pat';
+    mcp_endpoint: '/api/v1/agents/mcp';
+    auth_method: 'agent_connection';
     tools: Array<{
-        name: string;
+        action: string;
+        mcp_tool: string;
         description: string;
-        required_scope: string;
-        required_scopes?: string[];
-        risk: string;
-    }>;
-    recent_executions: Array<{
-        id: string;
-        tool: string;
-        transport: string;
-        status: string;
-        created_at: string;
+        kind: 'read' | 'write' | 'destructive';
     }>;
 }
 export declare class AssetWorkflowsClient {

package/dist/assets-platform-types.d.ts

@@ -209,10 +209,27 @@ export interface AssetTextExtractionInput {
     language?: string;
     options?: Record<string, JsonValue>;
 }
-export type AssetMigrationReport = {
+export interface AssetMigrationReconciliation {
+    discovered: number;
+    imported: number;
+    skipped: number;
+    failed: number;
+    canceled: number;
+    unresolved: number;
+    mapped: number;
+    verified_checksums: number;
+    missing_checksums: number;
+    warnings: Record<string, number>;
+    inventory_reconciled: boolean;
+    delivery_verified: boolean;
+    cutover_ready: boolean;
+    next_actions: string[];
+}
+export interface AssetMigrationReport {
     migration: AssetMigration;
     items: AssetMigrationItem[];
-} | Record<string, JsonValue>;
+    reconciliation?: AssetMigrationReconciliation;
+}
 export type AssetCapabilityUploadResult = Asset;
 export type AssetStorageBucket = AssetBucket;
 export {};

package/dist/assets.d.ts

@@ -4,7 +4,7 @@ import type { StackShift } from './client.js';
 import { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 import { AssetWorkflowsClient } from './asset-workflows.js';
 import type { AssetDerivedAsset, AssetImageGenerationInput, AssetTransformDefinition, AssetTransformMaterializeInput } from './asset-media-v2.js';
-import type { Asset, AssetBucket, AssetBucketInput, AssetAIAccountConfig, AssetPatchInput, AssetCustomDomain, AssetEvent, AssetJob, AssetJobSubmission, AssetLifecycleRule, AssetUsageSummary, AssetWebhook, AssetWebhookDelivery, AssetAIInfo, AssetCollection, AssetContentPolicy, AssetNamedTransformInput, AssetListOptions, AssetListResult, AssetSavedSearch, AssetTranscript, AssetUploadProgressCallbacks, AssetVersion, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedTransformOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTransformOptions, AssetTransformPreset, AssetUploadOptions } from './types.js';
+import type { Asset, AssetBucket, AssetBucketInput, AssetAIAccountConfig, AssetPatchInput, AssetAIAnnotation, AssetManualDescriptionInput, AssetCustomDomain, AssetEvent, AssetJob, AssetJobSubmission, AssetLifecycleRule, AssetUsageSummary, AssetWebhook, AssetWebhookDelivery, AssetAIInfo, AssetCollection, AssetContentPolicy, AssetNamedTransformInput, AssetListOptions, AssetListResult, AssetSavedSearch, AssetTranscript, AssetUploadProgressCallbacks, AssetVersion, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedTransformOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTransformOptions, AssetTransformPreset, AssetUploadOptions } from './types.js';
 export declare const assetTransformPresets: AssetTransformPreset[];
 export declare function getAssetTransformPreset(name: string): AssetTransformPreset | undefined;
 export declare function assetTransformOptions(preset: AssetTransformPreset): AssetTransformOptions;
@@ -47,6 +47,7 @@ export declare class AssetsClient {
         tags: string[];
         revision: number;
     }>;
+    describe(assetId: string, input: AssetManualDescriptionInput): Promise<AssetAIAnnotation>;
     patchMetadata(assetId: string, revision: number, metadata: Record<string, unknown>): Promise<{
         updated: boolean;
         revision: number;

package/dist/assets.js

@@ -196,6 +196,9 @@ export class AssetsClient {
             method: 'PUT', body: { tags }, headers: { 'If-Match': `"${revision}"` },
         });
     }
+    describe(assetId, input) {
+        return this.client.request(`/assets/${encodeURIComponent(assetId)}/description`, { method: 'PUT', body: input });
+    }
     patchMetadata(assetId, revision, metadata) {
         return this.client.request(`/assets/${encodeURIComponent(assetId)}/metadata`, {
             method: 'PATCH', body: { metadata }, headers: { 'If-Match': `"${revision}"` },

package/dist/client.js

@@ -4,7 +4,7 @@ import { MailClient } from './mail.js';
 import { ProjectsClient } from './projects.js';
 import { WorkloadSecurityClient } from './workload-security.js';
 const defaultBaseUrl = 'https://api.stackshift.cloud/api/v1';
-const defaultMailBaseUrl = 'https://api.stackshift.cloud/v1';
+const defaultMailBaseUrl = 'https://api.stackshift.cloud/api/v1';
 const defaultCdnBaseUrl = 'https://cdn.stackshift.cloud';
 export class StackShift {
     aiCredits;
@@ -64,6 +64,7 @@ export class StackShift {
             method: init.method ?? 'GET',
             headers: stripUndefined({
                 Authorization: `Bearer ${this.apiKey}`,
+                'User-Agent': typeof window === 'undefined' ? 'StackShift-JS/1.0' : undefined,
                 'X-Asset-Space-ID': path.startsWith('/assets') ? this.assetSpaceId : undefined,
                 'Content-Type': isFormData ? undefined : 'application/json',
                 ...init.headers,

package/dist/generated/assets-contract.d.ts

@@ -1,4 +1,4 @@
-export type AssetOperationId = 'putAssetAICredential' | 'deleteAssetAICredential' | 'openAssetAIOutput' | 'getVideoWorkspace' | 'processVideoVersion' | 'createVideoPlaybackSession' | 'revokeVideoPlaybackSession' | 'reviewVideoVersion' | 'listVideoCaptions' | 'addVideoCaption' | 'removeVideoCaption' | 'getVideoAnalytics' | 'createPublicVideoPlaybackSession' | 'openPublicPlayerMedia' | 'renewVideoPlaybackSession' | 'recordVideoPlaybackEvents' | 'uploadAsset' | 'createUploadSession' | 'getUploadSession' | 'completeUploadSession' | 'cancelUploadSession' | 'createSignedUploadUrl' | 'createBucket' | 'listBuckets' | 'updateBucket' | 'deleteBucket' | 'configureBucketStorage' | 'startBucketRelocation' | 'createAssetConnection' | 'listAssetConnections' | 'getAssetConnection' | 'updateAssetConnection' | 'verifyAssetConnection' | 'deleteAssetConnection' | 'listOwnedS2Buckets' | 'createOwnedS2Bucket' | 'startAssetMigration' | 'listAssetMigrations' | 'getAssetMigration' | 'cancelAssetMigration' | 'retryAssetMigrationItem' | 'downloadAssetMigrationReport' | 'createAssetUploadCapability' | 'getContentPolicy' | 'updateContentPolicy' | 'upsertTransformation' | 'listTransformations' | 'materializeAssetTransform' | 'listAssetDerivatives' | 'generateAsset' | 'getAssetAutomation' | 'assetMCP' | 'getAssetWorkflowCatalog' | 'listAssetWorkflows' | 'createAssetWorkflow' | 'getAssetWorkflow' | 'updateAssetWorkflowDraft' | 'validateAssetWorkflow' | 'publishAssetWorkflow' | 'activateAssetWorkflow' | 'startAssetWorkflowRun' | 'listAssetWorkflowVersions' | 'listAssetWorkflowRuns' | 'getAssetWorkflowRun' | 'cancelAssetWorkflowRun' | 'retryAssetWorkflowRun' | 'listAssetWorkflowApprovals' | 'approveAssetWorkflow' | 'rejectAssetWorkflow' | 'listAssetWorkflowConnections' | 'createAssetWorkflowConnection' | 'rotateAssetWorkflowConnectionCredential' | 'rotateAssetWorkflowInboundHook' | 'receiveAssetWorkflowInboundHook' | 'deleteTransformation' | 'createLifecycleRule' | 'listLifecycleRules' | 'deleteLifecycleRule' | 'createDomain' | 'listDomains' | 'verifyDomain' | 'deleteDomain' | 'getAnalytics' | 'getUsageSummary' | 'listEvents' | 'createWebhook' | 'listWebhooks' | 'deleteWebhook' | 'listWebhookDeliveries' | 'retryWebhookDelivery' | 'bulkAssets' | 'listCollections' | 'createCollection' | 'updateCollection' | 'deleteCollection' | 'listSavedSearches' | 'createSavedSearch' | 'updateSavedSearch' | 'deleteSavedSearch' | 'getAIConfig' | 'updateAIConfig' | 'getJob' | 'cancelJob' | 'listAssets' | 'getAsset' | 'startAssetTextExtraction' | 'getAssetTextExtraction' | 'retryAssetTextExtraction' | 'patchAsset' | 'getAssetAI' | 'analyzeAsset' | 'moderateAsset' | 'getTranscript' | 'transcribeAsset' | 'smartCropAsset' | 'removeAssetBackground' | 'listAssetVersions' | 'createAssetBranch' | 'restoreAssetVersion' | 'promoteAssetBranch' | 'deleteAsset' | 'replaceAsset' | 'createSignedAssetUrl' | 'createSignedTransformUrl' | 'setAssetTags' | 'patchAssetMetadata' | 'purgeAsset' | 'widgetCreateUploadSession' | 'widgetGetUploadSession' | 'widgetUploadPart' | 'widgetCompleteUploadSession' | 'widgetCancelUploadSession' | 'widgetIngestRemoteUrl' | 'listAssetSpaces' | 'listAssetCollaborators' | 'inviteAssetCollaborator' | 'updateAssetCollaborator' | 'revokeAssetCollaborator' | 'acceptAssetInvitation' | 'listAssetMetadataSchemas' | 'createAssetMetadataSchema' | 'updateAssetMetadataSchema' | 'publishAssetMetadataSchema' | 'getAssetBucketGovernance' | 'updateAssetBucketGovernance' | 'getAssetMetadataEditor' | 'listAssetPublications' | 'createAssetPublication' | 'updateAssetPublication' | 'transitionAssetPublication' | 'resolveAssetPublication' | 'listAssetPublicationRenditions' | 'previewAssetPublication' | 'migrateAssetBucketGovernance' | 'createAssetPickerCapability' | 'revokeAssetPickerCapability' | 'listAssetModels' | 'processAssetModel' | 'listAssetModelVariants' | 'createAssetModelVariant' | 'updateAssetModelVariant' | 'deleteAssetModelVariant' | 'resolveAssetPublicationAR' | 'createAssetPublicationARHandoff' | 'resolveAssetPublicationARHandoff' | 'listAssetGalleries' | 'createAssetGallery' | 'updateAssetGallery' | 'transitionAssetGallery' | 'resolveAssetGallery' | 'resolveAssetGalleryAR' | 'searchAssetPicker' | 'selectAssetPicker' | 'listAssetPortals' | 'createAssetPortal' | 'updateAssetPortal' | 'actOnAssetPortal' | 'listAssetProofs' | 'createAssetProof' | 'getAssetProof' | 'updateAssetProof' | 'decideAssetProof' | 'commentOnAssetProof' | 'inviteAssetProofGuest' | 'listAssetGuestGrants' | 'revokeAssetGuestGrant' | 'getAssetInsights' | 'setAssetInsightsTimezone' | 'listAssetPlayerProfiles' | 'createAssetPlayerProfile' | 'getAssetPlayerProfile' | 'updateAssetPlayerProfile' | 'archiveAssetPlayerProfile' | 'getAssetPlayerAssociation' | 'setAssetPlayerAssociation' | 'moveAssetFolder' | 'listAssetFolders' | 'createAssetFolder' | 'deleteAssetFolder' | 'listAssetSamples' | 'previewAssetSample' | 'copyAssetSample' | 'getAssetCapabilities' | 'listAssetModerationReviews' | 'submitAssetModerationReviews' | 'getAssetModerationReviews' | 'listAssetIntegrations' | 'createAssetIntegration' | 'deleteAssetIntegration' | 'getCurrentAssetIntegration' | 'connectCurrentAssetIntegration' | 'disconnectCurrentAssetIntegration' | 'testAssetWebhook' | 'estimateAssetGeneration' | 'listAssetGenerations' | 'retryAssetGeneration' | 'cancelAssetGeneration' | 'previewAsset' | 'previewAssetStudio' | 'saveAssetStudioOutput' | 'signAssetStudioOutput' | 'getAssetStudioOutput' | 'publishAssetTransformation';
+export type AssetOperationId = 'putAssetAICredential' | 'deleteAssetAICredential' | 'openAssetAIOutput' | 'getVideoWorkspace' | 'processVideoVersion' | 'createVideoPlaybackSession' | 'revokeVideoPlaybackSession' | 'reviewVideoVersion' | 'listVideoCaptions' | 'addVideoCaption' | 'removeVideoCaption' | 'getVideoAnalytics' | 'createPublicVideoPlaybackSession' | 'openPublicPlayerMedia' | 'renewVideoPlaybackSession' | 'recordVideoPlaybackEvents' | 'uploadAsset' | 'createUploadSession' | 'getUploadSession' | 'completeUploadSession' | 'cancelUploadSession' | 'createSignedUploadUrl' | 'createBucket' | 'listBuckets' | 'updateBucket' | 'deleteBucket' | 'configureBucketStorage' | 'startBucketRelocation' | 'createAssetConnection' | 'listAssetConnections' | 'getAssetConnection' | 'listAssetConnectionFolders' | 'updateAssetConnection' | 'verifyAssetConnection' | 'deleteAssetConnection' | 'listOwnedS2Buckets' | 'createOwnedS2Bucket' | 'startAssetMigration' | 'listAssetMigrations' | 'getAssetMigration' | 'cancelAssetMigration' | 'retryAssetMigrationItem' | 'downloadAssetMigrationReport' | 'createAssetUploadCapability' | 'getContentPolicy' | 'updateContentPolicy' | 'upsertTransformation' | 'listTransformations' | 'estimateAssetTransform' | 'materializeAssetTransform' | 'listAssetDerivatives' | 'generateAsset' | 'getAssetAutomation' | 'getAssetWorkflowCatalog' | 'listAssetWorkflows' | 'createAssetWorkflow' | 'getAssetWorkflow' | 'updateAssetWorkflowDraft' | 'validateAssetWorkflow' | 'publishAssetWorkflow' | 'activateAssetWorkflow' | 'startAssetWorkflowRun' | 'listAssetWorkflowVersions' | 'listAssetWorkflowRuns' | 'getAssetWorkflowRun' | 'cancelAssetWorkflowRun' | 'retryAssetWorkflowRun' | 'listAssetWorkflowApprovals' | 'approveAssetWorkflow' | 'rejectAssetWorkflow' | 'listAssetWorkflowConnections' | 'createAssetWorkflowConnection' | 'rotateAssetWorkflowConnectionCredential' | 'rotateAssetWorkflowInboundHook' | 'receiveAssetWorkflowInboundHook' | 'deleteTransformation' | 'createLifecycleRule' | 'listLifecycleRules' | 'deleteLifecycleRule' | 'createDomain' | 'listDomains' | 'verifyDomain' | 'deleteDomain' | 'getAnalytics' | 'getUsageSummary' | 'listEvents' | 'createWebhook' | 'listWebhooks' | 'deleteWebhook' | 'listWebhookDeliveries' | 'retryWebhookDelivery' | 'bulkAssets' | 'listCollections' | 'createCollection' | 'updateCollection' | 'deleteCollection' | 'listSavedSearches' | 'createSavedSearch' | 'updateSavedSearch' | 'deleteSavedSearch' | 'getAIConfig' | 'updateAIConfig' | 'getJob' | 'cancelJob' | 'listAssets' | 'getAsset' | 'startAssetTextExtraction' | 'getAssetTextExtraction' | 'retryAssetTextExtraction' | 'patchAsset' | 'getAssetAI' | 'analyzeAsset' | 'moderateAsset' | 'releaseAssetModeration' | 'getTranscript' | 'transcribeAsset' | 'smartCropAsset' | 'removeAssetBackground' | 'listAssetVersions' | 'createAssetBranch' | 'restoreAssetVersion' | 'promoteAssetBranch' | 'deleteAsset' | 'replaceAsset' | 'createAssetReuploadRequest' | 'listAssetReuploadRequests' | 'getAssetUsage' | 'getAssetHold' | 'createSignedAssetUrl' | 'createSignedTransformUrl' | 'setAssetTags' | 'patchAssetMetadata' | 'describeAsset' | 'purgeAsset' | 'widgetCreateUploadSession' | 'widgetGetUploadSession' | 'widgetUploadPart' | 'widgetCompleteUploadSession' | 'widgetCancelUploadSession' | 'widgetIngestRemoteUrl' | 'listAssetSpaces' | 'listAssetCollaborators' | 'inviteAssetCollaborator' | 'updateAssetCollaborator' | 'revokeAssetCollaborator' | 'acceptAssetInvitation' | 'listAssetMetadataSchemas' | 'createAssetMetadataSchema' | 'updateAssetMetadataSchema' | 'publishAssetMetadataSchema' | 'getAssetBucketGovernance' | 'updateAssetBucketGovernance' | 'getAssetMetadataEditor' | 'listAssetPublications' | 'createAssetPublication' | 'updateAssetPublication' | 'transitionAssetPublication' | 'resolveAssetPublication' | 'listAssetPublicationRenditions' | 'previewAssetPublication' | 'migrateAssetBucketGovernance' | 'createAssetPickerCapability' | 'revokeAssetPickerCapability' | 'listAssetModels' | 'processAssetModel' | 'listAssetModelVariants' | 'createAssetModelVariant' | 'updateAssetModelVariant' | 'deleteAssetModelVariant' | 'resolveAssetPublicationAR' | 'createAssetPublicationARHandoff' | 'resolveAssetPublicationARHandoff' | 'listAssetGalleries' | 'createAssetGallery' | 'updateAssetGallery' | 'transitionAssetGallery' | 'resolveAssetGallery' | 'resolveAssetGalleryAR' | 'searchAssetPicker' | 'selectAssetPicker' | 'listAssetPortals' | 'createAssetPortal' | 'updateAssetPortal' | 'actOnAssetPortal' | 'listAssetProofs' | 'createAssetProof' | 'getAssetProof' | 'updateAssetProof' | 'decideAssetProof' | 'commentOnAssetProof' | 'inviteAssetProofGuest' | 'listAssetGuestGrants' | 'revokeAssetGuestGrant' | 'getAssetInsights' | 'setAssetInsightsTimezone' | 'listAssetPlayerProfiles' | 'createAssetPlayerProfile' | 'getAssetPlayerProfile' | 'updateAssetPlayerProfile' | 'archiveAssetPlayerProfile' | 'getAssetPlayerAssociation' | 'setAssetPlayerAssociation' | 'moveAssetFolder' | 'listAssetFolders' | 'createAssetFolder' | 'deleteAssetFolder' | 'listAssetSamples' | 'previewAssetSample' | 'copyAssetSample' | 'getAssetCapabilities' | 'listAssetModerationReviews' | 'submitAssetModerationReviews' | 'getAssetModerationReviews' | 'listAssetIntegrations' | 'createAssetIntegration' | 'deleteAssetIntegration' | 'getCurrentAssetIntegration' | 'connectCurrentAssetIntegration' | 'disconnectCurrentAssetIntegration' | 'testAssetWebhook' | 'estimateAssetGeneration' | 'listAssetGenerations' | 'retryAssetGeneration' | 'cancelAssetGeneration' | 'previewAsset' | 'previewAssetStudio' | 'saveAssetStudioOutput' | 'signAssetStudioOutput' | 'getAssetStudioOutput' | 'publishAssetTransformation';
 export type AssetAPIScope = 'assets:read' | 'assets:write' | 'assets:process' | 'assets:generate' | 'assets:publish' | 'assets:admin' | 'assets:any';
 export interface AssetContractOperation {
     readonly id: AssetOperationId;
@@ -161,6 +161,11 @@ export declare const assetContractOperations: readonly [{
     readonly method: "GET";
     readonly path: "/api/v1/assets/connections/{connectionID}";
     readonly scope: "assets:read";
+}, {
+    readonly id: "listAssetConnectionFolders";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/connections/{connectionID}/folders";
+    readonly scope: "assets:read";
 }, {
     readonly id: "updateAssetConnection";
     readonly method: "PATCH";
@@ -241,6 +246,11 @@ export declare const assetContractOperations: readonly [{
     readonly method: "GET";
     readonly path: "/api/v1/assets/transformations";
     readonly scope: "assets:read";
+}, {
+    readonly id: "estimateAssetTransform";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/transforms/estimate";
+    readonly scope: "assets:process";
 }, {
     readonly id: "materializeAssetTransform";
     readonly method: "POST";
@@ -261,11 +271,6 @@ export declare const assetContractOperations: readonly [{
     readonly method: "GET";
     readonly path: "/api/v1/assets/automation";
     readonly scope: "assets:read";
-}, {
-    readonly id: "assetMCP";
-    readonly method: "POST";
-    readonly path: "/api/v1/assets/mcp";
-    readonly scope: "assets:any";
 }, {
     readonly id: "getAssetWorkflowCatalog";
     readonly method: "GET";
@@ -566,6 +571,11 @@ export declare const assetContractOperations: readonly [{
     readonly method: "POST";
     readonly path: "/api/v1/assets/{assetID}/moderation";
     readonly scope: "assets:process";
+}, {
+    readonly id: "releaseAssetModeration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/moderation/release";
+    readonly scope: "assets:write";
 }, {
     readonly id: "getTranscript";
     readonly method: "GET";
@@ -616,6 +626,26 @@ export declare const assetContractOperations: readonly [{
     readonly method: "PUT";
     readonly path: "/api/v1/assets/{assetID}/replace";
     readonly scope: "assets:write";
+}, {
+    readonly id: "createAssetReuploadRequest";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/reupload-requests";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "listAssetReuploadRequests";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/reupload-requests";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "getAssetUsage";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/usage";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "getAssetHold";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/hold";
+    readonly scope: "assets:read";
 }, {
     readonly id: "createSignedAssetUrl";
     readonly method: "POST";
@@ -636,6 +666,11 @@ export declare const assetContractOperations: readonly [{
     readonly method: "PATCH";
     readonly path: "/api/v1/assets/{assetID}/metadata";
     readonly scope: "assets:write";
+}, {
+    readonly id: "describeAsset";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/{assetID}/description";
+    readonly scope: "assets:write";
 }, {
     readonly id: "purgeAsset";
     readonly method: "POST";

package/dist/generated/assets-contract.js

@@ -30,6 +30,7 @@ export const assetContractOperations = [
     { id: 'createAssetConnection', method: 'POST', path: '/api/v1/assets/connections', scope: 'assets:admin' },
     { id: 'listAssetConnections', method: 'GET', path: '/api/v1/assets/connections', scope: 'assets:read' },
     { id: 'getAssetConnection', method: 'GET', path: '/api/v1/assets/connections/{connectionID}', scope: 'assets:read' },
+    { id: 'listAssetConnectionFolders', method: 'GET', path: '/api/v1/assets/connections/{connectionID}/folders', scope: 'assets:read' },
     { id: 'updateAssetConnection', method: 'PATCH', path: '/api/v1/assets/connections/{connectionID}', scope: 'assets:admin' },
     { id: 'verifyAssetConnection', method: 'POST', path: '/api/v1/assets/connections/{connectionID}/verify', scope: 'assets:admin' },
     { id: 'deleteAssetConnection', method: 'DELETE', path: '/api/v1/assets/connections/{connectionID}', scope: 'assets:admin' },
@@ -46,11 +47,11 @@ export const assetContractOperations = [
     { id: 'updateContentPolicy', method: 'PUT', path: '/api/v1/assets/policy', scope: 'assets:admin' },
     { id: 'upsertTransformation', method: 'POST', path: '/api/v1/assets/transformations', scope: 'assets:process' },
     { id: 'listTransformations', method: 'GET', path: '/api/v1/assets/transformations', scope: 'assets:read' },
+    { id: 'estimateAssetTransform', method: 'POST', path: '/api/v1/assets/{assetID}/transforms/estimate', scope: 'assets:process' },
     { id: 'materializeAssetTransform', method: 'POST', path: '/api/v1/assets/{assetID}/transforms', scope: 'assets:process' },
     { id: 'listAssetDerivatives', method: 'GET', path: '/api/v1/assets/{assetID}/derivatives', scope: 'assets:read' },
     { id: 'generateAsset', method: 'POST', path: '/api/v1/assets/generations', scope: 'assets:generate' },
     { id: 'getAssetAutomation', method: 'GET', path: '/api/v1/assets/automation', scope: 'assets:read' },
-    { id: 'assetMCP', method: 'POST', path: '/api/v1/assets/mcp', scope: 'assets:any' },
     { id: 'getAssetWorkflowCatalog', method: 'GET', path: '/api/v1/assets/workflows/catalog', scope: 'assets:read' },
     { id: 'listAssetWorkflows', method: 'GET', path: '/api/v1/assets/workflows', scope: 'assets:read' },
     { id: 'createAssetWorkflow', method: 'POST', path: '/api/v1/assets/workflows', scope: 'assets:write' },
@@ -111,6 +112,7 @@ export const assetContractOperations = [
     { id: 'getAssetAI', method: 'GET', path: '/api/v1/assets/{assetID}/ai', scope: 'assets:read' },
     { id: 'analyzeAsset', method: 'POST', path: '/api/v1/assets/{assetID}/ai/analyze', scope: 'assets:process' },
     { id: 'moderateAsset', method: 'POST', path: '/api/v1/assets/{assetID}/moderation', scope: 'assets:process' },
+    { id: 'releaseAssetModeration', method: 'POST', path: '/api/v1/assets/{assetID}/moderation/release', scope: 'assets:write' },
     { id: 'getTranscript', method: 'GET', path: '/api/v1/assets/{assetID}/transcript', scope: 'assets:read' },
     { id: 'transcribeAsset', method: 'POST', path: '/api/v1/assets/{assetID}/transcript', scope: 'assets:process' },
     { id: 'smartCropAsset', method: 'POST', path: '/api/v1/assets/{assetID}/smart-crop', scope: 'assets:process' },
@@ -121,10 +123,15 @@ export const assetContractOperations = [
     { id: 'promoteAssetBranch', method: 'POST', path: '/api/v1/assets/{assetID}/branches/{branch}/promote', scope: 'assets:write' },
     { id: 'deleteAsset', method: 'DELETE', path: '/api/v1/assets/{assetID}', scope: 'assets:admin' },
     { id: 'replaceAsset', method: 'PUT', path: '/api/v1/assets/{assetID}/replace', scope: 'assets:write' },
+    { id: 'createAssetReuploadRequest', method: 'POST', path: '/api/v1/assets/{assetID}/reupload-requests', scope: 'assets:write' },
+    { id: 'listAssetReuploadRequests', method: 'GET', path: '/api/v1/assets/{assetID}/reupload-requests', scope: 'assets:read' },
+    { id: 'getAssetUsage', method: 'GET', path: '/api/v1/assets/{assetID}/usage', scope: 'assets:read' },
+    { id: 'getAssetHold', method: 'GET', path: '/api/v1/assets/{assetID}/hold', scope: 'assets:read' },
     { id: 'createSignedAssetUrl', method: 'POST', path: '/api/v1/assets/{assetID}/signed-url', scope: 'assets:read' },
     { id: 'createSignedTransformUrl', method: 'POST', path: '/api/v1/assets/{assetID}/transform-url', scope: 'assets:process' },
     { id: 'setAssetTags', method: 'PUT', path: '/api/v1/assets/{assetID}/tags', scope: 'assets:write' },
     { id: 'patchAssetMetadata', method: 'PATCH', path: '/api/v1/assets/{assetID}/metadata', scope: 'assets:write' },
+    { id: 'describeAsset', method: 'PUT', path: '/api/v1/assets/{assetID}/description', scope: 'assets:write' },
     { id: 'purgeAsset', method: 'POST', path: '/api/v1/assets/{assetID}/purge', scope: 'assets:admin' },
     { id: 'widgetCreateUploadSession', method: 'POST', path: '/assets/widget/sessions', scope: 'assets:write' },
     { id: 'widgetGetUploadSession', method: 'GET', path: '/assets/widget/sessions/current', scope: 'assets:write' },

package/dist/index.d.ts

@@ -6,6 +6,10 @@ export type * from './asset-media-v2.js';
 export { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 export type * from './assets-platform-types.js';
 export { ChunkedUploadController, UploadResumeInvalidError, putBlob, sha256Blob } from './upload-controller.js';
+export { S2UploadsClient } from './s2.js';
+export type { S2Object } from './s2.js';
+export { S2Uploader, createS2ResumeStore } from './s2-upload.js';
+export type { S2UploadBackend } from './s2-upload.js';
 export type { ChunkUploadCallbacks, ChunkUploadRequest, ChunkUploadSession, ChunkUploadTransport, ChunkedUploadOptions, UploadProgress, UploadResumeRecord, UploadResumeStore, UploadedPart } from './upload-controller.js';
 export { createResponsiveImage, namedResponsiveSource, uploadBrowserFile } from './assets-framework.js';
 export type { ArtDirectionSource, ResponsiveImageDescriptor, ResponsiveImageOptions } from './assets-framework.js';
@@ -15,18 +19,20 @@ export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, Mai
 export type { MailAudience, MailAudienceMember, MailAudienceMemberImport, MailCampaign } from './mail-campaigns.js';
 export { MailExportsClient } from './mail-exports.js';
 export type { MailExport, MailExportCreateInput } from './mail-exports.js';
+export { MailboxAliasesClient, MailboxDomainsClient, MailboxGroupsClient, MailboxImportsClient, MailboxRoutesClient, MailboxesClient } from './mail-mailboxes.js';
+export type * from './mail-mailboxes.js';
 export type { MailDiagnosticFinding, MailTemplateDiagnosticInput, MailTemplateDiagnosticResult } from './mail-diagnostics.js';
 export { ProjectsClient } from './projects.js';
 export { WorkloadSecurityClient } from './workload-security.js';
 export type * from './workload-security.js';
-export type { Asset, AssetAIAnnotation, AssetAIInfo, AssetCollection, AssetListOptions, AssetListResult, AssetModerationResult, AssetSavedSearch, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTranscript, AssetTransformOptions, AssetTransformPreset, AssetTransformPresetCategory, AssetUploadOptions, AssetVisibility, AssetVersion, JsonValue, MailAddress, MailAddressInput, MailDnsRecord, MailDomain, MailDomainListResult, MailDomainStatus, MailIdempotencyStatus, MailLog, MailMessage, MailMessageListOptions, MailMessageListResult, MailMessageSummary, MailRecordStatus, MailSendAttempt, MailSendInput, MailSendResponse, MailStatus, MailRecipient, MailRecipientStatus, MailRecipientSummary, Project, ProjectListOptions, StackShiftOptions, } from './types.js';
+export type { Asset, AssetAIAnnotation, AssetAIInfo, AssetManualDescriptionInput, AssetCollection, AssetListOptions, AssetListResult, AssetModerationResult, AssetSavedSearch, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTranscript, AssetTransformOptions, AssetTransformPreset, AssetTransformPresetCategory, AssetUploadOptions, AssetVisibility, AssetVersion, JsonValue, MailAddress, MailAddressInput, MailDnsRecord, MailDomain, MailDomainListResult, MailDomainStatus, MailIdempotencyStatus, MailLog, MailMessage, MailMessageListOptions, MailMessageListResult, MailMessageSummary, MailRecordStatus, MailSendAttempt, MailSendInput, MailSendResponse, MailStatus, MailRecipient, MailRecipientStatus, MailRecipientSummary, Project, ProjectListOptions, StackShiftOptions, } from './types.js';
 export type { MailBounce, MailBounceListOptions, MailBounceListResult, MailBounceType, MailSuppression, MailSuppressionCreateInput, MailSuppressionListOptions, MailSuppressionListResult, MailSuppressionReason, MailSuppressionSource, } from './mail-delivery-types.js';
 export type { MailOtpChallenge, MailOtpChallengeListOptions, MailOtpChallengeListResult, MailOtpSendInput, MailOtpSendResponse, MailOtpStatus, MailOtpVerifyInput, MailOtpVerifyResponse, } from './mail-otp-types.js';
 export type { MailSendTemplateInput, MailSendTemplateResponse, MailTemplate, MailTemplateCreateInput, MailTemplateDetail, MailTemplateListOptions, MailTemplateListResult, MailTemplatePreview, MailTemplatePreviewInput, MailTemplateStatus, MailTemplateTestSendInput, MailTemplateTestSendResponse, MailTemplateUpdateInput, MailTemplateVersion, } from './mail-template-types.js';
 export type { MailEvent, MailEventListOptions, MailEventListResult, MailEventType, MailTimelineItem, MailWebhook, MailWebhookCreateInput, MailWebhookCreateResponse, MailWebhookDelivery, MailWebhookDeliveryAttempt, MailWebhookDeliveryDetail, MailWebhookDeliveryListOptions, MailWebhookListOptions, MailWebhookListResult, MailWebhookUpdateInput, MailWebhookReplay, MailWebhookReplayInput, } from './mail-webhook-types.js';
 export type { MailMessageStream, MailMessageStreamCreateInput, MailMessageStreamListResult } from './mail-streams.js';
 export type { MailDomainReputation, MailLimits, MailManualReviewStatus, MailReputation, MailReputationEvent, MailReputationEventListOptions, MailReputationEventListResult, MailReputationEventSeverity, MailReputationStatus, MailReputationTier, MailReputationWorkspace, } from './mail-reputation-types.js';
-export type { MailAnalytics, MailAnalyticsInput, MailAttachmentInput, MailBatch, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';
+export type { MailAnalytics, MailAnalyticsRateCohort, MailAnalyticsInput, MailAttachmentInput, MailBatch, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';
 export { AssetVideoClient } from './assets-video.js';
 export type * from './assets-video-types.js';
 export * from './mail-tracking.js';
@@ -41,3 +47,8 @@ export * from './mail-migration.js';
 export * from './mail-marketing.js';
 export { AICreditsClient } from './ai-credits.js';
 export type * from './ai-credits.js';
+export * from './support-action-types.js';
+export * from './support-actions.js';
+export * from './support-action-receiver.js';
+export * from './support-action-sqlite.js';
+export * from './support-action-manifest.js';

package/dist/index.js

@@ -3,10 +3,13 @@ export { AssetsClient, assetTransformOptions, assetTransformPresets, assetTransf
 export { AssetWorkflowsClient } from './asset-workflows.js';
 export { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 export { ChunkedUploadController, UploadResumeInvalidError, putBlob, sha256Blob } from './upload-controller.js';
+export { S2UploadsClient } from './s2.js';
+export { S2Uploader, createS2ResumeStore } from './s2-upload.js';
 export { createResponsiveImage, namedResponsiveSource, uploadBrowserFile } from './assets-framework.js';
 export { assetContractOperations } from './generated/assets-contract.js';
 export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, MailLimitsClient, MailMessagesClient, MailScheduledClient, MailBatchClient, MailInboundClient, MailAnalyticsClient, MailOtpChallengesClient, MailOtpClient, MailReputationClient, MailReputationEventsClient, MailSuppressionsClient, MailTemplatesClient, MailWebhooksClient, MailStreamsClient, MailAudiencesClient, MailCampaignsClient, } from './mail.js';
 export { MailExportsClient } from './mail-exports.js';
+export { MailboxAliasesClient, MailboxDomainsClient, MailboxGroupsClient, MailboxImportsClient, MailboxRoutesClient, MailboxesClient } from './mail-mailboxes.js';
 export { ProjectsClient } from './projects.js';
 export { WorkloadSecurityClient } from './workload-security.js';
 export { AssetVideoClient } from './assets-video.js';
@@ -17,3 +20,8 @@ export * from './mail-billing.js';
 export * from './mail-migration.js';
 export * from './mail-marketing.js';
 export { AICreditsClient } from './ai-credits.js';
+export * from './support-action-types.js';
+export * from './support-actions.js';
+export * from './support-action-receiver.js';
+export * from './support-action-sqlite.js';
+export * from './support-action-manifest.js';

package/dist/mail-advanced-types.d.ts

@@ -107,7 +107,18 @@ export interface MailAnalyticsInput {
     template?: string;
     event?: string;
 }
+export interface MailAnalyticsRateCohort {
+    basis: 'recipient_created_at';
+    asOf: string;
+    queued: number;
+    mtaAccepted: number;
+    delivered: number;
+    bounced: number;
+    failed: number;
+}
 export interface MailAnalytics {
+    rateCohort?: MailAnalyticsRateCohort;
+    previousRateCohort?: MailAnalyticsRateCohort;
     summary: Record<string, number>;
     series: Array<Record<string, number | string>>;
 }

package/dist/mail-billing.d.ts

@@ -1,6 +1,10 @@
 import type { StackShift } from './client.js';
 import type { MailMode } from './mail-simulation.js';
 export interface MailBillingSummary {
+    catalogId?: string;
+    planSlug?: string;
+    monthlyPriceKobo?: number;
+    overageAllowed?: boolean;
     reconciliationRequired: boolean;
     active: boolean;
     mode: MailMode;

package/dist/mail-campaigns.d.ts

@@ -50,7 +50,7 @@ export interface MailCampaignContent {
 }
 export interface MailCampaignInput {
     simulation?: MailSimulationOptions;
-    name: string;
+    name?: string;
     audienceId: string;
     segmentId?: string;
     from?: string;